tmagic-editor/docs/form-config/fields/datetime-picker.md

DateTimePicker 日期时间选择器

在同一个选择器里选择日期和时间

基础用法

<template #source>

通过设置 type: 'datetime' 使用日期时间选择器，可以同时选择日期和时间。

带占位符

<template #source>

通过 placeholder 属性设置输入框的占位文本。

禁用状态

<template #source>

通过 disabled 属性禁用日期时间选择器，支持布尔值或函数。

日期格式

使用 format 指定输入框的格式；使用 valueFormat 指定绑定值的格式。

默认情况下，组件接受并返回格式化后的字符串。以下为可用的格式化字串，以 UTC 2017年1月2日 03:04:05 为例：

:::warning 请注意大小写 :::

格式	含义	备注	举例
YYYY	年		2017
M	月	不补0	1
MM	月		01
D	日	不补0	2
DD	日		02
H	小时	24小时制；不补0	3
HH	小时	24小时制	03
h	小时	12小时制，须和 A 或 a 使用；不补0	3
hh	小时	12小时制，须和 A 或 a 使用	03
m	分钟	不补0	4
mm	分钟		04
s	秒	不补0	5
ss	秒		05
A	AM/PM	仅 format 可用，大写	AM
a	am/pm	仅 format 可用，小写	am
x	JS时间戳（毫秒）	仅 valueFormat 可用	1483326245000
X	Unix时间戳（秒）	仅 valueFormat 可用	1483326245

<template #source>

自定义格式化：显示格式为 YYYY-MM-DD HH:mm，绑定值格式为时间戳。

Attributes

参数	说明	类型	可选值	默认值
name	绑定值的字段名	string	—	—
text	表单标签	string	—	—
placeholder	输入框占位文本	string	—	—
disabled	是否禁用	boolean / FilterFunction	—	false
format	显示在输入框中的格式	string	见日期格式	YYYY/MM/DD HH:mm:ss
valueFormat	绑定值的格式	string	见日期格式	YYYY/MM/DD HH:mm:ss
defaultTime	选择日期后的默认时间值	Date	—	—
onChange	值变化时触发的函数	OnChangeHandler	—	—

::: details 查看 FilterFunction / OnChangeHandler 及关联类型定义 <<< @/../packages/form-schema/src/base.ts#FilterFunction{ts}

<<< @/../packages/form-schema/src/base.ts#OnChangeHandler{ts}

<<< @/../packages/form-schema/src/base.ts#OnChangeHandlerData{ts}

<<< @/../packages/form-schema/src/base.ts#ChangeRecord{ts}

<<< @/../packages/form-schema/src/base.ts#FormValue{ts} :::

配置类型

::: details 查看 DateTimeConfig 配置类型定义 <<< @/../packages/form-schema/src/base.ts#DateTimeConfig{ts}

<<< @/../packages/form-schema/src/base.ts#FormItem{ts}

<<< @/../packages/form-schema/src/base.ts#Input{ts}

:::