Props

Prop	Type	Default	説明
`value`	`Date \| null`	—	選択された日時
`onChange`	`(dateTime: Date \| null) => void`	—	値が変更されたときのコールバック
`time`	`TimeConfig`	—	タイムパネルの設定
`minDate`	`Date`	—	選択可能な最小日付
`maxDate`	`Date`	—	選択可能な最大日付
`locale`	`Partial<Locale>`	—	カスタムロケールの設定
`initialMonth`	`Date`	—	最初に表示される月
`size`	`"small" \| "medium" \| "large" \| "x-large"`	`"medium"`	コンポーネントのサイズ
`weekStartsOn`	`WeekDay`	`"sunday"`	週の始まりの曜日
`isDateUnavailable`	`(date: Date) => boolean`	—	日付を無効としてマークする
`displayFormat`	`string`	—	カスタム表示フォーマット
`open`	`boolean`	—	開閉状態（制御）
`initialOpen`	`boolean`	—	初期の開閉状態（非制御）
`onOpenChange`	`(open: boolean) => void`	—	開閉状態が変更されたときのコールバック
`required`	`boolean`	`false`	値のクリアを無効化
`showOutsideDays`	`boolean`	`false`	隣接する月の日付を表示
`highlightDates`	`Date[]`	—	ハイライトする日付
`shouldCloseOnSelect`	`boolean`	`false`	プリセットクリック時に自動確定
`numberOfMonths`	`number`	`1`	表示する月数
`captionLayout`	`"buttons" \| "dropdown"`	`"buttons"`	キャプションのナビゲーションスタイル
`fromYear`	`number`	—	ドロップダウンの開始年
`toYear`	`number`	—	ドロップダウンの終了年
`disablePast`	`boolean`	`false`	今日より前の日付を無効化
`disableFuture`	`boolean`	`false`	今日より後の日付を無効化
`inline`	`boolean`	`false`	カレンダーをインラインで表示（ポップアップなし）
`name`	`string`	—	フォーム送信用の隠しinputのname
`placeholder`	`string`	—	トリガーのプレースホルダーテキスト
`hideHeader`	`boolean`	`false`	ナビゲーションヘッダーを非表示
`hideFooter`	`boolean`	`false`	アクションフッターを非表示

TimeConfig

interface TimeConfig {
  /** 時間表示の精度。デフォルトは "minute" です。 */
  precision?: "hour" | "minute" | "second";
  /** 12時間形式または24時間形式。デフォルトは "24" です。 */
  hourFormat?: "12" | "24";
  /** 分の増分ステップ。デフォルトは 5 です。 */
  minuteStep?: 1 | 2 | 3 | 5 | 10 | 15 | 20 | 30;
  /** 秒の増分ステップ。デフォルトは 1 です。 */
  secondStep?: 1 | 2 | 3 | 5 | 10 | 15 | 20 | 30;
  /** 各スクロールホイール項目の高さ (px)。デフォルトは 32 です。 */
  itemHeight?: number;
}