HTMLTimeElement: dateTime プロパティ

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.

HTMLTimeElement.dateTime プロパティは文字列で、HTML の datetime 属性を反映し、要素の日付と時刻の値を機械可読な形で保持します。

文字列の形式は以下の HTML のマイクロ構文に従わなければなりません。

マイクロ構文 説明 例
有効な月文字列 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
4 桁以上の 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

値

文字列です。

例

js
// HTML に <time id="t"> 要素があると仮定する

const t = document.getElementById("t");
t.dateTime = "6w 5h 34m 5s";

仕様書

Specification
HTML Standard
# dom-time-datetime

ブラウザーの互換性

BCD tables only load in the browser

関連情報