DatePicker
日期選擇器組件,用于根據(jù)指定日期范圍創(chuàng)建日期滑動選擇器。
說明:
開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 :[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md
]
該組件從API Version 8開始支持。后續(xù)版本如有新增內(nèi)容,則采用上角標單獨標記該內(nèi)容的起始版本。
子組件
無
接口
DatePicker(options?: {start?: Date, end?: Date, selected?: Date})
根據(jù)指定范圍的Date創(chuàng)建可以選擇日期的滑動選擇器。
參數(shù):
參數(shù)名 | 參數(shù)類型 | 必填 | 參數(shù)描述 |
---|---|---|---|
start | Date | 否 | 指定選擇器的起始日期。 默認值:Date('1970-1-1') |
end | Date | 否 | 指定選擇器的結(jié)束日期。 默認值:Date('2100-12-31') |
selected | Date | 否 | 設(shè)置選中項的日期。 默認值:當前系統(tǒng)日期 從API version 10開始,該參數(shù)支持[$$]雙向綁定變量。 |
異常情形說明:
異常情形 | 對應(yīng)結(jié)果 |
---|---|
起始日期晚于結(jié)束日期,選中日期未設(shè)置 | 起始日期、結(jié)束日期和選中日期都為默認值 |
起始日期晚于結(jié)束日期,選中日期早于起始日期默認值 | 起始日期、結(jié)束日期都為默認值,選中日期為起始日期默認值 |
起始日期晚于結(jié)束日期,選中日期晚于結(jié)束日期默認值 | 起始日期、結(jié)束日期都為默認值,選中日期為結(jié)束日期默認值 |
起始日期晚于結(jié)束日期,選中日期在起始日期與結(jié)束日期默認值范圍內(nèi) | 起始日期、結(jié)束日期都為默認值,選中日期為設(shè)置的值 |
選中日期早于起始日期 | 選中日期為起始日期 |
選中日期晚于結(jié)束日期 | 選中日期為結(jié)束日期 |
起始日期晚于當前系統(tǒng)日期,選中日期未設(shè)置 | 選中日期為起始日期 |
結(jié)束日期早于當前系統(tǒng)日期,選中日期未設(shè)置 | 選中日期為結(jié)束日期 |
日期格式不符合規(guī)范,如‘1999-13-32’ | 取默認值 |
起始日期或結(jié)束日期早于系統(tǒng)有效范圍 | 起始日期或結(jié)束日期取系統(tǒng)有效范圍最早日期 |
起始日期或結(jié)束日期晚于系統(tǒng)有效范圍 | 起始日期或結(jié)束日期取系統(tǒng)有效范圍最晚日期 |
系統(tǒng)日期范圍:1900-1-31 ~ 2100-12-31
選中日期會在起始日期與結(jié)束日期異常處理完成后再進行異常情形判斷處理
屬性
除支持[通用屬性]外,還支持以下屬性:
名稱 | 參數(shù)類型 | 描述 |
---|---|---|
lunar | boolean | 日期是否顯示農(nóng)歷。 - true:展示農(nóng)歷。 - false:不展示農(nóng)歷。 默認值:false |
disappearTextStyle10+ | [PickerTextStyle] | 設(shè)置所有選項中最上和最下兩個選項的文本顏色、字號、字體粗細。 默認值: { color: '#ff182431', font: { size: '14fp', weight: FontWeight.Regular } } |
textStyle10+ | [PickerTextStyle] | 設(shè)置所有選項中除了最上、最下及選中項以外的文本顏色、字號、字體粗細。 默認值: { color: '#ff182431', font: { size: '16fp', weight: FontWeight.Regular } } |
selectedTextStyle10+ | [PickerTextStyle] | 設(shè)置選中項的文本顏色、字號、字體粗細。 默認值: { color: '#ff007dff', font: { size: '20vp', weight: FontWeight.Medium } } |
PickerTextStyle10+類型說明
參數(shù)名 | 參數(shù)類型 | 必填 | 參數(shù)描述 |
---|---|---|---|
color | [ResourceColor] | 否 | 文本顏色。 |
font | [Font] | 否 | 文本樣式,picker只支持字號、字體粗細的設(shè)置。 |
事件
除支持[通用事件]外,還支持以下事件:
名稱 | 功能描述 |
---|---|
onDateChange(callback: (value: Date) => void)10+ | 選擇日期時觸發(fā)該事件。 Date:返回選中的時間,年月日為選中的日期,時分取決于當前系統(tǒng)時間的時分,秒恒為00。HarmonyOS與OpenHarmony鴻蒙文檔籽料:mau123789是v直接拿 |
DatePickerResult對象說明
名稱 | 參數(shù)類型 | 描述 |
---|---|---|
year | number | 選中日期的年。 |
month | number | 選中日期的月(0~11),0表示1月,11表示12月。 |
day | number | 選中日期的日。 |
審核編輯 黃宇
-
鴻蒙
+關(guān)注
關(guān)注
60文章
2623瀏覽量
44077
發(fā)布評論請先 登錄
【HarmonyOS 5】金融應(yīng)用開發(fā)鴻蒙組件實踐

【 HarmonyOS 5 入門系列 】鴻蒙HarmonyOS示例項目講解

UI開發(fā)概述
什么是ArkTS?
使用DevEcoStudio 開發(fā)、編譯鴻蒙 NEXT_APP 以及使用中文插件
Kuikly鴻蒙版正式開源 —— 揭秘卓越性能適配之旅
KaihongOS操作系統(tǒng):ArkTS語言基礎(chǔ)
開源啦?。?!基于鴻蒙ArkTS封裝的圖表組件《McCharts》,大家快來一起共創(chuàng)
ArkTS開發(fā)指南優(yōu)化上新

評論