ダッシュボード

日付

日付フィールド

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

基本例 

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

プロパティ

プロパティ型必須デフォルト説明
namestringYes-フィールドの識別子
type"date"Yes-"date"を指定
labelstringNo-CMS上での表示名
notestringNo-編集者向けの補足メモ
requiredbooleanNo-必須フィールドかどうか
defaultstringNo-デフォルト値（"now"で現在日時）
includeTimebooleanNofalse時間入力を含むか

使用例

公開日（日付のみ） 

{
	"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"
}

現在日時をデフォルトに設定

default: "now"を指定すると、新規作成時に現在の日付/日時が自動的に設定されます。

{
	"name": "publishedAt",
	"type": "date",
	"label": "公開日時",
	"includeTime": true,
	"default": "now"
}
pit.createdAtで指定されたフィールドも同様に現在時刻が自動設定されますが、default: "now"はpit設定なしで使用できます。

pit.createdAtとの関係

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

{
	"fields": [
		{ "name": "title", "type": "text", "label": "タイトル" },
		{ "name": "publishedAt", "type": "date", "label": "公開日時", "includeTime": true }
	],
	"pit": {
		"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）で保存されます。

Docs