date

日付入力用フィールドです。includeTime: trueで時間も入力可能になります。

基本例

{
  "name": "publishDate",
  "type": "date",
  "label": "公開日"
}

プロパティ

プロパティ	型	必須	デフォルト	説明
`name`	`string`	Yes	-	フィールドの識別子
`type`	`"date"`	Yes	-	`"date"`を指定
`label`	`string`	No	-	CMS上での表示名
`note`	`string`	No	-	編集者向けの補足メモ
`required`	`boolean`	No	-	必須フィールドかどうか
`default`	`string`	No	-	デフォルト値
`includeTime`	`boolean`	No	`false`	時間入力を含むか

使用例

公開日（日付のみ）

{
  "name": "publishDate",
  "type": "date",
  "label": "公開日",
  "required": true
}

公開日時（時間を含む）

{
  "name": "publishedAt",
  "type": "date",
  "label": "公開日時",
  "includeTime": true
}

イベント日

{
  "name": "eventDate",
  "type": "date",
  "label": "イベント日",
  "required": true,
  "note": "イベントの開催日を選択してください"
}

期限

{
  "name": "deadline",
  "type": "date",
  "label": "締め切り",
  "includeTime": true,
  "note": "締め切り日時を設定してください"
}

デフォルト値付き

{
  "name": "startDate",
  "type": "date",
  "label": "開始日",
  "default": "2024-01-01"
}

{
  "name": "startDateTime",
  "type": "date",
  "label": "開始日時",
  "includeTime": true,
  "default": "2024-01-01T09:00:00Z"
}

pico.createdAtとの関係

pico.createdAtで指定されたdateフィールドは、編集画面で特別な扱いを受けます。

{
  "fields": [
    { "name": "title", "type": "string", "label": "タイトル" },
    { "name": "publishedAt", "type": "date", "label": "公開日時", "includeTime": true }
  ],
  "pico": {
    "createdAt": "publishedAt"
  }
}

通常のフィールド一覧には表示されない
タイトルの下に日時として小さく表示される
新規作成時には現在時刻が自動的に設定される
ホバーすると編集アイコンが表示され、クリックで編集可能

保存形式

日付のみ（includeTime: false）:

---
publishDate: "2024-01-15"
---

日時（includeTime: true）:

---
publishedAt: "2024-01-15T10:30:00Z"
---

日付はYYYY-MM-DD形式、日時はISO 8601形式（YYYY-MM-DDTHH:mm:ssZ）で保存されます。