跨时区零时间日期精准比对：Xero API下薪资日历与时间表校验问题

嘿，这个场景我做Xero集成的时候碰到过！核心坑点就是时区统一，别直接拿字符串硬比，不然很容易因为时区差或者夏令时踩坑。我给你捋捋具体的解决思路：

第一步：明确两个时间的时区 #

你已经知道薪资日历的时间是Australia/Sydney时区的，那首先得确认员工时间表的时间返回时区：

• 如果时间表也是Australia/Sydney时区，那直接处理日期就行；
• 如果是UTC或者其他时区，必须先把时间表的时间转换到Australia/Sydney时区，再做比较。

第二步：用DateTime对象做安全的日期比较 #

别直接取date属性的字符串切片（比如substr($date, 0, 10)），要用PHP DateTime的内置方法来处理，它会自动帮你处理时区和夏令时的问题。举个实际代码例子：

示例1：统一时区后比较日期字符串 #

// 从Xero API拿到的薪资日历开始时间（已经是Australia/Sydney时区）
$payCalStart = new DateTime('2018-05-01 00:00:00', new DateTimeZone('Australia/Sydney'));

// 假设员工时间表的时间是UTC时区的，先转成Sydney时区
$timesheetTime = new DateTime('2018-04-30 14:00:00', new DateTimeZone('UTC'));
$timesheetTime->setTimezone(new DateTimeZone('Australia/Sydney'));

// 提取日期部分进行比较
if ($payCalStart->format('Y-m-d') === $timesheetTime->format('Y-m-d')) {
    echo "两项业务发生在同一天！";
} else {
    echo "不是同一天";
}

示例2：用diff方法判断天数差 #

如果你想更严谨，可以用diff方法计算两个时间的间隔，判断天数差为0：

$interval = $payCalStart->diff($timesheetTime);
// days为0表示日期相同，invert为0确保前者不晚于后者（避免跨天的时间差误判）
if ($interval->days === 0 && $interval->invert === 0) {
    echo "同一天";
}

避坑提醒 #

• 强制指定时区：如果时间表的时间没有带时区信息，PHP会用服务器默认时区，要是服务器不在悉尼，直接比肯定错，所以一定要手动指定时间表的原始时区。
• 别碰夏令时的手动计算：Australia/Sydney有夏令时切换，Xero返回的DateTime已经处理了这个，用PHP的DateTime对象会自动适配，不用自己加减小时。
• 不要硬编码日期格式：用format('Y-m-d')而不是自己截取字符串，避免因为时间格式变化（比如Xero返回的小数秒）出问题。

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