<time>:日期和時間元素

基線 廣泛可用

此功能已經穩定,並且可以在許多裝置和瀏覽器版本上執行。它自以下時間起在所有瀏覽器中可用: 2017 年 10 月.

<time> HTML 元素表示特定時間段。它可能包含 datetime 屬性,用於將日期轉換為機器可讀格式,從而實現更好的搜尋引擎結果或自定義功能(如提醒)。

它可以表示以下內容之一:

試一試

屬性

與所有其他 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
四個或更多個 ASCII 數字 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>The concert starts at <time datetime="2018-07-07T20:00:00">20:00</time>.</p>

結果

datetime 示例

HTML

html
<p>
  The concert took place on <time datetime="2001-05-15T19:00">May 15</time>.
</p>

結果

技術摘要

內容類別 流內容短語內容,可感知內容。
允許的內容 短語內容.
標籤省略 無,開始和結束標籤都是必須的。
允許的父元素 任何接受短語內容的元素。
隱式 ARIA 角色 time
允許的 ARIA 角色 任何
DOM 介面 HTMLTimeElement

規範

規範
HTML 標準
# the-time-element

瀏覽器相容性

BCD 表格僅在瀏覽器中載入

另請參閱

  • <data>元素,允許發出其他型別的值。