HTMLTimeElement.dateTime

The HTMLTimeElement.dateTime property is a DOMString 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:MM
HH:MM:SS
HH:MM:SS.mmm		 23:59
12:15:47
12:15:52.998
Valid local date and time string 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
Valid time-zone offset string Z
+HHMM
+HH:MM
-HHMM
-HH:MM		 Z
+0200
+04:30
-0300
-08:00
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
1972-07-25 13:43:07+04:30
1941-03-15 07:06:23.678Z
2013-12-25T11:12-08:00
Valid week string YYYY-WWW 2013-W46
Four or more ASCII digits YYYY 2013, 0001
Valid duration string 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

Syntax

dateTimeString = timeElt.dateTime;
timeElt.dateTime = dateTimeString

Example

// Assumes there is <time id="t"> element in the HTML

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

Specifications

Specification Status Comment
HTML Living Standard
The definition of 'HTMLTimeElement' in that specification.		 Living Standard No change from HTML 5.1.
HTML 5.1
The definition of 'HTMLTimeElement' in that specification.		 Recommendation No change from HTML5.
HTML5
The definition of 'HTMLTimeElement' in that specification.		 Recommendation Initial definition.

Browser compatibility

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
dateTimeChrome Full support 62Edge Full support 14Firefox Full support 22IE No support NoOpera Full support 49
Full support 49
No support 11.5 — 15
Safari Full support 10WebView Android Full support 62Chrome Android Full support 62Firefox Android Full support 22Opera Android Full support 46
Full support 46
No support 11.5 — 14
Safari iOS Full support 10Samsung Internet Android Full support 8.0

Legend

Full support
Full support
No support
No support

See also