Dates-LE

Dates-LE：轻松提取日期

只需按下一次快捷键，即可从当前文件中提取所有日期和时间戳
支持任何文本文件——JSON、YAML、CSV、XML、TOML、Markdown、日志、HTML、JavaScript、TypeScript、Python、Go 等

觉得有用？ 点赞或评分能帮助其他开发者发现它—— ★ GitHub · ★ Open VSX · ★ Marketplace

功能介绍

打开文件，运行 Dates-LE: Extract Dates，文档中的所有日期就会被提取到新的编辑器中——随后可对其去重、排序、分析、转换、筛选或验证。可在 VS Code 以及基于 VS Code 的编辑器（如 Cursor 和 VSCodium）中使用（可从 Open VSX 安装）。

• 日志分析 — 提取服务器日志中的时间戳：ISO、syslog 和 Apache 访问日志格式
• 数据审查 — 提取 JSON、YAML、CSV 和 XML 中的日期和纪元时间
• 代码审计 — 提取 JS/TS 中的日期字面量，以及 new Date()/Date.parse()/moment()/dayjs()/DateTime.fromISO() 的参数，包括跨多行格式化的调用

安装

在 AI Agent 中使用

同一引擎也可作为 MCP 服务运行，因此 Agent 可以直接调用它，而无需你运行命令。

extract_dates(content, format?, filename?, dedupe?, dateOrder?, kinds?, maxResults?)

返回每个日期及其表示法、可解析时的纪元值，以及从 1 开始计数的行号和列号；默认上限为 500，并通过 meta.truncated 标明是否截断。dateOrder（mdy 或 dmy，默认值为 mdy）决定如何解析可能有两种读法的数字日期，例如 05/01/2024。kinds 用于选择要返回的日期类型；除非明确列出，否则不会包含 unix。

服务接收内容并返回数据 — 不读取文件，也不会自行发起网络请求。该项目以 dates-le-mcp 发布在 npm 上，并以 io.github.nolindnaidoo/dates-le 收录于 MCP 注册表。

{
  "mcpServers": {
    "dates-le": {
      "command": "npx",
      "args": ["-y", "dates-le-mcp"]
    }
  }
}

npm install -g dates-le-mcp

{
  "mcpServers": {
    "dates-le": { "command": "dates-le-mcp" }
  }
}

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | npx -y dates-le-mcp

每份文档都会被读取。 格式只会在共享模式的基础上增加模式，因此，未列出的语言 ID（Python、Go、Rust、shell、SQL）不会被拒绝，而是使用共享模式进行扫描。它们不会获得格式专属的额外模式：Jan 15 10:30:47 在日志文件中是日期，在 Python 文件中则是三个单词。

可识别的日期模式：扩展形式的 ISO 8601（2024-01-15T10:30:00Z，毫秒和时区偏移可选）、基本形式（20240115、20240115T103045Z）、周形式（2024-W03、2024-W03-1）和序数形式（2024-015）；RFC 2822（Mon, 15 Jan 2024 10:30:00 GMT）；秒、毫秒、微秒和纳秒格式的 Unix 时间戳，前提是 dates-le.kinds 包含 unix（恰好 10、13、16 或 19 位，且时间落在 2001-09-09 至 2100 年之间，因此，电话号码、请求 ID 或卡号不会被误认为是 2100 年或 2200 年的日期；嵌在更长数字、更长单词（如提交哈希）或浮点数小数部分中的数字完全不会匹配）；UTC 字符串；单独的 YYYY-MM-DD；日或月在前、以 /、. 或 - 分隔的数字日期（15/01/2024、1/15/2024、15.01.2024 14:00、15-01-2024 3:30 PM），时间可选；以及以文字写出月份的日期（15 January 2024、3rd Feb. 2024、Jan 15, 2024、15-JAN-2024）。数字日期中，只要某个数字大于 12，就按唯一可能的方式解读；只有当两个数字都可能是月份时，才由 dates-le.dateOrder 决定；带点的日期始终按日优先解读。每个数字日期或文字日期都会经过日历校验，因此 31/02/2024 不算日期；数字年份必须在 1900–2099 范围内。每个匹配项都会报告其实际行号和列号。无法解析为时间戳的值不会被提取。

