MagicMirror日历模块中多日全天事件结束日期显示问题解析

在MagicMirror项目的日历模块使用过程中，开发者发现了一个关于多日全天事件(multi-day all-day events)的显示问题。当事件跨越多个完整日期时，即使用户明确设置了showEnd: true参数，系统也无法正确显示事件的结束日期。

问题现象分析

通过提供的iCalendar(.ics)示例可以看到，该测试事件从2024年10月25日开始，到10月31日结束。按照iCalendar规范，DTEND字段表示的是事件结束的次日（即事件实际结束于DTEND日期的前一刻）。因此这个事件实际持续时间为10月25日至10月30日（共6天）。

然而在MagicMirror的显示配置中，虽然设置了：

showEnd: true,
fullDayEventDateFormat: "Do.MMM",

系统却未能按照预期显示"25th.Oct-30th.Oct"这样的日期范围格式。

技术背景

iCalendar规范对于全天事件有特殊处理：

1. 全天事件使用DATE类型而非DATETIME类型
2. DTEND值实际上是事件结束后的第一天
3. 这是为了确保事件完整包含指定的天数

MagicMirror的日历模块在处理这类事件时，可能没有完全考虑这种边界情况，导致结束日期显示不完整。

解决方案建议

对于开发者而言，可以采取以下方法解决：

1. 前端显示逻辑调整： 在显示全天多日事件时，应该对DTEND值做减1天的处理，以反映实际的结束日期。

2. 配置优化： 可以扩展配置选项，增加对全天事件结束日期显示方式的控制参数，例如：

   allDayEventEndDisplay: "actual" // 或 "original"
   

3. 格式字符串处理： 在格式化日期时，针对全天事件添加特殊处理分支，确保结束日期的正确显示。

最佳实践

对于MagicMirror用户，在当前版本中可以暂时采用以下变通方案：

1. 使用自定义日历显示模块
2. 通过CSS样式覆盖默认显示
3. 在后端处理iCalendar数据时预先调整DTEND值

总结

这个问题的本质在于iCalendar规范与用户预期之间的差异。MagicMirror作为显示层，应当对这种规范特殊性进行适当处理，以提供更符合用户直觉的日期显示方式。未来版本中可能会加入对此问题的官方修复，使多日全天事件的日期范围显示更加准确直观。

对于开发者社区而言，这也提醒我们在处理日历数据时需要特别注意不同规范对日期边界的不同定义，特别是在跨日事件的显示逻辑上需要格外谨慎。