DatePicker
日期选择器组件,用于根据指定日期范围创建日期滑动选择器。
说明:
开发前请熟悉鸿蒙开发指导文档 :[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md
]
该组件从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
子组件
无
接口
DatePicker(options?: {start?: Date, end?: Date, selected?: Date})
根据指定范围的Date创建可以选择日期的滑动选择器。
参数:
参数名 | 参数类型 | 必填 | 参数描述 |
---|---|---|---|
start | Date | 否 | 指定选择器的起始日期。 默认值:Date('1970-1-1') |
end | Date | 否 | 指定选择器的结束日期。 默认值:Date('2100-12-31') |
selected | Date | 否 | 设置选中项的日期。 默认值:当前系统日期 从API version 10开始,该参数支持[$$]双向绑定变量。 |
异常情形说明:
异常情形 | 对应结果 |
---|---|
起始日期晚于结束日期,选中日期未设置 | 起始日期、结束日期和选中日期都为默认值 |
起始日期晚于结束日期,选中日期早于起始日期默认值 | 起始日期、结束日期都为默认值,选中日期为起始日期默认值 |
起始日期晚于结束日期,选中日期晚于结束日期默认值 | 起始日期、结束日期都为默认值,选中日期为结束日期默认值 |
起始日期晚于结束日期,选中日期在起始日期与结束日期默认值范围内 | 起始日期、结束日期都为默认值,选中日期为设置的值 |
选中日期早于起始日期 | 选中日期为起始日期 |
选中日期晚于结束日期 | 选中日期为结束日期 |
起始日期晚于当前系统日期,选中日期未设置 | 选中日期为起始日期 |
结束日期早于当前系统日期,选中日期未设置 | 选中日期为结束日期 |
日期格式不符合规范,如‘1999-13-32’ | 取默认值 |
起始日期或结束日期早于系统有效范围 | 起始日期或结束日期取系统有效范围最早日期 |
起始日期或结束日期晚于系统有效范围 | 起始日期或结束日期取系统有效范围最晚日期 |
系统日期范围:1900-1-31 ~ 2100-12-31
选中日期会在起始日期与结束日期异常处理完成后再进行异常情形判断处理
属性
除支持[通用属性]外,还支持以下属性:
名称 | 参数类型 | 描述 |
---|---|---|
lunar | boolean | 日期是否显示农历。 - true:展示农历。 - false:不展示农历。 默认值: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+类型说明
参数名 | 参数类型 | 必填 | 参数描述 |
---|---|---|---|
color | [ResourceColor] | 否 | 文本颜色。 |
font | [Font] | 否 | 文本样式,picker只支持字号、字体粗细的设置。 |
事件
除支持[通用事件]外,还支持以下事件:
名称 | 功能描述 |
---|---|
onDateChange(callback: (value: Date) => void)10+ | 选择日期时触发该事件。 Date:返回选中的时间,年月日为选中的日期,时分取决于当前系统时间的时分,秒恒为00。HarmonyOS与OpenHarmony鸿蒙文档籽料:mau123789是v直接拿 |
DatePickerResult对象说明
名称 | 参数类型 | 描述 |
---|---|---|
year | number | 选中日期的年。 |
month | number | 选中日期的月(0~11),0表示1月,11表示12月。 |
day | number | 选中日期的日。 |
审核编辑 黄宇
声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表德赢Vwin官网
网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。
举报投诉
-
鸿蒙
+关注
关注
57文章
2339浏览量
42804
发布评论请先 登录
相关推荐
鸿蒙ArkTS声明式组件:PatternLock
图案密码锁组件,以九宫格图案的方式输入密码,用于密码验证场景。手指在PatternLock组件区域按下时开始进入输入状态,手指离开屏幕时结束输入状态完成密码输入。
评论