HTMLTimeElement: dateTime property
The
HTMLTimeElement.dateTime
property is a string that reflects the datetime HTML attribute, containing a machine-readable form of the element's date and
time value.
The format of the string must follow one of the following HTML microsyntaxes:
| Microsyntax | Description | Examples |
|---|---|---|
| Valid month string | YYYY-MM |
2011-11, 2013-05 |
| Valid date string | YYYY-MM-DD |
1887-12-01 |
| Valid yearless date string | MM-DD |
11-12 |
| Valid time string | HH:MMHH :MM:SSHH :MM:SS.mmm |
23:5912:15:4712:15:52.998 |
| Valid local date and time string |
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 |
| Valid time-zone offset string | Z+HHMM+HH:MM-HHMM-HH:MM |
Z |
| Valid global date and time string | Any combination of a valid local date and time string followed by a valid time-zone offset string | 2013-12-25 11:12+0200 |
| Valid week string | YYYY-WWW |
2013-W46 |
| Four or more ASCII digits | YYYY | 2013, 0001 |
| Valid duration string | PdDThHmMsSPdDThHmMs.XSPdDThHmMs.XXSPdDThHmMs.XXXSPThHmMsSPThHmMs.XSPThHmMs.XXSPThHmMs.XXXSw w dd hh mm ss |
P12DT7H12M13S |
Value
A string.
Examples
js
// Assumes there is <time id="t"> element in the HTML
const t = document.getElementById("t");
t.dateTime = "6w 5h 34m 5s";
Specifications
| Specification |
|---|
| HTML Standard # dom-time-datetime |
Browser compatibility
BCD tables only load in the browser
See also
- The
HTMLTimeElementinterface it belongs to.