import{aw as i,ag as n,y as s,z as l,A as d,P as r,b0 as c,L as o,H as a}from"./chunks/framework.BCBheFgR.js";const _=JSON.parse('{"title":"DatePicker 日期选择器","description":"","frontmatter":{},"headers":[],"relativePath":"form-config/fields/date-picker.md","filePath":"form-config/fields/date-picker.md"}'),m={name:"form-config/fields/date-picker.md"};function p(h,t,b,f,u,g){const e=n("demo-block");return l(),s("div",null,[t[3]||(t[3]=d("h1",{id:"datepicker-日期选择器",tabindex:"-1"},[o("DatePicker 日期选择器 "),d("a",{class:"header-anchor",href:"#datepicker-日期选择器","aria-label":'Permalink to "DatePicker 日期选择器"'},"")],-1)),t[4]||(t[4]=d("p",null,"用于选择或输入日期",-1)),t[5]||(t[5]=d("h2",{id:"基础用法",tabindex:"-1"},[o("基础用法 "),d("a",{class:"header-anchor",href:"#基础用法","aria-label":'Permalink to "基础用法"'},"")],-1)),r(e,{type:"form",config:[{type:"date",name:"date",text:"日期选择器"}]},{source:a(()=>t[0]||(t[0]=[d("p",null," 在开启多选模式后,默认情况下会展示所有已选中的选项的Tag ",-1)])),_:1}),t[6]||(t[6]=d("h2",{id:"禁用状态",tabindex:"-1"},[o("禁用状态 "),d("a",{class:"header-anchor",href:"#禁用状态","aria-label":'Permalink to "禁用状态"'},"")],-1)),r(e,{type:"form",config:[{type:"date",name:"date",text:"日期选择器",disabled:()=>!0}]},{source:a(()=>t[1]||(t[1]=[d("p",null," 在开启多选模式后,默认情况下会展示所有已选中的选项的Tag ",-1)])),_:1}),t[7]||(t[7]=c(' ## 日期格式
使用format
指定输入框的格式;使用valueFormat
指定绑定值的格式。
默认情况下,组件接受并返回Date
对象。以下为可用的格式化字串,以 UTC 2017年1月2日 03:04:05 为例:
WARNING
请注意大小写
格式 | 含义 | 备注 | 举例 |
---|---|---|---|
yyyy | 年 | 2017 | |
M | 月 | 不补0 | 1 |
MM | 月 | 01 | |
W | 周 | 仅周选择器的 format 可用;不补0 | 1 |
WW | 周 | 仅周选择器的 format 可用 | 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 | |
timestamp | JS时间戳 | 组件绑定值为number 类型 | 1483326245000 |
[MM] | 不需要格式化字符 | 使用方括号标识不需要格式化的字符 (如 [A] [MM]) | MM |
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
name | 绑定值 | string | — | — |
text | 表单标签 | string | — | — |
disabled | 是否禁用 | boolean / FilterFunction | — | false |
value-format | 可选,绑定值的格式。不指定则绑定值为 Date 对象 | string | 见日期格式 | — |
onChange | 值变化时触发的函数 | OnChangeHandler | — | - |