Quick Date Entry

by leoray
5
4
3
2
1
Score: 50/100
New Plugin

Description

Keyboard-friendly date insertion, a calendar, and customizable date presets for Obsidian.

Reviews

No reviews yet.

Stats

0
stars
downloads
0
forks
0
days
0
days
0
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
1
commits

Latest Version

19 hours ago

Changelog

Quick Date Entry 1.3.0

The first public release of Quick Date Entry for Obsidian 1.13.0 and later.

  • Type @ or a custom trigger to open a keyboard-friendly date picker in the Markdown editor. Preview the exact text before insertion.
  • Mix built-in and custom dates in one reorderable list. Create custom dates from day offsets, weekdays, fixed dates, or Moment formulas.
  • Switch between your configured date formats, browse months, or use the letter shortcuts shown with Space.
  • Use the plugin in English or Chinese. All date calculations and settings stay local.

Download main.js, manifest.json, and styles.css into .obsidian/plugins/quick-date-entry/ for manual installation.

中文

输入 @ 打开日期弹窗。支持键盘选日、日期格式预览、自定义日期与 Moment 公式,以及内置和自定义日期混合排序。

README file from

Github

Quick Date Entry

Insert a date without leaving the Markdown editor. Type @ or your own trigger to open a calendar and see the exact text that will be inserted. Use the arrow keys, letter shortcuts, or a mouse to select a date.

Quick start

  • Press Enter to insert the highlighted date. Space shows letter shortcuts. Shift + Left/Right changes the month, Shift + Up/Down changes the format, and Esc closes the picker.
  • Choose which dates appear and drag them into one order. Mix built-in dates with relative days, weekdays, fixed dates, or Moment formulas such as moment().add(1, "month").endOf("month").
  • Pick a default format and define additional formats in the plugin settings. The interface supports English and Chinese.

The plugin works offline and stores its settings in the current vault.

Installation

For a manual install, download main.js, manifest.json, and styles.css from the latest GitHub release. Put the three files in .obsidian/plugins/quick-date-entry/ in your vault, then enable Quick Date Entry under Settings → Community plugins.

中文使用说明

在 Obsidian 的 Markdown 编辑器中输入 @,即可在光标旁选择日期。弹窗顶部会预览当前日期的插入文字,确认后用预览中的日期替换触发字符,光标回到编辑器。日历以周一为一周的第一天,支持源码模式和实时预览。

安装

  1. 从 GitHub Release 下载 main.js、manifest.json 和 styles.css,放入目标库的 .obsidian/plugins/quick-date-entry/。
  2. 在 Obsidian 的「设置 → 第三方插件」中刷新插件列表并启用 Quick Date Entry。
  3. 在插件设置中可以更换触发字符,例如 ! 或 @,也可选择中文、English 或跟随 Obsidian。常用日期和日历可分别关闭,两者都关闭时,输入触发字符会和普通输入一样。

日期格式

  • 在插件设置中修改「日期格式」。默认使用 YYYY-MM-DD,可以填写 YYYY/MM/DD、YYYY年M月D日 或其他 Moment 格式。设置页会实时预览今天的日期。
  • 「弹窗可选格式」每行填写一种格式,可添加、删除或调整顺序。留空时只使用默认格式,弹窗隐藏格式切换按钮。
  • 点击弹窗右上角的「格式」按钮,或用方向键移到按钮后按 Enter,可在默认格式和自定义列表间循环。切换即时更新预览,只对当前弹窗生效。

常用日期

  • 在设置的「常用日期排序」中选择弹窗显示哪些日期。内置和自定义日期可在同一列表拖拽排序,也可聚焦拖拽手柄后用上下键移动。弹窗按设置中的顺序显示。
  • 点击「添加日期」新增选项,可选择相对天数、指定星期、固定日期或「高级 Moment 公式」。已启用的前 14 个自定义日期可用字母键,其他自定义日期可用方向键选中。

高级公式以 moment() 或指定起始日期的 moment(...) 开始,支持常用的日期链式操作,包括 add、subtract、startOf、endOf、set、day、isoWeekday、week、month 和 year。设置页会预览计算结果。

日期 公式
下个月最后一天 moment().add(1, "month").endOf("month")
两周后的周五 moment().add(2, "weeks").isoWeekday(5)
下季度第 15 天 moment().add(1, "quarter").startOf("quarter").add(14, "days")
指定日期再加 3 天 moment("2026-12-31").add(3, "days")

更多用法见 Moment.js 日期操作文档。

键盘操作

  • 输入触发字符后,高亮「今天」。仅开启日历时,高亮日历中当天的日期。编辑器保留原来的光标。
  • 方向键在日期和月份按钮之间移动,Enter 确认。日历中左右键移动一天,跨月时自动翻页。
  • Shift + ← / → 切换月份,尽量保留同一日。Shift + ↑ / ↓ 切换上一个或下一个日期格式。这两组快捷键可在设置中分别关闭。
  • 按 Tab 保持弹窗和当前选项。
  • 日历标题旁的「今天」按钮会回到本月,并将焦点移到今天。
  • 空格开启或关闭字母快捷键模式。开启后,以下按钮右上角显示字母,按对应字母即可执行。
  • Esc 关闭弹窗,保留已经输入的触发字符。
  • 底部一次显示一条键盘提示。按右箭头按钮查看下一条,关闭最后一条后,该笔记库以后不再显示提示区。所有提示仍可在设置页查看。
按键 操作 按键 操作
Q 今天 A 昨天
W 明天 S 前天
E 后天 D 本周一
R 下周一 F 本周五
J 上个月 K 下个月
H 切换日期格式 L 回到今天

Build / 构建

npm ci
npm run build

License

MIT