HTML <time> datetime attribute

HTML <time> tag

Definition and usage

datetime The attribute represents the machine-readable format of the <time> element.

Examples of valid datetime values:

Date:

<time datetime="1914">  <!-- Represents the year 1914 -->
<time datetime="1914-12">  <!-- Represents December 1914 -->
<time datetime="1914-12-20">  <!-- Represents December 20, 1914 -->
<time datetime="12-20">  <!-- Represents December 20th of every year -->
<time datetime="1914-W15">  <!-- Represents the 15th week of 1914 -->

Date and time:

<time datetime="1914-12-20T08:00">  <!-- Represents 8:00 AM on December 20, 1914 -->
<time datetime="1914-12-20 08:00">  <!-- Also represents 8:00 AM on December 20, 1914 -->
<time datetime="1914-12-20 08:30:45">  <!-- Includes minutes and seconds -->
<time datetime="1914-12-20 08:30:45.687">  <!-- Includes minutes, seconds, and milliseconds -->

Time:

<time datetime="08:00">  <!-- Represents 8:00 AM -->
<time datetime="08:00-03:00">  <!-- Represents 8:00 AM Rio de Janeiro time (UTC-3 hours) -->
<time datetime="08:00+03:00">  <!-- Represents 8:00 AM Madagascar time (UTC+3 hours) -->

Duration:

<time datetime="P2D">  <!-- Represents 2 days -->
<time datetime="PT15H10M">  <!-- Represents 15 hours and 10 minutes -->

Example

The time element with machine-readable datetime attribute has been set:

<p>I had a date on <time datetime="2017-02-14">Valentine's Day</time>.</p>

Try it yourself

Grammar

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

Attribute Value

Value Description

YYYY-MM-DDThh:mm:ssTZD

or

PTDHMS

Specified date or time. Component description:

  • YYYY - Year (e.g., 2011)
  • MM - Month (e.g., 01 represents January)
  • DD - Day (e.g., 08)
  • T or space - Separator (if time is also specified)
  • hh - Hour (e.g., 22 represents 10 PM)
  • mm - Minutes (e.g., 55)
  • ss - Seconds (e.g., 03)
  • TZD - Time Zone Indicator (Z stands for Zulu time, also known as Greenwich Mean Time)
  • P - Prefix for "Period"
  • D - Prefix for "Days"
  • H - Prefix for "Hours"
  • M - Prefix for "Minutes"
  • S - Prefix for "Seconds"

Browser Support

The numbers in the table indicate the first browser version to fully support this attribute.

Chrome Edge Firefox Safari Opera
Chrome Edge Firefox Safari Opera
62.0 18.0 22.0 7.0 49.0

HTML <time> tag