道具

支柱类型默认描述
value{ start: Date | null; end: Date | null }—Selected date range value
onChange(value: { start: Date | null; end: Date | null }) => void—Callback when value changes
presetsDateRangePreset[]—Predefined date range presets
maxDaysnumber—Maximum days allowed in range (inclusive)
minDaysnumber—Minimum days required in range (inclusive)
allowSingleDateInRangebooleantrue允许开始等于结束的范围
minDateDate—Minimum selectable date
maxDateDate—Maximum selectable date
localePartial<Locale>—Custom locale configuration
initialMonthDate—Initial displayed month
size"small" | "medium" | "large" | "x-large""medium"Component size
weekStartsOnWeekDay"sunday"一周的第一天
isDateUnavailable(date: Date) => boolean—Mark dates as disabled
displayFormatstring—Custom display format (e.g. "YYYY/MM/DD")
openboolean—Controlled open state
initialOpenboolean—Initial open state (uncontrolled)
onOpenChange(open: boolean) => void—Callback when open state changes
requiredbooleanfalse禁用清除值
showOutsideDaysbooleanfalse显示相邻月份的天数
highlightDatesDate[]—Dates to highlight
shouldCloseOnSelectbooleanfalse选择结束日期时自动确认
numberOfMonthsnumber2显示月数
captionLayout"buttons" | "dropdown""buttons"Caption navigation style
fromYearnumber—Start year for dropdown
toYearnumber—End year for dropdown
disablePastbooleanfalse禁用今天之前的日期
disableFuturebooleanfalse禁用今天之后的日期
inlinebooleanfalse内嵌显示日历（无弹出窗口）
namestring—Hidden input name for form submission (start date)
endNamestring—Hidden input name for end date (defaults to name-end)
placeholderstring—Trigger placeholder text
hideHeaderbooleanfalse隐藏导航标题
hideFooterbooleanfalse隐藏操作页脚

DateRangePreset

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