1# DatePicker 2 3选择日期的滑动选择器组件。 4 5> **说明：** 6> 7> 该组件从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 8 9## 权限列表 10 11无 12 13## 子组件 14 15无 16 17## 接口 18 19DatePicker(options?: {start?: Date, end?: Date, selected?: Date}) 20 21根据指定范围的Date创建可以选择日期的滑动选择器。 22 23**参数:** 24 25| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | 26| -------- | ---- | ---- | ------------------ | ----------- | 27| start | Date | 否 | Date('1970-1-1') | 指定选择器的起始日期。 | 28| end | Date | 否 | Date('2100-12-31') | 指定选择器的结束日期。 | 29| selected | Date | 否 | 当前系统日期 | 设置选中项的日期。 | 30 31## 属性 32 33| 名称 | 参数类型 | 默认值 | 描述 | 34| ----- | ------- | ----- | ---------------------------------------- | 35| lunar | boolean | false | 日期是否显示农历。<br/>- true：展示农历。<br/>- false：不展示农历。 | 36 37## 事件 38 39| 名称 | 功能描述 | 40| ---------------------------------------- | ----------- | 41| onChange(callback: (value: DatePickerResult) => void) | 选择日期时触发该事件。 | 42 43### DatePickerResult对象说明 44| 名称 | 参数类型 | 描述 | 45| ----- | ------ | --------------------------- | 46| year | number | 选中日期的年。 | 47| month | number | 选中日期的月(0~11)，0表示1月，11表示12月。 | 48| day | number | 选中日期的日。 | 49 50 51## 示例 52 53 54### 日期选择器（显示农历） 55 56```ts 57// xxx.ets 58@Entry 59@Component 60struct DatePickerExample01 { 61 private selectedDate: Date = new Date('2021-08-08') 62 63 build() { 64 Column() { 65 DatePicker({ 66 start: new Date('1970-1-1'), 67 end: new Date('2100-1-1'), 68 selected: this.selectedDate, 69 }) 70 .lunar(true) 71 .onChange((date: DatePickerResult) => { 72 console.info('select current date is: ' + JSON.stringify(date)) 73 }) 74 }.width('100%') 75 } 76} 77``` 78 79 80 81 82### 日期选择器（不显示农历） 83 84```ts 85// xxx.ets 86@Entry 87@Component 88struct DatePickerExample02 { 89 private selectedDate: Date = new Date('2021-08-08') 90 91 build() { 92 Column() { 93 DatePicker({ 94 start: new Date('1970-1-1'), 95 end: new Date('2100-1-1'), 96 selected: this.selectedDate, 97 }) 98 .lunar(false) 99 .onChange((date: DatePickerResult) => { 100 console.info('select current date is: ' + JSON.stringify(date)) 101 }) 102 }.width('100%') 103 } 104} 105``` 106 107 108 109
