madr/date-iso8601

ADR の date フィールドが YYYY-MM-DD 形式の有効な ISO 8601 カレンダー日付であることを検証します。

このルールは context.metadata[field] を読み取ります。これは YAML frontmatter に v2 の本文リストメタデータをマージしたものです（競合時は frontmatter が優先され、明示的な null/undefined の frontmatter 値はスキップされます）。したがって MADR v2（太字の - **Date**: および素の * Date: リスト項目）、v3、v4 をサポートします。

gray-matter はクォートされていない date: 2026-05-01 を JavaScript の Date にパースします。このルールは Date を toISOString().slice(0, 10) によって正規化し、string はそのまま保持し、それ以外（null, boolean, number）は欠落として扱います。検証には Date.UTC のラウンドトリップを使用するため、外部ライブラリなしでうるう年や月の日数が正しく扱われます。

チェック内容

missingDate — 設定されたフィールドが存在しない、またはその値が文字列 / Date ではありません。メッセージ: Metadata does not contain a "<field>" field (checked frontmatter and v2 bold-list)。data.field を含みます。
invalidDate — 値は存在するものの、実在する YYYY-MM-DD 日付ではありません: 形式が不正（2026-5-1, 26-05-01, today）か、存在しないカレンダー日付（2026-13-01, 2026-02-31, 2025-02-29）です。メッセージ: Date "<date>" is not a valid ISO 8601 calendar date (YYYY-MM-DD)。data.date を含みます。

例

有効

---
date: 2026-05-01
---

うるう年の日付（YAML が文字列のまま保持するようクォート）:

---
date: '2024-02-29'
---

無効

Frontmatter	診断	理由
(`date` なし)	`missingDate`	フィールドが存在しない
`date: 2026-13-01`	`invalidDate`	13 月は存在しない
`date: 2026-02-31`	`invalidDate`	2 月に 31 日は存在しない
`date: 2025-02-29`	`invalidDate`	2025 年はうるう年ではない
`date: '2026-5-1'`	`invalidDate`	月/日がゼロ埋めされていない
`date: '26-05-01'`	`invalidDate`	2 桁の年
`date: 'today'`	`invalidDate`	日付文字列ではない

オプション

オプション	型	デフォルト	説明
`field`	`string`	`'date'`	読み取るメタデータキー（frontmatter または v2 本文リスト、キーの正規化あり）。`created` や `updated` などを使用するプロジェクトでは上書きします。

import { defineConfig } from 'madr-lint';

export default defineConfig({
  rules: {
    'madr/date-iso8601': ['error', { field: 'created' }],
  },
});

MADR バージョン互換性

バージョン	適用	備考
v2	はい	メタデータブリッジ経由で、本文リストの `- Date: 2026-05-01`
v3	はい	frontmatter の `date: ...`
v4	はい	frontmatter の `date: ...`

無効化する場合

異なる日付形式を使用するシステムから移行する場合は、madr/date-iso8601 を off にしてください。カスタムのメタデータキーを読み取るには、field を上書きすることを優先してください。

他のルールと同様、インラインコメントで抑制できます — ルールの抑制を参照してください。

madr/date-iso8601

チェック内容

例

有効

無効

オプション

MADR バージョン互換性

無効化する場合

ソース