如何在XCode Simulator中设置指定日期用于日出日落计算测试

关于时区环境变量能否设置日期 #

不行。构建方案里设置的TZ这类时区环境变量仅用于修改模拟器的时区偏移，不会改变系统的日期和时间，所以没法用这个方式来模拟特定日期。

可行的模拟特定日期方法 #

• 直接修改模拟器系统日期
  这是最直观的方式：打开Xcode Simulator，点击顶部菜单栏的Hardware -> Date & Time，取消勾选Set Automatically，然后手动输入你需要测试的日期和时间即可。修改后模拟器内的所有依赖系统日期的功能都会使用这个自定义时间，适合快速验证日出日落计算逻辑。

• 通过Scheme注入自定义日期（代码层面兼容）
  如果你需要在代码中可控地模拟日期（比如方便切换不同测试场景），可以在Xcode Scheme中添加自定义环境变量，然后在代码中读取并替换系统日期：

  1. 打开Xcode的Scheme设置（Product -> Scheme -> Edit Scheme）
  2. 切换到Run标签页，选择Arguments栏
  3. 在Environment Variables里添加一个变量，比如SIMULATED_DATE，值填ISO格式的日期字符串（例如2024-12-25T08:00:00）
  4. 在你的日期计算代码中，优先读取这个环境变量：

     func getCurrentDate() -> Date {
         guard let dateStr = ProcessInfo.processInfo.environment["SIMULATED_DATE"],
               let simulatedDate = ISO8601DateFormatter().date(from: dateStr) else {
             return Date()
         }
         return simulatedDate
     }
     

  之后你的日出日落计算逻辑调用getCurrentDate()就能使用模拟日期了，不需要修改系统设置。

• 自动化测试中Mock日期（依赖注入）
  如果你在写XCTest自动化测试，推荐用依赖注入的方式隔离系统日期：

  1. 给你的日出日落计算类添加一个日期提供者的初始化参数：

     class SunriseSunriseCalculator {
         private let dateProvider: () -> Date
         
         // 默认使用系统日期，测试时可以传入自定义日期
         init(dateProvider: @escaping () -> Date = Date.init) {
             self.dateProvider = dateProvider
         }
         
         func computeSunset() -> Date? {
             let currentDate = dateProvider()
             // 你的日落计算逻辑
             return calculatedSunsetDate
         }
     }
     

  2. 在测试用例中，传入固定的测试日期：

     func testSummerSunset() {
         let testDate = ISO8601DateFormatter().date(from: "2024-06-21T12:00:00")!
         let calculator = SunriseSunriseCalculator(dateProvider: { testDate })
         let sunset = calculator.computeSunset()
         // 断言验证结果
     }
     

  这种方式能让测试更稳定，不受系统时间变化影响。

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