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

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

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

尝试一下

属性

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

datetime

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

使用说明

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

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

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

有效的日期时间值

有效的年份字符串

2011

有效的年月字符串

2011-11

有效的日期字符串

2011-11-18

有效的日期字符串(不包含年份)

11-18

有效的周字符串

2011-W47

有效的时间字符串

14:54

14:54:39

14:54:39.929

有效的本地日期时间字符串

2011-11-18T14:54:39.929

2011-11-18 14:54:39.929

有效的全球日期时间字符串

2011-11-18T14:54:39.929Z

2011-11-18T14:54:39.929-0400

2011-11-18T14:54:39.929-04:00

2011-11-18 14:54:39.929Z

2011-11-18 14:54:39.929-0400

2011-11-18 14:54:39.929-04:00

有效的时长字符串

PT4H18M3S

示例

简单示例

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 (en-US)
允许的 ARIA 角色 任何
DOM 接口 HTMLTimeElement (en-US)

规范

Specification
HTML Standard
# the-time-element

浏览器兼容性

BCD tables only load in the browser

参见

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