<time>:日期和时间元素

基线 广泛可用

此功能已经稳定,并且可以在许多设备和浏览器版本上运行。它自以下时间起在所有浏览器中可用: 2017 年 10 月.

<time> HTML 元素表示特定时间段。它可能包含 datetime 属性,用于将日期转换为机器可读格式,从而实现更好的搜索引擎结果或自定义功能(如提醒)。

它可以表示以下内容之一:

试一试

属性

与所有其他 HTML 元素一样,此元素支持全局属性

datetime

此属性指示元素的时间和/或日期,并且必须采用以下格式之一。

使用说明

此元素用于以机器可读格式呈现日期和时间。例如,这可以帮助用户代理为用户提供将事件添加到其日历中的选项。

此元素不应用于公历引入之前的日期(由于计算这些日期时存在复杂性)。

日期时间值(日期时间的机器可读值)是元素的datetime属性的值,该值必须采用正确的格式(请参见下文)。如果元素没有datetime属性,则它不能有任何元素后代,并且日期时间值是元素的子文本内容。

有效的日期时间值

描述 微语法 示例
有效的月份字符串 YYYY-MM 2011-11, 2013-05
有效的日期字符串 YYYY-MM-DD 1887-12-01
有效的无年份日期字符串 MM-DD 11-12
有效的时分字符串 HH:MM
HH:MM:SS
HH:MM:SS.mmm
23:59
12:15:47
12:15:52.998
有效的本地日期和时间字符串 YYYY-MM-DDHH:MM
YYYY-MM-DD HH:MM:SS
YYYY-MM-DD HH:MM:SS.mmm
YYYY-MM-DDTHH:MM
YYYY-MM-DDTHH:MM:SS
YYYY-MM-DDTHH:MM:SS.mmm
2013-12-25 11:12
1972-07-25 13:43:07
1941-03-15 07:06:23.678
2013-12-25T11:12
1972-07-25T13:43:07
1941-03-15T07:06:23.678
有效的时区偏移字符串 Z
+HHMM
+HH:MM
-HHMM
-HH:MM
Z
+0200
+04:30
-0300
-08:00
有效的全局日期和时间字符串 有效的本地日期和时间字符串与有效的时区偏移字符串的任意组合 2013-12-25 11:12+0200
1972-07-25 13:43:07+04:30
1941-03-15 07:06:23.678Z
2013-12-25T11:12-08:00
有效的星期字符串 YYYY-WWW 2013-W46
四个或更多个 ASCII 数字 YYYY 2013, 0001
有效的持续时间字符串 PdDThHmMsS
PdDThHmMs.XS
PdDThHmMs.XXS
PdDThHmMs.XXXS
PThHmMsS
PThHmMs.XS
PThHmMs.XXS
PThHmMs.XXXS
ww dd hh mm ss
P12DT7H12M13S
P12DT7H12M13.3S
P12DT7H12M13.45S
P12DT7H12M13.455S
PT7H12M13S
PT7H12M13.2S
PT7H12M13.56S
PT7H12M13.999S
7d 5h 24m 13s

示例

简单示例

HTML

html
<p>The concert starts at <time datetime="2018-07-07T20:00:00">20:00</time>.</p>

结果

datetime 示例

HTML

html
<p>
  The concert took place on <time datetime="2001-05-15T19:00">May 15</time>.
</p>

结果

技术摘要

内容类别 流内容短语内容,可感知内容。
允许的内容 短语内容.
标签省略 无,开始和结束标签都是必须的。
允许的父元素 任何接受短语内容的元素。
隐式 ARIA 角色 time
允许的 ARIA 角色 任何
DOM 接口 HTMLTimeElement

规范

规范
HTML 标准
# the-time-element

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅

  • <data>元素,允许发出其他类型的值。