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: MMHH : MM: SSHH : MM: SS. mmm
|
23:59 12:15:47 12:15:52.998
|
有効なローカル日時文字列 |
YYYY- MM- DD
HH: MMYYYY - MM- DD HH: MM: SSYYYY - MM- DD HH: MM: SS. mmmYYYY - MM- DDT HH: MMYYYY - MM- DDT HH: MM: SSYYYY - MM- DDT HH: MM: SS. mmm
|
2013-12-25 11:12
|
有効なタイムゾーンオフセット文字列 |
Z + HHMM+ HH: MM- HHMM- HH: MM
|
Z
|
有効なグローバル日時文字列 | 有効な日時文字列と有効なタイムゾーンオフセット文字列が続く任意の組み合わせ。 |
2013-12-25 11:12+0200
|
有効な週文字列 | YYYY-W WW |
2013-W46 |
4 桁以上の ASCII 数字 | YYYY | 2013 , 0001 |
有効な期間文字列 |
P dD T hH mM sS P dD T hH mM s. XS P dD T hH mM s. XXS P dD T hH mM s. XXXS P T hH mM sS P T hH mM s. XS P T hH mM s. XXS P T hH mM s. XXXS w w dd hh mm ss
|
P12DT7H12M13S
|
値
文字列です。
例
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
関連情報
- 所属先の
HTMLTimeElement
インターフェイス