时区名称包括固定偏移量 GMT/UT/UTC/Z、8 个美国时区缩写，以及 CEST、CET、BST、JST、AEST、IST。这些时区是固定偏移量，不会根据时区规则调整。

已知限制：有歧义的数字日期遵循 dates-le.dateOrder；除非更改该设置，否则默认月优先；文字月份仅支持英文；syslog 行不带年份，因此会假定为当前年份；IST 代表 3 个不同的时区，这里按印度的 +05:30 解读；独立的 8 位数字只有在年份为 1900–2099 时才会被识别为日期；处于时间戳范围内的 10 位数字无法与 Unix 时间区分，因此除非启用，否则不会识别这一类型。

扫描文件夹或工作区

Extract 会读取当前打开的文档。扫描会从磁盘读取多个文件，并生成一份按时间排序的项目日期报告。

• 整个工作区：从命令面板运行 Dates-LE: Extract Dates from Workspace。
• 单个文件夹：在资源管理器中右键单击该文件夹并选择 Extract Dates from Folder，或运行 Dates-LE: Extract Dates from Folder 后选择一个文件夹。 每个日期只列出一次，不论其拼写方式如何，按时间从早到晚排列，并显示其各种写法、出现次数和位置：

# Dates-LE workspace report

`my-project` · 3 file(s) read · 3 distinct date(s), 5 occurrence(s) in 3 file(s)

| Date | Written as | Occurrences | Files | Where |
|---|---|---|---|---|
| `2024-01-15` | `2024-01-15`, `2024-01-15T00:00:00Z`, `January 15, 2024` | 3 | 2 | |
| `2024-03-01T08:30:00Z` | `2024-03-01T10:30:00+02:00` | 1 | 1 | `data/events.json` · **2:13** |
| `2025-12-31` | `2025-12-31` | 1 | 1 | `docs/release.md` · **2:14** |

## `2024-01-15` (3)

- `docs/release.md` · **1:9**, **1:31**
- `src/config.ts` · **1:17**

同一个日期只占一行。 2024-01-15、2024-01-15T00:00:00Z 和 January 15, 2024 是同一个日期的三种写法，表格会明确标出。带时区的日期表示一个时刻，按 UTC 命名，并在“Written as”列中保留其原有偏移量。不带时区的日期则按原文命名，因此在每台机器上都是同一个日期。像 03/04/2024 这样的有歧义日期，会按照 dates-le.dateOrder 指定的方式读取。

所有日期都会列在表格中。只出现一次的日期会列在对应行中。重复出现的日期会在下方单独列出各个位置。

这是在启用 dates-le.showPositions 时的行为。该选项默认关闭；关闭时，每个位置会显示为文件名以及该日期在文件中的出现次数：docs/release.md (2)。剪贴板中的内容遵循 dates-le.clipboardIncludesPositions 的设置，Extract 也是如此。

扫描会读取什么。 文件从磁盘读取，因此不会看到尚未保存的编辑内容。超过安全大小的文件，或非 UTF-8 文本文件，都不会读取。扫描会在达到 5,000 个文件或 10,000 个已列出实例时停止。报告末尾会为每种未纳入的内容列出一行，避免将简短报告误认为项目中没有问题。

跳过哪些内容，以及如何更改。 以下三个开关默认启用，可在 Settings 中分别关闭：

还有两个列表可以调整扫描结果，而无需关闭开关。要跳过更多内容，请将模式添加到 scanExcludes。要读取某个开关会跳过的内容，请将其添加到 scanAlwaysInclude：

