README file from
Github重要日子插件 (Important Days)
一款为 Obsidian 打造的重要日子记录插件,支持纪念日、生日倒计时,农历公历互转,属相星座显示。
功能特性
纪念日
- 显示倒计时天数
- 显示即将达到的周年数
- 显示已过总天数和月数
- 显示原始日期和下一次日期是星期几
- 显示下一次具体日期
生日
- 显示倒计时天数
- 显示即将达到的年龄和已出生天数
- 支持公历/农历输入
- 公历农历互相关联显示
- 显示属相(按农历年份计算)和星座
- 显示下一次生日具体日期
- 特殊生日支持:闰年2月29日、农历闰月生日
周期事件
- 支持每月固定日期(如每月15号发薪)
- 支持每季度固定日期(如每季度第3个月15号)
- 支持每年固定日期(如每年03-15年度体检)
- 支持每周固定日期(如每周一例会)
- 显示下次日期和倒计时
界面
- 简洁美观的卡片设计
- 自动适配深色/浅色模式
- 响应式布局,适配手机和电脑
- 头部固定,列表可滚动
- 图标按钮,简洁美观
- 临近提醒(14天内高亮显示)
数据管理
- 自动扫描数据文件
- 数据存储在普通 Markdown 文件中
安装
手动安装
- 下载
important-days.zip - 解压到 Obsidian 插件目录
.obsidian/plugins/important-days/ - 重启 Obsidian 并启用插件
使用方法
打开视图
- 点击左侧边栏的心形图标
- 或使用命令面板(
Ctrl/Cmd + P)搜索「重要日子」
添加日子
- 点击右上角「+」按钮
- 填写名称、类型、日期
- 勾选「农历日期」可输入农历生日
编辑/删除
- 手机端:长按卡片进入编辑
- 电脑端:双击卡片进入编辑
- 删除按钮在编辑界面底部
数据格式
数据存储在 重要日子.md 文件中:
# 重要日子
## 纪念日
- 结婚纪念日 | 2023-05-20
- 恋爱纪念日 | 2020-02-14
## 生日
- 妈妈生日 | 1965-08-15
- 奶奶生日 | 1940-12-08 | 农历
- 小明生日 | 2000-02-29
- 姑姑生日 | 1980-06-15 | 农历闰
## 周期事件
- 发薪日 | 每月 15
- 季度会议 | 每季度 3-15
- 年度体检 | 每年 03-15
- 周例会 | 每周 1
格式说明
- 用
|分隔字段 - 类型通过 section 标题判断
- 第三个字段:
农历表示农历日期农历闰表示农历闰月日期
- 特殊生日处理:
- 闰年2月29日生日:非闰年自动显示2月28日,卡片标记"闰年生日"
- 农历闰月生日:有闰月年份显示闰月日期,无闰月年份显示普通月份日期
- 周期事件格式:
周期类型 周期值- 每月:
每月 日期(如每月 15) - 每季度:
每季度 月份-日期(如每季度 3-15表示每季度第3个月的15号) - 每年:
每年 月份-日期(如每年 03-15) - 每周:
每周 星期(1-7,如每周 1表示每周一) - 日期超出当月天数时自动调整(如2月31号→2月28/29号)
- 每月:
卡片显示示例
纪念日卡片
┌─────────────────────────────────────┐
│ 结婚纪念日 │ 128 │
│ 2023-05-20 周六 │ │
│ 即将1周年 │ │
│ 已相伴 366 天(12个月) │ │
│ 下一次:2026年5月20日 周三 │
└─────────────────────────────────────┘
生日卡片(公历)
┌─────────────────────────────────────┐
│ 妈妈生日 │ 45 │
│ 1965-08-15 周日 · 即将61岁 │
│ 农历八月初八 · 属龙 · 天蝎座 │
│ 已出生 22268 天 │
│ 下一次:2026年8月15日 周六 │
└─────────────────────────────────────┘
生日卡片(农历)
┌─────────────────────────────────────┐
│ 奶奶生日 │ 120 │
│ 农历 腊月初八 · 属龙 · 摩羯座 │
│ 1941年1月5日 周日 · 即将86岁 │
│ 已出生 31025 天 │
│ 下一次:... │
└─────────────────────────────────────┘
临近提醒(14天内)
倒计时数字变为橙色,下方显示橙色下划线。
技术架构
| 模块 | 说明 |
|---|---|
| DateUtils | 日期工具函数(倒计时、年龄、周年、已过天数/月数计算) |
| LunarCalendar | 农历转换(1900-2100年)、属相、星座 |
| ImportantDaysView | 卡片列表视图、弹窗交互 |
| ImportantDaysSettingTab | 设置面板 |
| ImportantDaysPlugin | 插件主类 |
更新日志
v1.1.4 (2026-04-24)
- ✅ 显示已过总天数和月数
- ✅ 显示下一次具体日期和星期几
- ✅ 显示原始日期是星期几
- ✅ 属相星座合并到农历行
- ✅ 临近提醒(14天内高亮显示)
- ✅ 统一卡片高度
- ✅ 优化界面布局和字体大小
v1.1.0 (2026-04-24)
- ✅ 自动扫描数据文件
- ✅ 图标按钮替代文字按钮
- ✅ 头部固定,列表可滚动
- ✅ 编辑界面添加删除按钮
- ✅ 优化手机端布局
v1.0.0 (2026-04-23)
- ✅ 纪念日记录与倒计时
- ✅ 生日记录与倒计时
- ✅ 农历公历互转
- ✅ 属相星座显示
- ✅ 深色/浅色模式适配
- ✅ 手机端适配
License
MIT License