<time>：（日期）时间元素

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨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 属性，它就不能有任何元素后代，日期时间值就是元素的子文本内容。

有效的日期时间值

描述	微语法	示例
有效月份字符串	`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`
四个或更多 ACSII 数字	`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>演出于 <time datetime="2018-07-07T20:00:00">20:00</time> 开始。</p>

结果

`datetime` 示例

HTML

html

<p>演出于 <time datetime="2001-05-15T19:00">5 月 15 日</time>开始。</p>

结果

技术概要

内容分类	流式内容、短语内容、可感知内容。
允许的内容	短语内容。
标签省略	不允许，开始标签和结束标签都不能省略。
允许的父元素	任何接受短语内容的元素。
隐含的 ARIA 角色	`time`
允许的 ARIA 角色	任何
DOM 接口	`HTMLTimeElement`

规范

Specification
HTML # the-time-element

浏览器兼容性

参见

<data> 元素，可用于表示其他类型的值。

Help improve MDN

Learn how to contribute

This page was last modified on ⁨2025年8月6日⁩ by MDN contributors.

View this page on GitHub • Report a problem with this content