<time>：(日期) 時間元素

Baseline 已廣泛支援

此功能已非常成熟，可在多種裝置和瀏覽器版本上使用。自 2017 年 10 月以來，它已在各大瀏覽器中可用。

<time> HTML 元素表示一個特定的時間段。它可以使用 datetime 屬性將日期轉換為機器可讀的格式，從而獲得更好的搜尋引擎結果或自定義功能，例如提醒。

它可以表示以下內容之一

24 小時制的時間。
格里高利曆中的精確日期（可選擇包含時間和時區資訊）。
一個有效的時間持續時間.

試一試

<p>
  The Cure will be celebrating their 40th anniversary on
  <time datetime="2018-07-07">July 7</time> in London's Hyde Park.
</p>

<p>
  The concert starts at <time datetime="20:00">20:00</time> and you'll be able
  to enjoy the band for at least <time datetime="PT2H30M">2h 30m</time>.
</p>

time {
  font-weight: bold;
}

屬性

與所有其他 HTML 元素一樣，此元素支援全域性屬性。

datetime: 此屬性指示元素的日期和/或時間，並且必須採用以下任一格式。

用法說明

此元素用於以機器可讀的格式呈現日期和時間。例如，這可以幫助使用者代理提供將事件新增到使用者日曆的選項。

此元素不應用於格里高利曆引入之前的日期（因為計算這些日期會很複雜）。

datetime 值（datetime 的機器可讀值）是元素 datetime 屬性的值，該值必須採用正確的格式（見下文）。如果元素沒有 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-DD HH: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 角色	`時間`
允許的 ARIA 角色	任意
DOM 介面	`HTMLTimeElement`

規範

規範
HTML # the-time-element

瀏覽器相容性

另見

允許訊號化其他型別值的 <data> 元素。

幫助改進 MDN

瞭解如何貢獻

此頁面由 MDN 貢獻者於 2025 年 8 月 23 日最後修改。

在 GitHub 上檢視此頁面 • 報告此內容的錯誤