DatePicker

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

說明：
開發(fā)前請(qǐng)熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
該組件從API Version 8開始支持。后續(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)日期從API version 10開始，該參數(shù)支持[$$]雙向綁定變量。

異常情形說明:

異常情形	對(duì)應(yīng)結(jié)果
起始日期晚于結(jié)束日期，選中日期未設(shè)置	起始日期、結(jié)束日期和選中日期都為默認(rèn)值
起始日期晚于結(jié)束日期，選中日期早于起始日期默認(rèn)值	起始日期、結(jié)束日期都為默認(rèn)值，選中日期為起始日期默認(rèn)值
起始日期晚于結(jié)束日期，選中日期晚于結(jié)束日期默認(rèn)值	起始日期、結(jié)束日期都為默認(rèn)值，選中日期為結(jié)束日期默認(rèn)值
起始日期晚于結(jié)束日期，選中日期在起始日期與結(jié)束日期默認(rèn)值范圍內(nèi)	起始日期、結(jié)束日期都為默認(rèn)值，選中日期為設(shè)置的值
選中日期早于起始日期	選中日期為起始日期
選中日期晚于結(jié)束日期	選中日期為結(jié)束日期
起始日期晚于當(dāng)前系統(tǒng)日期，選中日期未設(shè)置	選中日期為起始日期
結(jié)束日期早于當(dāng)前系統(tǒng)日期，選中日期未設(shè)置	選中日期為結(jié)束日期
日期格式不符合規(guī)范，如‘1999-13-32’	取默認(rèn)值
起始日期或結(jié)束日期早于系統(tǒng)有效范圍	起始日期或結(jié)束日期取系統(tǒng)有效范圍最早日期
起始日期或結(jié)束日期晚于系統(tǒng)有效范圍	起始日期或結(jié)束日期取系統(tǒng)有效范圍最晚日期

系統(tǒng)日期范圍：1900-1-31 ~ 2100-12-31

選中日期會(huì)在起始日期與結(jié)束日期異常處理完成后再進(jìn)行異常情形判斷處理

屬性

除支持[通用屬性]外，還支持以下屬性：

名稱	參數(shù)類型	描述
lunar	boolean	日期是否顯示農(nóng)歷。 - true：展示農(nóng)歷。 - false：不展示農(nóng)歷。默認(rèn)值：false
disappearTextStyle10+	[PickerTextStyle]	設(shè)置所有選項(xiàng)中最上和最下兩個(gè)選項(xiàng)的文本顏色、字號(hào)、字體粗細(xì)。默認(rèn)值： { color: '#ff182431', font: { size: '14fp', weight: FontWeight.Regular } }
textStyle10+	[PickerTextStyle]	設(shè)置所有選項(xiàng)中除了最上、最下及選中項(xiàng)以外的文本顏色、字號(hào)、字體粗細(xì)。默認(rèn)值： { color: '#ff182431', font: { size: '16fp', weight: FontWeight.Regular } }
selectedTextStyle10+	[PickerTextStyle]	設(shè)置選中項(xiàng)的文本顏色、字號(hào)、字體粗細(xì)。默認(rèn)值： { color: '#ff007dff', font: { size: '20vp', weight: FontWeight.Medium } }

PickerTextStyle10+類型說明

參數(shù)名	參數(shù)類型	必填	參數(shù)描述
color	[ResourceColor]	否	文本顏色。
font	[Font]	否	文本樣式，picker只支持字號(hào)、字體粗細(xì)的設(shè)置。

事件

除支持[通用事件]外，還支持以下事件：

名稱	功能描述
onDateChange(callback: (value: Date) => void)10+	選擇日期時(shí)觸發(fā)該事件。 Date：返回選中的時(shí)間，年月日為選中的日期，時(shí)分取決于當(dāng)前系統(tǒng)時(shí)間的時(shí)分，秒恒為00。`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`

搜狗高速瀏覽器截圖20240326151450.png

DatePickerResult對(duì)象說明

名稱	參數(shù)類型	描述
year	number	選中日期的年。
month	number	選中日期的月(0~11)，0表示1月，11表示12月。
day	number	選中日期的日。

審核編輯黃宇

聲明：本文內(nèi)容及配圖由入駐作者撰寫或者入駐合作網(wǎng)站授權(quán)轉(zhuǎn)載。文章觀點(diǎn)僅代表作者本人，不代表電子發(fā)燒友網(wǎng)立場(chǎng)。文章及其配圖僅供工程師學(xué)習(xí)之用，如有內(nèi)容侵權(quán)或者其他違規(guī)問題，請(qǐng)聯(lián)系本站處理。舉報(bào)投訴