Flutter中解决(scheduledDate): Must be a future date(TZDateTime)错误

问题根源 #

• 动态传递的alarmTime如果早于当前时间，time.difference(DateTime.now())会返回负的Duration，加到当前TZDateTime上会生成过去的时间，违反zonedSchedule要求的「必须是未来时间」规则。
• 普通DateTime与TZDateTime混合计算时，容易出现时区偏差，导致时间判断错误。

具体修复步骤 #

1. 优化时区初始化 #

把时区初始化移到App启动时执行，避免每次调用通知方法重复初始化：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  tz.initializeTimeZones();
  // 其他App初始化逻辑
}

2. 修正setNotification方法 #

确保生成的调度时间一定是未来时间，并且正确转换为TZDateTime：

setNotification({
  required DateTime time,
  required int id,
  required bool isAdhan,
  required String salat,
  required String adhan,
}) async {
  final tz.TZDateTime now = tz.TZDateTime.now(tz.local);
  // 将传入的本地DateTime转换为对应时区的TZDateTime
  tz.TZDateTime scheduledDate = tz.TZDateTime.from(time, tz.local);

  // 若调度时间早于当前时间，自动调整到下一天的同一时间
  if (scheduledDate.isBefore(now)) {
    scheduledDate = scheduledDate.add(const Duration(days: 1));
  }

  await flutterLocalNotificationsPlugin.zonedSchedule(
    id,
    "$salat Prayer Time",
    "It's time for $salat Prayer, Pray at the time",
    scheduledDate,
    NotificationDetails(
      android: AndroidNotificationDetails(
        DateTime.now().millisecondsSinceEpoch.toString(),
        "channelName",
        channelDescription: "Adhan For Prayer",
        playSound: isAdhan,
        importance: Importance.max,
        priority: Priority.high,
        fullScreenIntent: true,
        sound: RawResourceAndroidNotificationSound(adhan),
      ),
    ),
    uiLocalNotificationDateInterpretation:
        UILocalNotificationDateInterpretation.absoluteTime,
    androidAllowWhileIdle: true,
    payload: "Prayer",
  );
}

3. 初始化调度时的时间处理 #

确保循环中生成的闹钟时间与目标日期正确绑定，避免空值异常：

for (var i = 0; i < 7; i++) {
  DateTime targetDate = DateTime.now().add(Duration(days: i));
  // 合并目标日期与alarmTime的时分秒
  if (alarmTime != null) {
    DateTime scheduledTime = DateTime(
      targetDate.year,
      targetDate.month,
      targetDate.day,
      alarmTime.hour,
      alarmTime.minute,
      alarmTime.second,
    );
    schedule.add(Reminder(
      id: 1 + 6 * i,
      time: scheduledTime,
    ));
  }
  // 其他业务逻辑...
}

关键注意点 #

• 如果需要每日重复闹钟，可在zonedSchedule中添加matchDateTimeComponents: DateTimeComponents.time参数，无需手动循环7天。
• 确保传入的time是本地时间，若为UTC时间需先转换为本地时间再转TZDateTime。

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