W3cubDocs

/Web APIs

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`:`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`-`DD`T`HH`:`MM YYYY`-`MM`-`DD`T`HH`:`MM`:`SS YYYY`-`MM`-`DD`T`HH`:`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`-W`WW	`2013-W46`
Four or more ASCII digits	YYYY	`2013`, `0001`
Valid duration string	`P`d`DT`h`H`m`M`s`S` `P`d`DT`h`H`m`M`s`.`X`S` `P`d`DT`h`H`m`M`s`.`XX`S` `P`d`DT`h`H`m`M`s`.`XXX`S` `PT`h`H`m`M`s`S` `PT`h`H`m`M`s`.`X`S` `PT`h`H`m`M`s`.`XX`S` `PT`h`H`m`M`s`.`XXX`S` w`w` d`d` h`h` m`m` s`s`	`P12DT7H12M13S P12DT7H12M13.3S P12DT7H12M13.45S P12DT7H12M13.455S PT7H12M13S PT7H12M13.2S PT7H12M13.56S PT7H12M13.999S 7d 5h 24m 13s`

Value

A string.

Examples

// 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

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet
`dateTime`	62	14	22	No	4911.5–15	10	62	62	22	4611.5–14	10	8.0

Value

Examples

Specifications

Browser compatibility

See also