日期選擇器組件

2024-01-22 17:08 更新

日期選擇器組件,用于根據(jù)指定日期范圍創(chuàng)建日期滑動(dòng)選擇器。

說(shuō)明

該組件從API Version 8開(kāi)始支持。后續(xù)版本如有新增內(nèi)容,則采用上角標(biāo)單獨(dú)標(biāo)記該內(nèi)容的起始版本。

子組件

無(wú)

接口

DatePicker(options?: {start?: Date, end?: Date, selected?: Date})

根據(jù)指定范圍的Date創(chuàng)建可以選擇日期的滑動(dòng)選擇器。

參數(shù):

參數(shù)名

參數(shù)類型

必填

參數(shù)描述

start

Date

指定選擇器的起始日期。

默認(rèn)值:Date('1970-1-1')

end

Date

指定選擇器的結(jié)束日期。

默認(rèn)值:Date('2100-12-31')

selected

Date

設(shè)置選中項(xiàng)的日期。

默認(rèn)值:當(dāng)前系統(tǒng)日期

屬性

除支持通用屬性外,還支持以下屬性:

名稱

參數(shù)類型

描述

lunar

boolean

日期是否顯示農(nóng)歷。

- true:展示農(nóng)歷。

- false:不展示農(nóng)歷。

默認(rèn)值:false

事件

除支持通用事件外,還支持以下事件:

名稱

功能描述

onChange(callback: (value: DatePickerResult) => void)

選擇日期時(shí)觸發(fā)該事件。

DatePickerResult對(duì)象說(shuō)明

名稱

參數(shù)類型

描述

year

number

選中日期的年。

month

number

選中日期的月(0~11),0表示1月,11表示12月。

day

number

選中日期的日。

示例

  1. // xxx.ets
  2. @Entry
  3. @Component
  4. struct DatePickerExample {
  5. @State isLunar: boolean = false
  6. private selectedDate: Date = new Date('2021-08-08')
  7. build() {
  8. Column() {
  9. Button('切換公歷農(nóng)歷')
  10. .margin({ top: 30, bottom: 30 })
  11. .onClick(() => {
  12. this.isLunar = !this.isLunar
  13. })
  14. DatePicker({
  15. start: new Date('1970-1-1'),
  16. end: new Date('2100-1-1'),
  17. selected: this.selectedDate
  18. })
  19. .lunar(this.isLunar)
  20. .onChange((value: DatePickerResult) => {
  21. this.selectedDate.setFullYear(value.year, value.month, value.day)
  22. console.info('select current date is: ' + JSON.stringify(value))
  23. })
  24. }.width('100%')
  25. }
  26. }

以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)