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 :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 | 
Syntax
dateTimeString = timeElt.dateTime; timeElt.dateTime =dateTimeString
Examples
// 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 | 
|---|---|---|
| WHATWG HTML Living Standard The definition of 'HTMLTimeElement' in that specification. | Living Standard | No change from HTML5.1. | 
| HTML5.1 The definition of 'HTMLTimeElement' in that specification. | Working Draft | No change from HTML5. | 
| HTML5 The definition of 'HTMLTimeElement' in that specification. | Recommendation | Initial definition. | 
Browser compatibility
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) | 
|---|---|---|---|---|---|
| Basic support | Not supported | 22.0 (22.0) | Not supported | 11.50 Removed in 15.0 | Not supported | 
| Feature | Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile | 
|---|---|---|---|---|---|
| Basic support | Not supported | 22.0 (22.0) | Not supported | ? | Not supported | 
See also
- The HTMLTimeElementinterface it belongs to.