HTML <time> datetime Attribute

The datetime attribute on a <time> tag attaches a datetime value.

This value is not visible, but it is machine-readable.



Two <time> elements with a datetime attribute
The datetime values are not visible, but JavaScript can read these.

The date is: .
The time is: .

  The date is: <time datetime="2020-08-07">August 7, 2020</time>.<br />
  The time is: <time datetime="15:22">3:22 PM</time>.

Using datetime

The datetime attribute attaches a date (required) and time (optional) value to a time element.

Its value is not visible to the user; it only adds a semantic timestamp to the element.

The datetime values are readable by screen readers, search engines, JavaScript code, and others.


<time datetime="YYYY-MM-DDThh:mm:ssTZD">



DESCRIPTION: The date and time attached to the element.
The format can be broken down as follows:
  • YYYY - year (e.g. 2020)
  • MM - month (e.g. 09 for September)
  • DD - day (e.g. 01 for first day of the month)
  • T or space - a date and time separator, required if date is included
  • hh - hour in 24-hour format (e.g. 23)
  • mm - minutes
  • ss - seconds
  • TZD - Time zone designator where Z refers to Zulu or GMT
  • P - prefix for period (duration)
  • D - prefix for days
  • H - prefix for hours
  • M - prefix for minutes
  • S - prefix for seconds
EXAMPLES: local time
2021-01-18 11:54:41.809
international time
2021-01-18 18:54:41.809Z

Browser support

Here is when datetime support started for each browser:

62.0 Oct 2017
22.0 Jun 2013
18.0 Jan 2020
49.0 Nov 2017
7.0 Oct 2013

You may also like

 Back to <time>

Author: Jack Poorte
Published: Jun 20 2021
Last Reviewed: Sep 30 2023

What's your favorite/least favorite part of Dofactory?