Our volunteers haven't translated this article into فارسی yet. Join us and help get the job done!
Summary
The HTML <time> element represents either a time on a 24-hour clock or a precise date in the Gregorian calendar (with optional time and timezone information).
This element is intended to be used presenting dates and times in a machine readable format. This can be helpful for user agents to offer any event scheduling for user's calendar.
Usage note: This element is not appropriate for instances where a specific date cannot be calculated, nor should it be used for dates prior to the introduction to the Gregorian calendar (due to complications with calculating those dates).
| Content categories | Flow content, phrasing content, palpable content. |
|---|---|
| Permitted content | Phrasing content. |
| Tag omission | None; both the starting and ending tags are mandatory. |
| Permitted parent elements | Any element that accepts phrasing content. |
| DOM interface | HTMLTimeElement |
Attributes
Like all other HTML elements, this element supports the global attributes.
datetime- This attribute indicates the time and date of the element and must be a valid date with an optional time string. If the value cannot be parsed as a date with an optional time string, the element does not have an associated time stamp.
Examples
Simple example
HTML
<p>The concert starts at <time>20:00</time>.</p>
Output
datetime example
HTML
<p>The concert took place on <time datetime="2001-05-15T19:00">May 15</time>.</p>
Output
Specifications
| Specification | Status | Comment |
|---|---|---|
| WHATWG HTML Living Standard The definition of '<time>' in that specification. |
Living Standard | No change from HTML5.1 |
| HTML5.1 The definition of '<time>' in that specification. |
Working Draft | No change from HTML5 |
| HTML5 The definition of '<time>' in that specification. |
Recommendation | Initial definition. |
Browser compatibility
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Basic support | 33.0 | 22.0 (22.0) | 9.0 | 22.0 | 7.0 |
| Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Basic support | 2.1 | ? | 22.0 (22.0) | 10.0 | 11.50 Removed in 15.0 |
4.0-4.1 |
See also
- The
<data>element, allowing to signal other kind of values.
Document Tags and Contributors
Tags:
Contributors to this page:
slimsag,
mrenty,
Sheepy,
nwtn,
Sebastianz,
murali24,
sjakthol,
Sheppy,
Mahdi,
kscarfone,
teoli,
ethertank,
ziyunfei,
mkato,
jamesspencer,
allergic,
medicdude,
Briggz5d,
noLanwona,
avsaro,
ernestd,
fscholz,
McGurk,
hobophobe
Last updated by:
slimsag,