Props

PropTypeデフォルト説明
value{ start: Date | null; end: Date | null }—選択された日時範囲の値
onChange(value: { start: Date | null; end: Date | null }) => void—値が変更されたときのコールバック
timeTimeConfig—タイムパネルの設定（開始と終了の両方に適用）
presetsDateRangePreset[]—事前定義された日付範囲のプリセット
maxDaysnumber—範囲内で許可される最大日数（その日を含む）
minDaysnumber—範囲内で必要な最小日数（その日を含む）
allowSingleDateInRangebooleantrue開始日と終了日が同じ範囲を許可
minDateDate—選択可能な最小日付
maxDateDate—選択可能な最大日付
localePartial<Locale>—カスタムロケールの設定
initialMonthDate—初期表示月
size"small" | "medium" | "large" | "x-large""medium"コンポーネントのサイズ
weekStartsOnWeekDay"sunday"週の最初の日
isDateUnavailable(date: Date) => boolean—日付を無効としてマーク
displayFormatstring—カスタム表示フォーマット
openboolean—制御されたオープン状態
initialOpenboolean—初期オープン状態（非制御）
onOpenChange(open: boolean) => void—オープン状態が変更されたときのコールバック
requiredbooleanfalse値のクリアを無効化
showOutsideDaysbooleanfalse隣接する月の日付を表示
highlightDatesDate[]—ハイライトする日付
shouldCloseOnSelectbooleanfalseプリセットクリック時に自動確定
numberOfMonthsnumber2表示する月数
captionLayout"buttons" | "dropdown""buttons"キャプションのナビゲーションスタイル
fromYearnumber—ドロップダウンの開始年
toYearnumber—ドロップダウンの終了年
disablePastbooleanfalse今日より前の日付を無効化
disableFuturebooleanfalse今日より後の日付を無効化
inlinebooleanfalseカレンダーをインラインで表示（ポップアップなし）
namestring—フォーム送信用の非表示inputの名前（開始日時）
endNamestring—終了日時用の非表示inputの名前（デフォルトは name-end）
placeholderstring—トリガーのプレースホルダーテキスト
hideHeaderbooleanfalseナビゲーションヘッダーを非表示
hideFooterbooleanfalseアクションフッターを非表示

TimeConfig

interface TimeConfig {
  /** Time display precision. Defaults to "minute". */
  precision?: "hour" | "minute" | "second";
  /** 12-hour or 24-hour format. Defaults to "24". */
  hourFormat?: "12" | "24";
  /** Minute increment step. Defaults to 5. */
  minuteStep?: 1 | 2 | 3 | 5 | 10 | 15 | 20 | 30;
  /** Second increment step. Defaults to 1. */
  secondStep?: 1 | 2 | 3 | 5 | 10 | 15 | 20 | 30;
  /** Height (in px) of each scroll wheel item. Defaults to 32. */
  itemHeight?: number;
}

DateRangePreset

interface DateRangePreset {
  label: string;
  value: { start: Date; end: Date } | (() => { start: Date; end: Date });
}