如何向手机自带日历批量添加课程表与生日？

一、需求背景

我之前一直是用独立的APP记录生日（生日本）和待办事项（滴答清单）。最近我突然有一种复古或者说断舍离的心态：积极拥抱原生APP，能否把待办事项和生日本的功能都集中到手机自带的日历里？

苹果手机自带待办事项集中到日历显示的功能，甚至不需要任何额外操作——但这并不是这篇文章的重点。

苹果手机也自带记录生日这个功能：在通讯录联系人处设置生日，日历会自动显示生日。

但可能有几个问题：

微信发达，很多人你都没有存他的电话，当然也不会有他的通讯录；
如果你之前没有做过这些事，你也不想一个个手动添加吧？
我要记录的不止是生日！比如，学生时代的我需要记录课程表，当时需要下载单独的课程APP（超级课程表）。但天下没有免费的午餐，这类APP最后的结局往往是广告泛滥、充满各类无用社交功能的红点点、需要付费。

所以，为什么不充分利用手机自带的日历呢？毕竟买手机的钱可不止包含了硬件部分，当然也有软件部分！

二、基础知识（不感兴趣可略过）

其实日历也是一种文件类型。

ICS是其常用的一种文件格式，除此之外还有ICAL（苹果生态系统常用）等。

注意，文件格式≠文件类型，比如对于“图像类型”而言，它对应JPG，PNG等多种文件格式。

1. 顶层容器：VCALENDAR

每个ICS文件必须以 BEGIN:VCALENDAR 开始，以 END:VCALENDAR 结束。它包含全局信息和一个或多个日历组件（如事件、待办事项等）。

VERSION: 必需字段，通常为 2.0。
PRODID: 必需字段，标识生成该文件的产品ID（例如：-//Google Inc//Google Calendar 70.9054//EN）。
CALSCALE: 可选，日历标度，通常为 GREGORIAN。
METHOD: 可选，定义日历对象的处理方法（如 PUBLISH, REQUEST, REPLY, CANCEL 等），常用于会议邀请。

2. 核心组件：VEVENT (日历事件)

这是最常用的组件，定义具体的日程事件。位于 BEGIN:VEVENT 和 END:VEVENT 之间。

UID: 必需。全局唯一标识符，用于区分不同事件或同一事件的不同实例。
DTSTAMP: 必需。时间戳，表示该条目创建或最后修改的时间。
DTSTART: 必需。事件开始时间。格式通常为 YYYYMMDDTHHMMSSZ (UTC) 或带时区ID。
DTEND: 可选（若未提供且无DURATION，则视为瞬时事件）。事件结束时间。
SUMMARY: 常用。事件的简短标题或摘要。
DESCRIPTION: 可选。事件的详细描述。支持多行文本（需折叠处理）。
LOCATION: 可选。事件发生的地点。
STATUS: 可选。事件状态，如 CONFIRMED (已确认), TENTATIVE (暂定), CANCELLED (已取消)。
ORGANIZER: 可选。组织者信息，通常包含 mailto: 链接和名称。
ATTENDEE: 可选。参与者列表，可包含多个，注明角色（如 REQ-PARTICIPANT）和响应状态。
RRULE: 可选。重复规则（Recurrence Rule），定义事件如何重复（如每天、每周、每月等）。例：RRULE:FREQ=WEEKLY;BYDAY=MO,WE,FR (每周一、三、五)。
EXDATE: 可选。排除日期，指定重复事件中不发生的特定日期。
DURATION: 可选。事件持续时间（如果未使用DTEND）。
CLASS: 可选。访问级别，如 PUBLIC, PRIVATE, CONFIDENTIAL。
URL: 可选。关联的网页链接。
ATTACH: 可选。附件引用（可以是URI或内嵌数据）。
CATEGORIES: 可选。事件分类标签。
PRIORITY: 可选。优先级（1-9，1最高）。
TRANSP: 可选。时间透明度，OPAQUE (忙碌) 或 TRANSPARENT (空闲)。

3. 其他常见组件

除了 VEVENT，ICS文件还可以包含：

VTODO: 待办事项（任务）。字段类似事件，但侧重截止日期（DUE）和完成状态（COMPLETED）。
VJOURNAL: 日记条目。
VFREEBUSY: 空闲/忙碌时间信息，常用于调度。
VALARM: 闹钟/提醒。嵌套在事件或任务中，定义触发时间（TRIGGER）和动作（ACTION，如 DISPLAY, EMAIL, AUDIO）。

4. 字段值格式注意事项

日期时间格式:

浮点时间（无时区）：YYYYMMDDTHHMMSS
UTC时间：YYYYMMDDTHHMMSSZ (末尾加Z)
带时区引用：DTSTART;TZID=Asia/Shanghai:20260226T140000

文本折叠: 长行（超过75字节）必须折叠，续行以空格或制表符开头。
字符转义: 特殊字符需要转义，如逗号 \,、分号 \;、换行 \n、反斜杠 \\。

5.一个最小的事件示例

BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//Manual//EN
BEGIN:VEVENT
UID:unique-123@test.com
DTSTAMP:20260226T080000Z
DTSTART:20260227T100000Z
SUMMARY:最小化测试事件
END:VEVENT
END:VCALENDAR

三、工作思路

根据以上知识，我们得出我们的工作思路：

拿到课程表/生日/日程的原始数据
标准化：通过Excel整理一份课程表/生日/日程文件，它应该至少包含“事件标题SUMMARY”“开始时间DTSTART”“UID”“时间戳DTSTAMP”，一般也包括“结束时间”和“详细描述”；（人工/大模型完成）
将这份Excel文件转换为ICS文件（大模型完成）（也可以跳过第二步直接让大模型将原始数据转换为ICS文件）
将ICS文件导入手机