THE WORLD'S LARGEST WEB DEVELOPER SITE

Time dateTime Property

❮ Time Object

Example

Get the date that a <time> element represents:

var x = document.getElementById("myTime").dateTime;
Try it Yourself »

Definition and Usage

The dateTime property sets or returns the value of the datetime attribute in a <time> element.

The datetime attribute gives the date or time being specified. This attribute is used if no date or time is specified in the element's content.

Note: The datetime attribute does not render as anything special in any of the major browsers.

Note: The <time> element is new in HTML5.


Browser Support

Property
datetime Not supported Not supported Yes Not supported Not supported


Syntax

Return the dateTime property:

timeObject.dateTime

Set the dateTime property:

timeObject.dateTime = YYYY -MM-DDThh:mm:ssTZD

Property Values

Value Description
YYYY-MM-DDThh:mm:ssTZD The date or time being specified. Explanation of components:
  • YYYY - year (e.g. 2011)
  • MM - month (e.g. 01 for January)
  • DD - day of the month (e.g. 08)
  • T - a required separator if time is also specified
  • hh - hour (e.g. 22 for 10.00pm)
  • mm - minutes (e.g. 55)
  • ss - seconds (e.g. 03)
  • TZD - Time Zone Designator (Z denotes Zulu, also known as Greenwich Mean Time)

Technical Details

Return Value: A String, representing a machine-readable form of the element's date and time

More Examples

Example

Change the date and time of a <time> element:

document.getElementById("myTime").dateTime = "1999-06-24T09:30Z";
Try it Yourself »

Related Pages

HTML reference: HTML <time> datetime attribute


❮ Time Object