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> コンテキストに誤った日付が表示されている場合

使用方法

date -d コマンドを Bash ツールで使用します。

現在の日付・時刻を取得する:

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」というキーワードを理解しません。ユーザーが「3 日後」と言った場合は、代わりに "3 days" を使用します。

出力形式

1 行で返されます:YYYY-MM-DD HH:MM:SS (DayName)

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

対応する表現

  • 相対的な表現:「今日」「明日」「昨日」
  • 曜日指定:「次の月曜日」「今週の水曜日」「先週の金曜日」
  • 期間の指定:「3 日」「2 週間」「5 か月前」
  • 複合表現:「明日の午後 3 時」「次の月曜日の午前 9 時」
  • 過去の表現:「3 日前」「先週」

エラー処理

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 を参照してください。

コメント