时间日期选择器

时间日期选择器用于允许用户输入时间信息,比如入职日期、生日等。你也可以用时间选择器与其它组件组合,比如实现按时间过滤等功能。

date-picker-example

标签文字

时间选择器上的标签文字属性可以标明此时间选择器的作用,用于提示用户。常见的标签有“生日”,“入职日期”等。

默认日期

在用户没有输入时,你可以在时间选择器内用一个默认日期,用户选择后这个默认日期将会被替换为用户的选择。

时间日期格式

你可以将用户选择的时间显示为任意格式,转换过后的时间将会出现在该组件上的 formattedDate 也即“转换后日期“上。

比如说如果你在 dateTime1 这个组件中,用 YYYY-MM-DD 来表示 2022-01-02 这样的格式。在转换后,dateTime1.formattedDate 将是一个字符串,值为 2022-01-02

时间选择器支持以下格式参数

YY                 |  两位数的年份
YYYY               |  四位数的年份
M                  |  月份,从 1 开始
MM                 |  月份,两位数
DD                 |  月份里的一天,两位数
D                  |  月份里的一天
H                  |  小时
HH	               |  小时,两位数
h                  |  小时, 12 小时制
hh	               |  小时, 12 小时制, 两位数
m	                 |  分钟
mm	               |  分钟,两位数
s	                 |  秒
ss	               |  秒 两位数

同时我们列出一些常见的时间格式,请根据需要选择

YYYY-MM-DD HH:mm   | 1988-08-18 00:00
YYYY/MM/DD         | 1988/08/18
YY-MM-DD           | 88-08-18
YYYY年-MM月-DD日    | 1988年-08月-18日

如果需要更灵活的时间格式,请使用 selectedDate 直接进行日期转换。

selectedDate

在用户选择一个日期后,选择日期的 ISO-8601 格式的日期字符串将会出现在 selectedDate 中。

如果你不熟悉 ISO-8601 格式,请将它想作一个国际标准的日期格式,几乎所有的日期转换算法和库均使用 ISO-8601 标准,这也意味着如果你需要一个标准的日期来做更多的日期操作或格式转换,可以使用 selectedDate 属性

formattedDate

formattedDate 属性是将用户选择的日期时间,换你指定的时间格式进行格式化后得到的字符数组。如果你需要特别的格式显示,那么指定日期格式后,展示 formattedDate 即可。如果你的数据库中需要存入特定的日期字符串,也可以调整好组件日期格式后,存入这个属性中的值。

举个例子,你的数据库中需要存入类似 2022年02月13日 这样的字符串作为日期,那么你只需要指定日期选择组件的格式为 YYYY年MM月DD日,在你的用户选择日期后存入 dateTime1.formattedDate 即可。