{
	// Also skip the test fixtures.
	"dates-le.workspace.scanExcludes": ["**/fixtures/**"],
	// Read the vendored code, though the built-in list skips it.
	"dates-le.workspace.scanAlwaysInclude": ["**/vendor/**"]
}

Dates-LE: Open Settings 会在 Settings 编辑器中打开以上所有设置。

影响扫描的设置位于 Settings 中。

CLI

相同的提取功能也可在终端或 CI 步骤中运行：Rust CLI 位于 crate/，与扩展共用同一语料库 — crate/fixtures/ — 因此两者读取文档的方式完全一致。同一命令行工具也以 dates-le 的形式发布在 npm 上，适用于安装了 Node 但没有 Rust 的机器；CI 会在三种操作系统上逐字节验证它与 crate 的一致性。

dates-le .                          # every date in the tree; JSON on stdout when piped
dates-le --before 2026-01-01 .      # everything already in the past
dates-le --sort --iso config/       # ordered by instant, in readable form
dates-le mcp                        # the same extraction over MCP on stdio

从 npm 安装 (dates-le) 或从 crates.io 安装 (dates-le)。两者都会安装相同的 dates-le 命令。

npm install -g dates-le   # or run it once: npx dates-le
cargo install dates-le

关键在于时间点。 2024-01-15、1705276800 和 Mon, 15 Jan 2024 是同一时刻的三种写法，将它们各自解析为数字，才能对它们进行排序和比较，而不是把它们当作三个字符串来读取。解析结果与 V8 中的 Date.parse 完全一致 — 包括旧式解析器 — 并通过取自 V8 本身的 178 个用例进行验证。

不带时区的日期会根据机器的时区解析，因为这才是真正的结果，而且确实会因机器而异。系统会遵循 TZ。

选择要提取的日期类型

dates-le.kinds 是一份清单，列出每条命令会提取的日期类型。未勾选的类型不会被报告，无论是在 Extract、文件夹或工作区扫描中，还是在 Analyze、Convert、Filter 和 Validate 中。

Unix 时间默认关闭。 这是唯一一种看起来不像日期的类型：范围合适的任意十位数字都可能是 Unix 时间，同样长度的 ID 或电话号码也可能被误认为是它。读取包含这类值的日志或数据时，可以将其开启：

{
	"dates-le.kinds": ["iso", "simple", "local", "rfc2822", "utc", "week", "ordinal", "basic", "custom", "unix"]
}

MCP 工具和 CLI 接受相同的列表，分别通过 kinds 参数和 --kinds 标志指定；与扩展一样，默认不包含 unix。

命令

默认情况下，没有命令绑定快捷键。可在编辑器的 Keyboard Shortcuts 中为任意命令设置快捷键。

设置

语言

除英语外，支持 12 种语言：

德语 · 西班牙语 · 法语 · 印度尼西亚语 · 意大利语 · 日语 · 韩语 · 巴西葡萄牙语 · 俄语 · 乌克兰语 · 越南语 · 简体中文

两部分均已本地化：清单（命令标题、设置名称和描述）以及扩展运行时显示的所有内容（通知、状态栏、快速选择项和提示词）。扩展会遵循 VS Code 的显示语言，因此会与编辑器当前设置的语言保持一致；无需单独设置。

隐私与安全

• 不访问网络。 扩展绝不会向任何地方发送数据。telemetryEnabled 设置只会将事件写入可供你检查的本地输出通道（Dates-LE Telemetry）。
• MCP 服务也遵循同样的原则。 它接收内容作为参数并返回数据：不访问文件系统、不进行网络调用、不收集遥测数据。你的 Agent 已有读取文件的工具，因此在服务内重复实现只会增加路径遍历风险，不会带来任何额外能力。若服务导入了任何可能访问上述任一资源的内容，check:mcp-bundle 就会导致构建失败。
• 错误通知会隐藏主目录和疑似凭据的片段。
• 评分提示最多显示两次。 第 3 次成功使用时，扩展会询问一次你是否愿意评分；如果你选择了 Later 或关闭提示，则会在第 20 次时再询问一次。选择 Don't Ask Again 后不会再显示。将 notificationsLevel 设置为 important 或 silent 也会关闭此功能。次数记录在 VS Code 的扩展存储中，不会发送到任何地方；点击 Rate 会在浏览器中打开你安装扩展的平台页面——VS Code Marketplace 或 Open VSX。

