Time dateTime Property

❮ Time Object

Example

Get the date that a <time> element represents:

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

Description

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.


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
Copyright 1999-2023 by Refsnes Data. All Rights Reserved.