Example
A time element with a machine-readable datetime attribute:
<p>I have a date on <time datetime="2017-02-14">Valentines
day</time>.</p>
Try it Yourself »
Definition and Usage
The datetime attribute represent the machine-readable date/time of the <time> element.
Examples of legal dates and times:
Dates:
<time datetime="1914">
<!-- means the year 1914 -->
<time datetime="1914-12">
<!-- means December 1914 -->
<time datetime="1914-12-20">
<!-- means 20 December 1914 -->
<time datetime="12-20">
<!-- means 20 December any year -->
<time datetime="1914-W15">
<!-- means week 15 of year 1914 -->
Date and Times:
<time datetime="1914-12-20T08:00">
<!-- means 20 December 1914 at 8am -->
<time datetime="1914-12-20
08:00"> <!-- also means 20 December 1914 at 8am -->
<time datetime="1914-12-20
08:30:45"> <!-- with minutes and seconds -->
<time datetime="1914-12-20
08:30:45.687"> <!-- with minutes, seconds, and
milliseconds -->
Times:
<time datetime="08:00">
<!-- means 8am -->
<time datetime="08:00-03:00">
<!-- means 8am in Rio de Janeiro (UTC-3 hours) -->
<time datetime="08:00+03:00">
<!-- means 8am in Madagascar (UTC+3 hours) -->
Durations:
<time datetime="P2D"> <!--
means a duration of 2 days -->
<time datetime="PT15H10M">
<!-- means a duration of 15 hours and 10 minutes -->
Browser Support
Attribute | |||||
---|---|---|---|---|---|
datetime | Yes | Yes | Yes | Yes | Yes |
Differences Between HTML 4.01 and HTML5
The <time> tag is new in HTML5.
Syntax
<time datetime="YYYY-MM-DDThh:mm:ssTZD">
Attribute Values
Value | Description |
---|---|
YYYY-MM-DDThh:mm:ssTZD or PTDHMS |
The date or time being specified. Explanation of components:
|