RRule.js中RRuleSet的toText()方法返回结果异常求助

在使用RRule.js库的RRuleSet时，发现toText()方法无法生成符合预期的可读文本，实际输出与预期偏差较大。

问题复现代码 #

const rruleSet = new RRuleSet();

// 向RRuleSet添加rrule
rruleSet.rrule(
  new RRule({
    freq: RRule.DAILY,
    interval: 1,
    byweekday: [RRule.MO],
    dtstart: new Date('2023-07-17T08:00:00.000Z'),
    until: new Date('2023-07-01T08:00:00.000Z'), // 此处until早于dtstart，逻辑异常
  })
);

rruleSet.exdate(new Date('2023-07-24T08:00:00.000Z'));

// 执行结果：
console.log(rruleSet.toText()); // 输出：2023 every year ===> 不符合预期
console.log(rruleSet.toString());// 输出：DTSTART:20230718T171738Z
// RRULE:FREQ=DAILY;INTERVAL=1;BYDAY=MO;UNTIL=20230801T000000Z
// EXDATE:20230724T000000Z
console.log(rrulestr(rruleSet.toString()).toText()); // 再次输出：2023 every year ===> 仍不符合预期

问题原因分析 #

1. until日期逻辑错误：设置的until日期（2023-07-01）早于dtstart（2023-07-17），违反RRule规则逻辑，导致内部解析混乱，进而让toText()生成错误文本。
2. 频率与规则不匹配：使用DAILY频率搭配byweekday: [RRule.MO]虽能实现每周一重复，但语义上更适合用WEEKLY频率，这种不匹配会干扰toText()的文本生成逻辑。
3. 时区转换问题：传入的UTC日期转换为本地时区时出现偏移，导致toString()中的UNTIL日期被错误转换，进一步影响toText()的解析。

解决方案 #

修正后的代码 #

const rruleSet = new RRuleSet();

rruleSet.rrule(
  new RRule({
    freq: RRule.WEEKLY, // 改用WEEKLY频率匹配语义
    interval: 1,
    byweekday: [RRule.MO],
    dtstart: new Date('2023-07-17T08:00:00.000Z'),
    until: new Date('2023-08-01T08:00:00.000Z'), // 确保until晚于dtstart
  })
);

rruleSet.exdate(new Date('2023-07-24T08:00:00.000Z'));

// 执行结果：
console.log(rruleSet.toText()); // 输出：every Monday until August 1, 2023 except July 24, 2023

关键修正点 #

• 将freq从DAILY改为WEEKLY，匹配“每周一重复”的语义，让toText()能正确解析规则。
• 调整until日期至dtstart之后，保证规则逻辑合法性。
• 确保所有日期使用一致时区（此处为UTC），避免转换错误。

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