日历导出/同步日历事件格式自定义

日历事件格式自定义

年轮 Pro 功能

此功能为年轮 Pro 功能,需要解锁年轮 Pro 后才能使用。

年轮时间统计支持自定义日历事件格式,你可修改日历事件的标题、地点、备注的内容格式,满足你的需求。

日历事件包含三个部分:标题 Title、地点 Location、备注 Notes,即有三个日历事件格式可以自定义。默认的日历事件格式为:标题 [detail],地点 [duration],备注 [note]

你可以在日历设置页修改默认的日历事件格式,将会默认应用于所有导出的日历事件;也可以在日历设置页内的特定项目设置页中,为项目设置独立的日历事件格式。

日历事件格式中可以使用的变量

变量名称关键字示例
项目名称[project]学习
标签[tags]#折腾 #Project Log
详情[detail]搭建年轮文档
时长[duration]1小时 2 分钟
开始时间[start]2025-01-01 10:00
结束时间[stop]2025-01-01 11:02
笔记[note]使用 fumadocs 搭建文档框架,以 mdx 格式撰写与管理内容

例如,修改 Title 的格式为 [project] - [detail],则日历事件格式为:项目名称 - 详情

修改 Location 的格式为 [start] ~ [stop],则日历事件格式为:开始时间 ~ 结束时间

修改 Notes 的格式为 [tags]\n[note],则日历事件格式为:标签\n笔记

变量分隔

默认情况下不需要特地设置分隔符,只有在格式中连续使用了多个变量时需要设置。

例如:[project][detail],这一格式中两个变量之间没有分隔符,需要将两个变量分隔,否则会导致导入格式错误。

因为如果两个变量连续使用,年轮在从日历导入事件时将会无法区分哪部分是哪个变量。如果日历 Title 为 日常娱乐,格式为 [project][detail],则无法判断项目名是 日常 还是 日常娱乐

因此请在格式中将变量进行分隔。通常推荐使用 | 符号作为分隔符,例如:[project]|[detail]。若使用其他符号,请确保该符号在记录的详情中不会出现,避免解析错误。

不推荐使用单个空格作为分隔,因为空格在详情、标签、笔记内容中经常出现,容易导致解析错误。

分隔符不限定于单个字符,可以使用任意多个字符作为分隔,只需要保证两个变量之间不是直接相连即可。例如:[project]: -[detail]

变量优先级

在相同字段中多次使用同一个变量时,年轮会使用最先出现的变量。

当在多个字段(标题、地点、备注)中使用相同的变量关键字时,年轮会按照以下优先顺序处理:

  1. 标题(Title)中的变量
  2. 地点(Location)中的变量
  3. 备注(Notes)中的变量

例如,如果你在标题和地点中都使用了 [project] 变量,年轮会优先使用标题中解析出的项目名称。

日历事件对应的年轮项目

同步修改时

当年轮从日历事件同步修改时,如果格式包含 [project] 变量,且年轮中存在这一名称的项目,年轮会更新对应时间记录的项目为这一个项目。否则,年轮不会修改时间记录的项目。

导入事件时

当年轮从日历导入事件转化为时间记录时,也会优先使用格式中的 [project] 变量来匹配同名项目,如果格式中包含 [project] 变量,且匹配成功,年轮会使用匹配到的项目。

若上述步骤没有匹配到项目,年轮会使用事件所在日历所对应关联的项目。

如果日历没有找到关联的项目,最终导入的时间记录的项目会为空。

最后更新