rrule.between方法inc=True时日期未按预期包含的问题

核心原因 #

你的问题本质是对rrule.between()逻辑和RRULE规则匹配逻辑的理解偏差，具体如下：

1. RRULE仅生成周四的重复实例：规则里BYDAY=TH指定重复周期为每周四，只有周四的对应时间点才会进入结果序列。你示例中的start是2023-06-28（周三），不属于规则定义的重复日期，自然不会出现在结果里——这是符合规则的正常行为，并非方法bug。
2. 结束时间的匹配差异：
   • RRULE的UNTIL=20231214T170000Z是重复序列的截止阈值，所有早于等于该时间的周四实例都会被生成。
   • 你示例中的last是2023-12-14 15:04:16+00:00，当天是周四，对应的实例时间（与DTSTART一致）恰好等于last，加上inc=True参数（包含边界），所以会被纳入结果。
   • 若出现“包含起始日期却排除结束日期”的情况，大概率是：起始日期恰好是周四（属于重复序列），但结束日期的时间早于当天的实例时间（比如last是2023-12-14 14:00:00Z，而实例时间是15:04:16Z），此时实例时间晚于last，自然被排除。

验证与修正步骤 #

• 确认rrule的DTSTART值：执行print(rrule.orig_dtstart)查看初始起始时间，这个时间决定了后续重复实例的具体时刻（比如DTSTART是2023-06-29T15:04:16Z，所有实例都是每周四的15:04:16Z）。
• 对齐时间边界：如果需要包含特定起始/结束日期，确保该日期是周四，且时间不晚于last、不早于start。
• 统一时区处理：确保所有时间参数（start、last、rrule）都使用UTC时区，避免时区转换导致的时间错位——你用astimezone(pytz.utc)处理的方式是正确的。

示例验证代码 #

from dateutil import rrule
import pytz
from datetime import datetime

# 构造RRULE字符串
rrule_str = "RRULE:FREQ=WEEKLY;UNTIL=20231214T170000Z;INTERVAL=1;BYDAY=TH;WKST=SU"
# 指定DTSTART（必须与原事件起始时间一致，否则实例时间会偏离）
dtstart = datetime(2023, 6, 29, 15, 4, 16, tzinfo=pytz.utc)
rr = rrule.rrulestr(rrule_str, dtstart=dtstart)

# 定义查询时间范围
start = datetime(2023, 6, 28, 15, 4, 16, tzinfo=pytz.utc)
last = datetime(2023, 12, 14, 15, 4, 16, tzinfo=pytz.utc)

# 获取实例列表
mlist = list(rr.between(start, last, inc=True))
# 结果包含2023-06-29及之后的所有周四实例，不包含2023-06-28（周三）

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