屬性

Prop	Type	Default	Description
`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`	—	用於表單提交的隱藏 input 名稱

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