UIDatePicker（.compact样式）弹窗初始显示错误月份问题求助

问题分析 #

你遇到的这个bug根源在于UIDatePicker的Compact样式默认会使用设备本地时区的日历来计算弹窗初始显示的月份——哪怕你已经手动设置了picker的timeZone为UTC。当UTC日期和本地日期跨天（甚至跨月）时，这种时区不匹配会导致picker错误地加载前一个月的日历，直到你手动切换月份后，才会正确选中目标日期。

比如你在UTC+8时区，UTC时间是2023-01-11 17:30:00，此时本地时间已经是2023-01-12 01:30:00，picker基于本地日历解析UTC日期时出现逻辑偏差，就会导致初始弹窗错误显示December 2022。

解决方案 #

除了设置timeZone，你需要为UIDatePicker指定一个UTC时区的日历对象，确保picker的所有日期处理逻辑都统一基于UTC：

// 创建UTC时区的公历日历
let utcCalendar = Calendar(identifier: .gregorian)
utcCalendar.timeZone = TimeZone(identifier: "UTC")!

// 配置DatePicker
cell.datePicker.subviews[0].backgroundColor = nil
cell.datePicker.backgroundColor = .secondarySystemGroupedBackground
cell.datePicker.calendar = utcCalendar // 关键：设置UTC日历
cell.datePicker.timeZone = TimeZone(identifier: "UTC")!
cell.datePicker.date = flight.date
cell.datePicker.addTarget(self, action: #selector(handleDatePicker(sender:)), for: .valueChanged)

为什么这样有效？ #

UIDatePicker的日期范围计算、月份展示逻辑都依赖于其calendar属性，默认的calendar是设备本地的（绑定本地时区）。哪怕你单独设置了timeZone，picker仍会用本地日历的时区来解析日期、计算要显示的月份范围。

通过将calendar的时区也设置为UTC，picker的所有日期处理逻辑都会统一对齐UTC时区，彻底避免了时区差异带来的初始月份显示错误。设置完成后，点击显示Jan 11, 2023的文本框，弹窗会直接显示Jan 2023月份并正确预选Jan 11。

内容的提问来源于stack exchange，提问作者benck