Skip to content

Latest commit

 

History

History
254 lines (221 loc) · 7.86 KB

index.md

File metadata and controls

254 lines (221 loc) · 7.86 KB
Raw
title slug l10n
<time>：（日期）时间元素
Web/HTML/Element/time
sourceCommit
835c199410845eed61aaf8439cb2e9719e7e9f98

{{HTMLSidebar}}

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

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

{{EmbedInteractiveExample("pages/tabbed/time.html", "tabbed-shorter")}}

属性

与所有其他 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

<p>演出于 <time datetime="2018-07-07T20:00:00">20:00</time> 开始。</p>

结果

{{EmbedLiveSample('简单示例', 250, 80)}}

datetime 示例

HTML

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

结果

{{EmbedLiveSample('datetime 示例', 250, 80)}}

技术概要

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

规范

{{Specifications}}

浏览器兼容性

{{Compat}}

参见

  • {{HTMLElement("data")}} 元素，可用于表示其他类型的值。