import{ax as l,al as c,z as m,A as n,B as d,R as a,b2 as i,O as e,J as o}from"./chunks/framework.DkLJC2NO.js";const T=JSON.parse('{"title":"DateTimePicker 日期时间选择器","description":"","frontmatter":{},"headers":[],"relativePath":"form-config/fields/datetime-picker.md","filePath":"form-config/fields/datetime-picker.md"}'),s={name:"form-config/fields/datetime-picker.md"};function h(p,t,f,b,u,k){const r=c("demo-block");return n(),m("div",null,[t[4]||(t[4]=d("h1",{id:"datetimepicker-日期时间选择器",tabindex:"-1"},[e("DateTimePicker 日期时间选择器 "),d("a",{class:"header-anchor",href:"#datetimepicker-日期时间选择器","aria-label":'Permalink to "DateTimePicker 日期时间选择器"'},"")],-1)),t[5]||(t[5]=d("p",null,"在同一个选择器里选择日期和时间",-1)),t[6]||(t[6]=d("h2",{id:"基础用法",tabindex:"-1"},[e("基础用法 "),d("a",{class:"header-anchor",href:"#基础用法","aria-label":'Permalink to "基础用法"'},"")],-1)),a(r,{type:"form",config:[{type:"datetime",name:"dateTime",text:"日期时间选择器"}]},{source:o(()=>[...t[0]||(t[0]=[d("p",null,[e(" 通过设置 "),d("code",null,"type: 'datetime'"),e(" 使用日期时间选择器,可以同时选择日期和时间。 ")],-1)])]),_:1}),t[7]||(t[7]=d("h2",{id:"带占位符",tabindex:"-1"},[e("带占位符 "),d("a",{class:"header-anchor",href:"#带占位符","aria-label":'Permalink to "带占位符"'},"")],-1)),a(r,{type:"form",config:[{type:"datetime",name:"dateTime",text:"日期时间选择器",placeholder:"请选择日期时间"}]},{source:o(()=>[...t[1]||(t[1]=[d("p",null,[e(" 通过 "),d("code",null,"placeholder"),e(" 属性设置输入框的占位文本。 ")],-1)])]),_:1}),t[8]||(t[8]=d("h2",{id:"禁用状态",tabindex:"-1"},[e("禁用状态 "),d("a",{class:"header-anchor",href:"#禁用状态","aria-label":'Permalink to "禁用状态"'},"")],-1)),a(r,{type:"form",config:[{type:"datetime",name:"dateTime",text:"日期时间选择器",disabled:()=>!0}]},{source:o(()=>[...t[2]||(t[2]=[d("p",null,[e(" 通过 "),d("code",null,"disabled"),e(" 属性禁用日期时间选择器,支持布尔值或函数。 ")],-1)])]),_:1}),t[9]||(t[9]=i('
使用 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 |
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| 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 | — | — |