<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
属性,用于将日期转换为机器可读格式,从而获得更好的搜索引擎结果或自定义功能(如提醒)。
它可以代表以下含义之一:
尝试一下
属性
使用说明
该元素用于以机器可读格式显示日期和时间。例如,它可以帮助用户代理将事件添加到用户的日历中。
在使用公历之前的日期时不应使用该元素(因为这些日期的计算比较复杂)。
日期时间值(机器可读的日期时间值)是该元素的 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 |
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>
结果
技术概要
规范
Specification |
---|
HTML Standard # the-time-element |
浏览器兼容性
BCD tables only load in the browser
参见
<data>
元素,可用于表示其他类型的值。