Python iCalendar RRule夏令时时段失效：原因与修复方案问询

在2022年11月7日（纽约夏令时周日）23:53（对应UTC 04:53）时，以下iCalendar事件通过Python代码处理时返回异常结果，该时段之外（含前后日期及其他时段）均正常运行。

对应的iCalendar内容 #

BEGIN:VEVENT
DTSTART;TZID=America/New_York:20211019T000000
DTEND;TZID=America/New_York:20211019T235959
RRULE:FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA
X-STATE:con
END:VEVENT

处理代码 #

from dateutil import rrule
from dateutil.tz import gettz
from icalendar.cal import Calendar
from datetime import datetime, timedelta, timezone

cal_str = "BEGIN:VEVENT\nDTSTART;TZID=America/New_York:20211019T000000\nDTEND;TZID=America/New_York:20211019T235959\nRRULE:FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA\nX-STATE:convenience\nEND:VEVENT"

def test_ical(target_time):
    ical = Calendar.from_ical(cal_str)
    start_time_dt = ical.get("DTSTART").dt
    tzinfo = gettz(str(start_time_dt.tzinfo))
    start_time_dt = start_time_dt.replace(tzinfo=None).replace(tzinfo=tzinfo)
    end_time_dt = ical["DTEND"].dt if ical.get("DTEND") else None

    irrule = ical.get("RRULE")
    recurring_rule = irrule.to_ical().decode('utf-8')
    rules = rrule.rruleset()
    first_rule = rrule.rrulestr(recurring_rule, dtstart=start_time_dt)
    rules.rrule(first_rule)
    event_delta = end_time_dt - start_time_dt if end_time_dt else timedelta(days=1)

    return 1 if rules.between(target_time - event_delta, target_time + timedelta(minutes=1)) else 0

res = {}
for i in range(3,6):
    res[i] = {}
    for j in range(6,9):
        res[i][j] = test_ical(datetime(2022, 11, j, i, 53, tzinfo=timezone.utc))

print(res)

代码输出 #

{
 3: {6: 1, 7: 1, 8: 1}, 
 4: {6: 1, 7: 0, 8: 1}, 
 5: {6: 1, 7: 1, 8: 1}
}

1. 失效原因 #

问题根源是纽约时区夏令时切换导致的事件时长异常：

• 2022年11月6日纽约时间凌晨2点，夏令时结束，时钟回拨1小时进入冬令时，这一天的实际时长为25小时。
• 原始iCalendar事件用DATE-TIME类型定义为纽约时间00:00到23:59，平时对应UTC的23小时59分跨度，但在夏令时切换当天（纽约11月6日），该事件的UTC跨度变为24小时59分（纽约00:00对应UTC 04:00，23:59对应UTC次日04:59）。
• 代码中event_delta是固定从原始事件获取的23小时59分59秒，用这个固定值计算目标时间的区间时，会导致该时段的事件起始时间不在计算出的区间内，最终代码返回错误的0。

简单来说：目标时间UTC 11月7日04:53属于纽约11月6日的事件区间，但代码计算的区间[UTC 11月6日05:53:01, UTC 11月7日04:54]不包含该事件的起始时间（UTC 11月6日04:00），因此返回0。

2. 修改iCalendar内容的解决方案 #

推荐两种简单可靠的修改方式：

方案一：使用全天事件的DATE类型（最优） #

iCalendar规范中，全天事件应使用DATE类型而非DATE-TIME，完全规避时区夏令时问题：

BEGIN:VEVENT
DTSTART;VALUE=DATE:20211019
DTEND;VALUE=DATE:20211020
RRULE:FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA
X-STATE:con
END:VEVENT

说明：

• DTEND设为次日是因为iCalendar中DTEND是排他时间，代表事件到20211019结束。
• 这种方式生成的是每个自然日的全天事件，不受时区转换影响，代码处理时不会出现时长计算错误。

方案二：切换到UTC时区定义事件 #

如果必须使用DATE-TIME类型，可将事件切换到UTC时区，确保每个事件的UTC时长固定：

BEGIN:VEVENT
DTSTART;TZID=UTC:20211019T040000
DTEND;TZID=UTC:20211019T035959
RRULE:FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA
X-STATE:con
END:VEVENT

说明：

• 原始纽约时间00:00对应UTC 04:00，结束时间纽约23:59对应UTC次日03:59。
• 每个事件的UTC时长固定为23小时59分，夏令时切换时不会出现时长变化，代码的event_delta计算始终有效。

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