用于接收日期和时间类型的容器。
需要将某一个日期或时间录入到系统中时
需要将某一个时间段或任一个时间周期录入到系统中时
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
type | 选择器类型 | string | date 普通日期 daterange 日期范围 year 年份 month 月份 week 周 weekrange 周范围 timeperiod 时间段(1.5 新增) yearrange 年范围(2.13 新增) monthrange 月范围(2.13 新增) |
date |
defaultValue | 默认显示的日期 | Date | string | number| DateRange | undefined | null | - | null |
value | 日期 | Date | string | number| DateRange | undefined | null | - | null |
width | 输入框宽度 | number | - | auto |
minDate | 最小日期 | Date | null | null |
maxDate | 最大日期 | Date | null | null |
disabled | 是否禁用输入框 | boolean | true | false | false |
bordered | 是否有边框 | boolean | true | false | true |
inputReadOnly | 设置输入框为只读 | boolean | true | false | false |
disabledDate | 不可选择的日期(返回true为不可选) | (currentDate: Date) => boolean | - | () => false |
min | 最小日期 | Date | null | null |
max | 最大日期 | Date | null | null |
clearable | 是否可以清空 | boolean | true | false | true |
showTime | 是否在日期选择器中显示时间选择器,在使用时请注意 format 的设置 | boolean | true | false | false |
timeInterval | 时间段的间隔,以分钟为单位 | number | 1 ~ 1440 分钟 | 240 |
format | 展示的日期格式,配置参考 moment.js | string | - | - |
shortcuts | 快捷面板 | string[] | { title: string,range: (Date | number)[]}[] | 近一周, 近一月, 近三月, 近一年 | null |
weekOffset | 周起始,默认周日做为第一列(3.3.0版本后,优化为根据中英文自动设置周起始) | number | 0 | 1 | 0 |
placeholder | 自定义占位符(数组用于范围日期) | string | string[] | - | - |
altCalendar | 自定义日期中历法展示信息 | CalendarItem | - | 农历 & 假日 |
altCalendarPreset | 预置历法信息(支持中国农历和印度节假日) | string | 'zh-CN' | 'id-ID' | 'zh-CN' |
dateMarkRender | 自定义日期的右上角标记 | (currentDate: Date, today: Date) => React.ReactNode | - | - |
dateMarkPreset | 预置日期的右上角标记(休 | 班) | string | 'zh-CN' | 'zh-CN' |
overlayClassName | 下拉根元素的类名称 (3.0 新增) | string | - | - |
disabledHours | 禁止选择的小时,仅在 showTime 开启时生效 | (() => number[]) | number[] | - | - |
disabledMinutes | 禁止选择的分钟,仅在 showTime 开启时生效 | ((selectedHour: number) => number[]) | number[] | - | - |
disabledSeconds | 禁止选择的秒数,仅在 showTime 开启时生效 | ((selectedHour: number, selectedMinute: number) => number[]) | number[] | - | - |
参数 | 变更类型 | 变更内容 | 解决的问题 |
---|---|---|---|
disabledDate | update | 函数增加 view 参数 | 解决无法得知当前正在使用哪个视图,该如何确定禁用数据的问题 |
weekOffset | update | 变更其功能含义,只负责周计算方式 | 解决现在周计算方式与语言绑定的问题 |