icon: ''
tags:
  en:
    - date
    - datetime
    - form
  zh-CN:
    - 日期
    - 选择
    - 表单
props:
  format:
    type: String
    default: 'YYYY-MM-DD'
    en: date format. Special characters are not supported, for example, YYYY-MM-DD HH:mm:ss
    zh-CN: 时间格式，不支持特殊字符，只能类似 YYYY-MM-DD HH:mm:ss 这样的格式
  title:
    type: String
    default: ''
    en: cell title
    zh-CN: 标题
  value:
    type: String
    default: ''
    en: form's value, use `v-model` for binding
    zh-CN: 表单值，`v-model`绑定
  inline-desc:
    type: String
    default: ''
    en: description of the cell
    zh-CN: 描述字符
  placeholder:
    type: String
    default: ''
    en: placeholder, works when value is empty
    zh-CN: 提示文字，当`value`为空时显示
  min-year:
    type: Number
    default: ''
    en: min-year of the form
    zh-CN: 可选择的最小年份
  max-year:
    type: Number
    default: ''
    en: max-year of the form
    zh-CN: 可选择的最大年份
  min-hour:
    type: Number
    default: 0
    en: min hour
    zh-CN: 限定小时最小值
  max-hour:
    type: Number
    default: 23
    en: max hour
    zh-CN: 限定小时最大值
  min-minute:
    type: Number
    default: 0
    en: min minute
    zh-CN: 限定分钟最小值
  max-minute:
    type: Number
    default: 23
    en: max minute
    zh-CN: 限定分钟最大值
  confirm-text:
    type: String
    default: ok(确认)
    en: confirm button's text
    zh-CN: 确认按钮文字
  cancel-text:
    type: String
    default: cancel(取消)
    en: cancel button's text
    zh-CN: 取消按钮文字
  clear-text:
    type: String
    default: ''
    en: custom button's text which shows in the middle of the header
    zh-CN: 显示在中间的自定义按钮的文字
  year-row:
    type: String
    default: '{value}'
    en: render template for the year column
    zh-CN: 年份的渲染模板
  month-row:
    type: String
    default: '{value}'
    en: render template for the month column
    zh-CN: 月份的渲染模板
  day-row:
    type: String
    default: '{value}'
    en: render template for the day column
    zh-CN: 日期的渲染模板
  hour-row:
    type: String
    default: '{value}'
    en: render template for the hour column
    zh-CN: 小时的渲染模板
  minute-row:
    type: String
    default: '{value}'
    en: render template for the minute column
    zh-CN: 分钟的渲染模板
  start-date:
    type: String
    en: 'start date, must be YYYY-MM-DD. Please use `min-hour` and `max-hour` to limit the range of hours'
    zh-CN: '限定最小日期，格式必须为 YYYY-MM-DD，注意该限制只能限定到日期，不能限定到小时分钟。小时限定请使用`min-hour`和`max-hour`'
  end-date:
    type: String
    en: 'end date, must be YYYY-MM-DD. Please use `min-hour` and `max-hour` to limit the range of hours'
    zh-CN: 限定最大日期，格式必须为 YYYY-MM-DD，注意该限制只能限定到日期，不能限定到小时分钟
  required:
    type: Boolean
    default: false
    en: if required
    zh-CN: 是否必填
slots:
  default:
    en: trigger element content
    zh-CN: 触发元素内容
events:
  on-change:
    params: '`(value)`'
    en: $emits when value changes, `(newVal)`
    zh-CN: 表单值变化时触发, 参数 `(newVal)`
  on-clear:
    en: $emits when click the button in the middle of the header
    zh-CN: 点击显示在中间的自定义按钮时触发
  on-show:
    en: fires when datetime shows
    zh-CN: 弹窗显示时触发