DatePicker 日期选择器

用于选择或输入日期

基础用法

以日期为基本单位，基础的日期选择控件

[
  {
    type: "date",
    name: "date",
    text: "日期选择器"
  }
]

显示配置

禁用状态

通过 disabled 属性禁用日期选择器

[
  {
    type: "date",
    name: "date",
    text: "日期选择器",
    disabled: () => true
  }
]

显示配置

占位符

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

[
  {
    type: "date",
    name: "date",
    text: "日期选择器",
    placeholder: "请选择日期"
  }
]

显示配置

日期格式

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

默认情况下，组件的 format 默认值为 YYYY/MM/DD，valueFormat 默认值为 YYYY/MM/DD。以下为可用的格式化字串，以 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
x	JS时间戳	组件绑定值为number类型	1483326245000
[MM]	不需要格式化字符	使用方括号标识不需要格式化的字符 (如 [A] [MM])	MM

设置 valueFormat 为 timestamp，绑定值将返回时间戳格式

[
  {
    type: "date",
    name: "date",
    text: "日期选择器",
    format: "YYYY-MM-DD",
    valueFormat: "x"
  }
]

显示配置

Attributes

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

TypeScript 定义

interface DateConfig extends FormItem, Input {
  type: 'date';
  format?: 'YYYY-MM-dd HH:mm:ss' | string;
  valueFormat?: 'YYYY-MM-dd HH:mm:ss' | string;
}