DatePicker

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

說明：
開發(fā)前請熟悉鴻蒙開發(fā)指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
該組件從API Version 8開始支持。后續(xù)版本如有新增內容，則采用上角標單獨標記該內容的起始版本。

子組件

無

接口

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

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

參數(shù):

參數(shù)名	參數(shù)類型	必填	參數(shù)描述
start	Date	否	指定選擇器的起始日期。默認值：Date('1970-1-1')
end	Date	否	指定選擇器的結束日期。默認值：Date('2100-12-31')
selected	Date	否	設置選中項的日期。默認值：當前系統(tǒng)日期從API version 10開始，該參數(shù)支持[$$]雙向綁定變量。

異常情形說明:

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

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

選中日期會在起始日期與結束日期異常處理完成后再進行異常情形判斷處理

屬性

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

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

PickerTextStyle10+類型說明

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

事件

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

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

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