文档

性能

在 Apple M5 Pro、24 GB RAM、Node 24.3.0 上预热后运行 7 次所得的中位数。输入由 scripts/benchmark.ts 生成，而非检入版本库，因此上方的大小就是 实际测得的大小。使用 bun run benchmark 可复现。

这些数据因机器而异，不会在 CI 中作断言——会阻止构建的基准测试 只能说明运行器当时有多忙。

测试

31 个文件中共有 396 个测试用例，此外还有一个在真实 VS Code 扩展宿主中运行的集成测试套件，以及一个将构建好的 .vsix 安装到干净配置文件中的端到端测试。

数据由 scripts/coverage-readme.js 根据真实运行结果——coverage/coverage-summary.json 和 coverage/test-results.json——生成；若本节内容发生偏差，CI 将失败。使用 bun run test:coverage 可复现，测试用例数以 vitest 打印的为准。

LE 系列的更多工具

为每个模型眼前的工作打造的 16 款单一用途工具。每款都附带一个 Rust CLI 和一个 MCP 服务。一页尽览：letools.dev

提取

• String-LE — 提取代码库中的所有字符串，方便人工阅读
• Numbers-LE — 提取代码库中所有硬编码数字，方便人工检查
• Units-LE — 提取所有带单位的数量并统一格式，遇到含义不明确的数量时会按名称拒绝处理
• Dates-LE — 提取所有日期和时间戳，并给出每个日期和时间戳解析出的确切时刻
• IDs-LE — 提取所有 UUID、ULID、NanoID、ObjectId 和 Snowflake，并解码其中的时间
• IPs-LE — 提取所有 IP 地址、CIDR 网段和 MAC 地址，统一格式并按范围分类
• URLs-LE — 提取代码库中的所有 URL，并给出协议和确切位置
• Paths-LE — 提取代码库中的所有文件路径，并说明它们是否仍指向实际内容
• Colors-LE — 提取代码库中的所有颜色，并指出哪些颜色不在你的调色板中

检查

• Regex-LE — 查找代码库中的所有正则表达式，并报告哪些可能导致灾难性回溯
• Versions-LE — 查找某个依赖项在仓库的各个清单文件中受到不同约束的位置
• i18n-LE — 识别项目使用的 i18n 库，然后依据该库的规则审查其目录
• Scrape-LE — 在编写抓取器之前检查网页能否抓取，并说明何时无法判断

防护

• Secrets-LE — 查找代码库中的硬编码凭据，绝不在报告中打印凭据
• EnvSync-LE — 比较目录树中的 dotenv 文件，并指出哪些文件缺少哪些键
• Unicode-LE — 查找那些隐藏含义的 Unicode 字符——双向控制字符、不可见字符、同形异义字符、混合文字系统

每款工具都独立运行：没有共享的 crate，也没有发布的核心库。若有两款工具得出相同结论，那是因为这个答案经得起两次验证。

联系 — nolindnaidoo.com · GitHub · LinkedIn

nolindnaidoo 的其他项目

Rust — pixelcoords 和 pixelactions 构成一个工作循环：pixelcoords 回答 位置，pixelactions 在那里执行操作。它们有各自的工具、各自的风格——不属于 LE 系列。

• pixelcoords — 冻结屏幕，标记区域，获取像素级精确的坐标和裁剪图像 pixelcoords.dev · crates.io · docs.rs
• pixelactions — 使用经过人工验证的坐标执行交互，并确认操作已生效 pixelactions.dev · crates.io · docs.rs

许可证

MIT © nolindnaidoo