日期字段
日期字段
The date field stores date-oriented values.
最适用场景
- 事件日期
- 发布标记
- 时间线步骤
- 发布或上线日期
模式示例
{ "name": "eventDate", "label": "Event Date", "type": "date" }模板用法
<time datetime="{{ eventDate }}">{{ eventDate }}</time>格式化输出示例:
<time datetime="{{ eventDate }}">
{{ eventDate | date("F j, Y") }}
</time>何时使用
当值应表现为真实日期而不是纯文本时,请使用 date。
不适用场景
不要将 date 用于:
- 自由格式的日程文本
- 以散文形式写的日期范围
- 任意标签
当该值不是单一类似日期的字段时,请使用 text 或 textarea。
技术说明
- 将保存的值保持为真实的面向日期的字段,并在呈现时进行格式化
- 将过滤器用于展示,而不是将格式化的散文存储为字段值
- 每个有意义的日期使用一个字段,而不是将多个里程碑塞进一个字符串
- 如果某个部分需要日期范围,请使用单独的开始和结束字段或明确的辅助说明文本