mcpField
D
datetime

datetime

github.com/cadrianmae生产力273 次安装11 周前更新
代码仓库

关于 datetime

datetime 是使用 GNU date 解析自然语言日期和时间的技能,适用于相对日期、截止时间及当前时间查询。

主要功能

  1. 01解析相对日期表达式
  2. 02处理星期名称和时间偏移
  3. 03查询当前日期和时间
  4. 04提供命令模式与输出格式
  5. 05说明无效表达式的处理方式

适用场景

  1. 01将“下周一上午 9 点”转换为时间
  2. 02为时效任务查询当前日期
  3. 03解析“3 天后”等截止时间

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/cadrianmae/claude-marketplace --skill datetime

安装后在 Claude Code 中输入/datetime确认已加载。

附带文件references/reference.md

详细介绍

日期时间自然语言解析器

使用 GNU date 命令(Linux 原生命令行工具)解析自然语言日期和时间表达式。

重要:适用于 Claude Code

不要调用斜杠命令(/datetime:parse、/datetime:now、/datetime:calc)——这些命令仅供用户使用。

请改为通过 Bash 工具直接使用 date 命令:

# Get current date/time
date '+%Y-%m-%d %H:%M:%S (%A)'

# Parse natural language
date -d "tomorrow" '+%Y-%m-%d %H:%M:%S (%A)'
date -d "next monday at 9am" '+%Y-%m-%d %H:%M:%S (%A)'
date -d "3 days" '+%Y-%m-%d %H:%M:%S (%A)'

本技能提供命令模式以及使用时机。斜杠命令供用户手动调用。

快速示例

date -d "next Friday" '+%Y-%m-%d %H:%M:%S (%A)'
# 2026-02-06 00:00:00 (Friday)

何时使用此技能

在以下情况下自动调用:

  • 用户提到时间表达式:“明天”“下周”“3 天后”
  • 需要确认当前日期或时间
  • 用户提及截止日期或有时效性的任务
  • <env> 上下文中的日期有误

使用方法

使用 Bash 工具运行 date -d 命令:

获取当前日期/时间:

date '+%Y-%m-%d %H:%M:%S (%A)'

解析自然语言:

date -d "tomorrow" '+%Y-%m-%d %H:%M:%S (%A)'
date -d "next wednesday" '+%Y-%m-%d %H:%M:%S (%A)'
date -d "3 days" '+%Y-%m-%d %H:%M:%S (%A)'
date -d "next monday 9am" '+%Y-%m-%d %H:%M:%S (%A)'

重要提示:date 命令无法识别关键词 “in”。用户说 “in 3 days” 时,请改用 "3 days"。

输出格式

返回单行:YYYY-MM-DD HH:MM:SS (DayName)

示例:2024-10-29 14:23:45 (Tuesday)

支持的表达式

  • 相对日期:“today”“tomorrow”“yesterday”
  • 指定星期:“next monday”“this wednesday”“last friday”
  • 时间偏移:“3 days”“2 weeks”“5 months ago”
  • 复合表达式:“tomorrow 3pm”“next monday at 9am”
  • 过去时间:“3 days ago”“last week”

错误处理

如果 date -d 因表达式无效而失败:

  1. 识别失败:如果命令返回错误,告知用户无法解析该表达式
  2. 尝试其他方法:查看 references/reference.md,了解:
    • 日期运算示例(如果用户需要进行相对日期计算)
    • 复杂表达式语法(如果用户需要组合日期)
    • Unix 时间戳计算(如果用户需要计算日期间隔)
  3. 回退到当前日期:如果没有其他方法可用:
    date '+%Y-%m-%d %H:%M:%S (%A)'
    

错误处理示例:

# Try parsing
date -d "user expression" '+%Y-%m-%d %H:%M:%S (%A)' 2>&1
# If error message appears, tell user and suggest checking references/reference.md for advanced patterns

高级用法

有关相对日期计算、周数和复杂日期运算,请参阅 references/reference.md。

评论

支持 Markdown