<time>：(日期) 时间元素

Baseline 已广泛支持

此功能已非常成熟，可在多种设备和浏览器版本上使用。自 2017 年 10 月以来，它已在各大浏览器中可用。

<time> HTML 元素表示一个特定的时间段。它可以使用 datetime 属性将日期转换为机器可读的格式，从而获得更好的搜索引擎结果或自定义功能，例如提醒。

它可以表示以下内容之一

24 小时制的时间。
格里高利历中的精确日期（可选择包含时间和时区信息）。
一个有效的时间持续时间.

试一试

<p>
  The Cure will be celebrating their 40th anniversary on
  <time datetime="2018-07-07">July 7</time> in London's Hyde Park.
</p>

<p>
  The concert starts at <time datetime="20:00">20:00</time> and you'll be able
  to enjoy the band for at least <time datetime="PT2H30M">2h 30m</time>.
</p>

time {
  font-weight: bold;
}

属性

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

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

用法说明

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

此元素不应用于格里高利历引入之前的日期（因为计算这些日期会很复杂）。

datetime 值（datetime 的机器可读值）是元素 datetime 属性的值，该值必须采用正确的格式（见下文）。如果元素没有 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-DD HH: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 角色	`时间`
允许的 ARIA 角色	任意
DOM 接口	`HTMLTimeElement`

规范

规范
HTML # the-time-element

浏览器兼容性

另见

允许信号化其他类型值的 <data> 元素。

帮助改进 MDN

了解如何贡献

此页面由 MDN 贡献者于 2025 年 8 月 23 日最后修改。

在 GitHub 上查看此页面 • 报告此内容的错误