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 2017年10月.
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:5912:15:4712:15:52.998
|
| 有効なローカル日時文字列 |
YYYY-MM-DD
HH:MMYYYY -MM-DD HH:MM:SSYYYY -MM-DD HH:MM:SS.mmmYYYY -MM-DDTHH:MMYYYY -MM-DDTHH:MM:SSYYYY -MM-DDTHH:MM:SS.mmm
|
2013-12-25 11:12
|
| 有効なタイムゾーンオフセット文字列 |
Z+HHMM+HH:MM-HHMM-HH:MM
|
Z
|
| 有効なグローバル日時文字列 | 有効な日時文字列と有効なタイムゾーンオフセット文字列が続く任意の組み合わせ。 |
2013-12-25 11:12+0200
|
| 有効な週文字列 | YYYY-WWW |
2013-W46 |
| 4 桁以上の ASCII 数字 | YYYY | 2013, 0001 |
| 有効な期間文字列 |
PdDThHmMsSPdDThHmMs.XSPdDThHmMs.XXSPdDThHmMs.XXXSPThHmMsSPThHmMs.XSPThHmMs.XXSPThHmMs.XXXSw w dd hh mm ss
|
P12DT7H12M13S
|
値
文字列です。
例
js
// HTML に <time id="t"> 要素があると仮定する
const t = document.getElementById("t");
t.dateTime = "6w 5h 34m 5s";
仕様書
| Specification |
|---|
| HTML> # dom-time-datetime> |
ブラウザーの互換性
Loading…
関連情報
- 所属先の
HTMLTimeElementインターフェイス