DatePicker 日期选择器

用于接收日期和时间类型的容器。

何时使用

需要将某一个日期或时间录入到系统中时

需要将某一个时间段或任一个时间周期录入到系统中时

使用示例

Props

| 参数 | 说明 | 类型 | 可选值 | 默认值 | | ----------------- | --------------------------------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | | 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[] | - | - |

CHANGELOG

| 参数 | 变更类型 | 变更内容 | 解决的问题 | | ------------ | ------ | ---------------- | ----------------------------- | | disabledDate | update | 函数增加 view 参数 | 解决无法得知当前正在使用哪个视图，该如何确定禁用数据的问题 | | weekOffset | update | 变更其功能含义，只负责周计算方式 | 解决现在周计算方式与语言绑定的问题 |