PHP生成.ics文件导入日历异常：Apple时差1小时/Google无时间

问题情况 #

用PHP生成的.ics文件能正常导入苹果日历和谷歌日历，但出现两个异常：

• 苹果日历里事件显示11:30，比预期的10:30提前1小时
• 谷歌日历中事件没有时间信息显示

示例事件代码：

BEGIN:VEVENT
UID:1952849664
DTSTAMP:20230426T084708Z
DTSTART;VALUE=DATE:20230606T103000
DTEND;VALUE=DATE:20230606T103000
SUMMARY:Test Event
DESCRIPTION:Test event 
multi line description test
multi line description test
END:VEVENT

错误原因及修改方法 #

1. VALUE=DATE参数误用 #

VALUE=DATE是用来标记全天事件的，要求时间格式只能是纯日期（比如20230606），不能带时分秒。你给DTSTART和DTEND加了T103000，格式不符合规范，导致谷歌日历无法识别时间，苹果日历解析出错。

2. 时间时区未明确 #

苹果日历会自动根据本地时区转换时间，如果你的时间是本地时间但没标注时区，会被默认当作UTC时间处理，进而出现1小时的偏差（通常和夏令时或时区差有关）。

正确代码示例 #

方案一：使用UTC时间（带Z后缀）

BEGIN:VEVENT
UID:1952849664
DTSTAMP:20230426T084708Z
DTSTART:20230606T103000Z
DTEND:20230606T113000Z
SUMMARY:Test Event
DESCRIPTION:Test event \nmulti line description test\nmulti line description test
END:VEVENT

方案二：指定本地时区（以上海时区为例）

BEGIN:VEVENT
UID:1952849664
DTSTAMP:20230426T084708Z
DTSTART;TZID=Asia/Shanghai:20230606T103000
DTEND;TZID=Asia/Shanghai:20230606T113000
SUMMARY:Test Event
DESCRIPTION:Test event \nmulti line description test\nmulti line description test
END:VEVENT

额外注意事项 #

• DTEND时间不能和DTSTART完全一致，否则部分日历会判定为无效事件
• 多行描述要使用\n转义换行，不能直接换行（符合.ics规范的格式要求）

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