UIDatePicker 是 iOS 內建的日期選擇控制項,取值本身很簡單,真正容易出錯的是格式化字串的撰寫——尤其是 dd 與 DD 只差一個字母,意義卻完全不同。
- (IBAction)onclick:(id)sender {
NSDate *theDate = self.dataPicker.date;
// descriptionWithLocale 會以當地格式回傳時間
// currentLocale 取得目前使用者的地區資訊
NSLog(@"the date picked is: %@", [theDate descriptionWithLocale:[NSLocale currentLocale]]);
// 設定格式化樣式
NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];
[dateFormatter setDateFormat:@"YYYY-MM-dd HH:mm:ss"];
NSLog(@"the date formatted is: %@", [dateFormatter stringFromDate:theDate]);
self.label.text = [dateFormatter stringFromDate:theDate];
}
小寫 dd:月份中的「日」,也就是當月第幾天,範圍 01–31。
大寫 DD:當年的「第幾天」(day of year),範圍 001–366。
所以 1 月 1 日會被格式化為 01-01(dd)與 01-001(DD)。若把 MM-dd 誤寫成 MM-DD,跨月時就會出現「12 月 32 日」這種荒謬結果。
YYYY 與 yyyy:這是最兇的一組。yyyy 是日曆年(calendar year),YYYY 是週based year(week-based year)。在 12 月底的某些日期,兩者會差一年。例如 2015 年 12 月 29 日,yyyy 得到 2015,YYYY 卻得到 2016(因為 ISO 週已跨到隔年)。請一律使用小寫 yyyy。
mm 與 MM:小寫 mm 是「分鐘」,大寫 MM 是「月份」。寫成 yyyy-mm-dd 會得到「分鐘」而非月份,是初學者最常犯的錯。
hh 與 HH:小寫 hh 是 12 小時制(01–12),大寫 HH 是 24 小時制(00–23)。下午 3 點用 hh 會顯示 03,需搭配 a 符號或改用 HH。
SSS:毫秒,需寫三個 S;SS 會被當成刻畫(frame)而非毫秒。
1. 永遠明確指定 locale。不設定 locale 時, formatter 會採用系統地區設定。在某些地區(例如伊斯蘭曆地區),系統預設使用伊斯蘭曆,同一個 NSDate 格式化出來會是回曆年份。若你要的是西元,請明確指定:
dateFormatter.locale = [NSLocale localeWithLocaleIdentifier:@"en_US_POSIX"];
Apple 官方明確建議:所有「機器對機器」的日期格式化(例如產生 API 參數、寫入檔案)都應固定使用 en_US_POSIX,才能確保跨裝置行為一致。
2. 明確指定 timeZone。預設使用系統時區,使用者出國或修改設定後結果會不同。若要固定,請設定 dateFormatter.timeZone = [NSTimeZone timeZoneWithAbbreviation:@"UTC"];。
3. NSDateFormatter 建立成本不低,請快取 reuse。每次迴圈都建立新的 formatter 會明顯拖慢效能。實務上會把它做成靜態或單例屬性重複使用。
4. 若要顯示給使用者看,用 dateStyle / timeStyle 而非自訂格式。不同地區的日期順序與文字不同(例如中文的「2026 年 8 月 27 日」與英文的 "Aug 27, 2026")。直接指定 dateFormatter.dateStyle = NSDateFormatterLongStyle; 讓系統依地區自動調整,才是正確的國際化做法。
5. 新版 API:ISO8601DateFormatter 與 DateFormatter (Swift)。若只需要處理 API 傳輸格式,NSISO8601DateFormatter 比手寫 yyyy-MM-dd'T'HH:mm:ssZ 更可靠,也不會遇到上述大小寫陷阱。Swift 中則建議用 DateFormatter 並搭配 Date.FormatStyle 這類型別安全的 API。
UIDatePicker 本身還有幾個常用設定值得一記:datePickerMode 可設為 Time、Date、DateAndTime、CountDownTimer;minimumDate 與 maximumDate 可限制可選範圍(例如報名表單限制不可選過去日期);minuteInterval 可限制分鐘間隔,避免使用者選到不合理的值。