屬性

屬性	類型	預設值	說明
`value`	`Date \| null`	—	選定的時間值 (僅使用時間部分)
`onChange`	`(date: Date \| null) => void`	—	值變更時的回呼
`time`	`TimeConfig`	—	時間面板設定
`locale`	`Partial<Locale>`	—	自訂語系設定
`displayFormat`	`string`	—	觸發器的自訂顯示格式
`placeholder`	`string`	—	觸發器的預留位置文字
`open`	`boolean`	—	受控的開啟狀態
`initialOpen`	`boolean`	`false`	初始開啟狀態 (非受控)
`onOpenChange`	`(open: boolean) => void`	—	開啟狀態變更時的回呼
`required`	`boolean`	`false`	禁用清除值
`inline`	`boolean`	`false`	內聯渲染，不使用觸發器/彈出視窗
`hideFooter`	`boolean`	—	隱藏操作區塊頁腳
`name`	`string`	—	用於表單提交的隱藏輸入框名稱

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;
}