---
title: date
subtitle: 日期
type: Widgets
---

输入或选择日期的控件；`ng-zorro-antd` 未提供日期时间类组件，暂时以原生替代。

## 注意事项

- 格式化分为：**数据格式化**表示表单数据和**显示格式化**显示数据（等同 [nzFormat](https://ng.ant.design/components/date-picker/zh#api) 值）
- 所有 **数据格式化** 单位，参考 [date-fns format](https://date-fns.org/v1.29.0/docs/format)（国内镜像：[moment format](http://momentjs.cn/docs/#/displaying/format/)）
- 指定 `schema.format` 则必须遵守 [RFC3339](https://tools.ietf.org/html/rfc3339#section-5.6) 时间格式，否则都视为格式错误，默认的数据格式化：
  - `date-time` 默认 `YYYY-MM-DDTHH:mm:ssZ`，注意这里采用的是 `type="datetime-local"` 因此会涉及到**时区问题**
  - `date`、`full-date` 默认 `YYYY-MM-DD`
  - `time`、`full-time` 默认 `HH:mm:ss`
  - 非标准：`week` 默认 `YYYY-WW`
  - 非标准：`month` 默认 `YYYY-MM`
- 不指定 `schema.format` 根据 `schema.type` 值按以下规则处理（允许通过 `DelonFormConfig` 替换）数据格式化：
  - `string` 默认 `YYYY-MM-DD HH:mm:ss`
  - `number` 默认 `x` 13位Unix Timestamp

## API

### schema 属性

参数 | 说明 | 类型 | 默认值
----|------|-----|------
`[readOnly]` | 禁用状态  | `boolean` | -
`[format]` | 数据格式类型  | `string` | -

### ui 属性

参数        | 说明                   | 类型     | 默认值
------------|------------------------|----------|--------
`[size]`        | 大小，等同 `nzSize`     | `string` | -
`[placeholder]` | 在文字框中显示提示讯息 | `string` | -
`[format]`      | 数据格式化             | `string` | -
`[displayFormat]` | 显示格式化，（等同 [nzFormat](https://ng.ant.design/components/date-picker/zh#api) 值） | `string` | `yyyy-MM-dd HH:mm:ss`
`[allowClear]` | 是否显示清除按钮 | `boolean` | `true`
`[className]` | 选择器 className | `string` | -
`[disabledDate]` | 不可选择的日期 | `(current: Date) => boolean` | -
`[locale]` | 国际化配置 | `object` | -
`[popupStyle]` | 额外的弹出日历样式 | `object` | -
`[dropdownClassName]` | 额外的弹出日历 className | `string` | -
`[onOpenChange]` | 弹出日历和关闭日历的回调 | `(status: boolean) => void` | -
`[disabledDate]` | 不可选择的日期 | `(current: Date) => boolean` | -
`[disabledTime]` | 不可选择的时间 | `(current: Date) => { nzDisabledHours, nzDisabledMinutes, nzDisabledSeconds }` | -
`[renderExtraFooter]` | 在面板中添加额外的页脚 | `string` | -
`[showTime]` | 增加时间选择功能 | `boolean` | `true`
`[showToday]` | 是否展示“今天”按钮 | `boolean` | `true`
`[onOk]` | 点击确定按钮的回调	 | `(data: Data | Data[]) => void` | -