Props

Prop	타입	기본값	설명
`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의 name

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