stdf/docs/mds/components/timePicker/guide.md

使用场景

TimePicker 组件用于选择时间，支持单列选择和多列选择。默认参数选择前后十年的时间，默认初始时选中当前时间。

时间类型

TimePicker 组件通过传入的 type 参数来决定选择的时间类型，由 YYYY MM DD hh mm ss 组合而来，目前共支持以下 13 种，不在此列出的类型将使用默认的 'YYYYMMDDhhmmss' 类型。

• YYYY：年
• MM：月
• DD：日
• hh：时
• mm：分
• ss：秒
• YYYYMM：年月
• hhmm：时分
• mmss：分秒
• YYYYMMDD：年月日
• hhmmss：时分秒
• YYYYMMDDhh：年月日时
• YYYYMMDDhhmm：年月日时分
• YYYYMMDDhhmmss：年月日时分秒

单列样式

无论是年、月、日、时、分、秒的列数据，都可以通过传入对应的 Props 来自定义三种样式，分别是：flex、showRow、align。具体使用请参考示例。

限定选择区间

因为每月的天数会根据当前年与月动态更新，所以除了天数列数据，其余列数据都可以通过传入对应的 Range 来限定选择区间，由对应数据组成的数组。但请保证传入的区间数组为两项，每一项为 Number 类型，且第一项小于第二项，否则将使用默认的区间。具体使用请参考示例。

初始选定值

每列数据初始化时默认会选择当前时间，同时也支持传入对应的初始值来自定义初始选定值。但需要注意的是传入的初始值类型为字符类型，且保证月、日、时、分、秒的初始值不足两位时补齐至两位。具体使用请参考示例。

分秒步长

考虑实际用途，支持对分和秒数据进行步长设置，步长默认为 1，即每次选择都会增加 1 分或 1 秒。具体使用请参考示例。

outFormat

默认情况下，TimePicker 组件的 outFormat 由传入的 type 按照【年月日之间用 - 连接，时分秒之间用 : 连接，两者之间用空格连接】的规则生成，比如转入 'YYYYMMDD' 对应 YYYY-MM-DD，'YYYYMMDDhh' 对应 YYYY-MM-DD hh，'hhmmss' 对应 hh:mm:ss 等。当然也可以自定义输出格式。具体使用请参考示例。

需要注意的是，onconfirm 返回的第二个参数是选择的时间对象，方便开发者自行处理。

说明

TimePicker 是在 Popup 基础上封装的，通过预先定义一些 Popup 的 Props 实现，因此可以通过传入 Popup 的属性来实现不同的效果。比如示例中通过设置 popup 的 radius 改变圆角风格。