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

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since October 2017.

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

它可以代表以下含义之一:

尝试一下

属性

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

datetime

该属性表示此元素的时间和/或日期,并且属性值必须符合下文所描述的格式。

使用说明

该元素用于以机器可读格式显示日期和时间。例如,它可以帮助用户代理将事件添加到用户的日历中。

在使用公历之前的日期时不应使用该元素(因为这些日期的计算比较复杂)。

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

有效的日期时间值

描述 微语法 示例
有效月份字符串 YYYY-MM 2011-112013-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 20130001
有效的持续时间字符串 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 Standard
# the-time-element

浏览器兼容性

BCD tables only load in the browser

参见

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