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

问题背景

在MagicMirror项目的日历模块使用过程中，当处理跨越多天的全天事件时，用户发现即使设置了showEnd: true参数，系统也无法正确显示事件的结束日期。这是一个典型的日历事件边界处理问题，涉及到iCalendar(ICS)规范与前端展示逻辑的匹配。

技术原理分析

iCalendar规范中的全天事件

根据iCalendar规范(RFC 5545)，全天事件使用VALUE=DATE类型表示，不包含时间部分。关键特性包括：

• 开始日期(DTSTART)包含在事件内
• 结束日期(DTEND)表示事件结束的次日（即排他性边界）
• 例如：DTSTART=20241025和DTEND=20241031表示事件从10月25日开始，到10月30日结束（包含30日）

前端展示逻辑

MagicMirror日历模块当前的处理方式：

1. 当检测到全天事件时，使用fullDayEventDateFormat格式显示
2. 启用showEnd选项时，会尝试显示开始和结束日期
3. 但直接使用DTEND值会导致显示"20241031"，而用户期望看到的是"20241030"

问题根源

问题的本质在于没有对iCalendar的全天事件结束日期进行减一天的处理。按照规范：

• DTEND=20241031实际表示事件在2024年10月30日23:59:59结束
• 但用户界面应该显示逻辑结束日期(20241030)而非规范结束日期(20241031)

解决方案建议

前端处理方案

应在日历模块的渲染逻辑中添加针对全天事件的特殊处理：

function formatFullDayEventDate(start, end) {
    // 对结束日期减一天处理
    const adjustedEnd = new Date(end);
    adjustedEnd.setDate(adjustedEnd.getDate() - 1);
    
    return `${formatDate(start)} - ${formatDate(adjustedEnd)}`;
}

配置建议

用户可以通过以下临时解决方案之一：

1. 在ICS文件中手动将DTEND减一天（不推荐，可能影响其他系统）
2. 使用自定义模块扩展日历功能，覆写日期格式化逻辑
3. 等待官方修复后更新MagicMirror版本

同类问题扩展

这个问题不仅存在于MagicMirror中，许多日历应用都需要处理类似的边界情况：

1. 跨时区全天事件
2. 重复事件的结束日期计算
3. 不同日历服务(Google, Outlook等)对规范的实现差异

最佳实践

开发日历相关功能时应注意：

1. 明确区分包含性边界和排他性边界
2. 对全天事件进行特殊处理
3. 提供灵活的日期格式化选项
4. 在文档中明确说明日期范围的处理逻辑

这个问题预计将在MagicMirror的下一版本中得到修复，届时用户只需更新配置即可获得正确的日期显示效果。