在此页

• 属性
• 用法注意事项
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

HTML <time> element represents a specific period in time. It may include the datetime attribute to translate dates into machine-readable format, allowing for better search engine results or custom features such as reminders.

It may represent one of the following:

• A time on a 24-hour clock.
• A precise date in the Gregorian calendar (with optional time and timezone information).
• A valid time duration .

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

内容类别	流内容 , 措词内容 ，可触及内容。
准许内容	措词内容 .
Tag omission	None, both the starting and ending tag are mandatory.
Permitted parents	Any element that accepts 措词内容 .
Implicit ARIA role	无对应角色
Permitted ARIA roles	任何
DOM 接口	HTMLTimeElement

属性

Like all other HTML elements, this element supports the 全局属性 .

datetime

This attribute indicates the time and/or date of the element and must be in one of the formats described below.

用法注意事项

This element is for presenting dates and times in a machine readable format. For example, this can help a user agent offer to add an event to a user's calendar.

This element should not be used for dates prior to the introduction of the Gregorian calendar (due to complications in calculating those dates).

datetime value (the machine-readable value of the datetime) is the value of the element’s datetime attribute, which must be in the proper format (see below). If the element does not have a datetime 属性， it must not have any element descendants ，和 datetime value is the element’s child text content.

Valid datetime Values

a valid year string

2011

a valid month string

2011-11

a valid date string

2011-11-18

a valid yearless date string

11-18

a valid week string

2011-W47

a valid time string

14:54

14:54:39

14:54:39.929

a valid local date and time string

2011-11-18T14:54:39.929

2011-11-18 14:54:39.929

a valid global date and time string

2011-11-18T14:54:39.929Z

2011-11-18T14:54:39.929-0400

2011-11-18T14:54:39.929-04:00

2011-11-18 14:54:39.929Z

2011-11-18 14:54:39.929-0400

2011-11-18 14:54:39.929-04:00

a valid duration string

PT4H18M3S

范例

简单范例

HTML

<p>The concert starts at <time datetime="2018-07-07T20:00:00">20:00</time>.</p>

输出

datetime 范例

HTML

<p>The concert took place on <time
  datetime="2001-05-15T19:00">May 15</time>.</p>

输出

规范

规范	状态	注释
HTML 实时标准 The definition of '<time>' in that specification.	实时标准	无变化自 HTML 5.1
HTML 5.1 The definition of '<time>' in that specification.	推荐	无变化自 HTML5
HTML5 The definition of '<time>' in that specification.	推荐	初始定义。

浏览器兼容性

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
time	Chrome 完整支持 62	Edge 完整支持 ≤18	Firefox 完整支持 22	IE 不支持 No	Opera 完整支持 49	Safari 完整支持 7	WebView Android 完整支持 62	Chrome Android 完整支持 62	Firefox Android 完整支持 22	Opera Android 完整支持 46	Safari iOS 完整支持 4	Samsung Internet Android 完整支持 8.0
datetime	Chrome 完整支持 62	Edge 完整支持 ≤18	Firefox 完整支持 22	IE 不支持 No	Opera 完整支持 49	Safari 完整支持 7	WebView Android 完整支持 62	Chrome Android 完整支持 62	Firefox Android 完整支持 22	Opera Android 完整支持 46	Safari iOS 完整支持 4	Samsung Internet Android 完整支持 8.0

图例

完整支持

完整支持

不支持

不支持

另请参阅

• <data> element, allowing to signal other kind of values.

元数据

• 最后修改： Apr 12, 2020

相关话题

1. <a>
2. <abbr>
3. <b>
4. <bdi>
5. <bdo>
6. <br>
7. <cite>
8. <code>
9. <data>
10. <dfn>
11. <em>
12. <i>
13. <kbd>
14. <mark>
15. <q>
16. <rb>
17. <rp>
18. <rt>
19. <rtc>
20. <ruby>
21. <s>
22. <samp>
23. <small>
24. <span>
25. <strong>
26. <sub>
27. <sup>
28. <time>
29. <u>
30. <var>
31. <wbr>
32. HTML 元素

    1. A
       1. <a>
       2. <abbr>
       3. <acronym>
       4. <address>
       5. <applet>
       6. <area>
       7. <article>
       8. <aside>
       9. <audio>
    2. B
       1. <b>
       2. <base>
       3. <basefont>
       4. <bdi>
       5. <bdo>
       6. <bgsound>
       7. <big>
       8. <blink>
       9. <blockquote>
       10. <body>
       11. <br>
       12. <button>
    3. C
       1. <canvas>
       2. <caption>
       3. <center>
       4. <cite>
       5. <code>
       6. <col>
       7. <colgroup>
       8. <content>
    4. D
       1. <data>
       2. <datalist>
       3. <dd>
       4. <del>
       5. <details>
       6. <dfn>
       7. <dialog>
       8. <dir>
       9. <div>
       10. <dl>
       11. <dt>
    5. E
       1. <em>
       2. <embed>
    6. F
       1. <fieldset>
       2. <figcaption>
       3. <figure>
       4. <font>
       5. <footer>
       6. <form>
       7. <frame>
       8. <frameset>
    7. G H
       1. <h1>
       2. <h2>
       3. <h3>
       4. <h4>
       5. <h5>
       6. <h6>
       7. <head>
       8. <header>
       9. <hgroup>
       10. <hr>
       11. <html>
    8. I
       1. <i>
       2. <iframe>
       3. <img>
       4. <input>
       5. <ins>
       6. <isindex>
    9. J K
       1. <kbd>
       2. <keygen>
    10. L
        1. <label>
        2. <legend>
        3. <li>
        4. <link>
        5. <listing>
    11. M
        1. <main>
        2. <map>
        3. <mark>
        4. <marquee>
        5. <menu>
        6. <menuitem>
        7. <meta>
        8. <meter>
    12. N
        1. <nav>
        2. <nobr>
        3. <noframes>
        4. <noscript>
    13. O
        1. <object>
        2. <ol>
        3. <optgroup>
        4. <option>
        5. <output>
    14. P
        1. <p>
        2. <param>
        3. <picture>
        4. <plaintext>
        5. <pre>
        6. <progress>
    15. Q
        1. <q>
    16. R
        1. <rp>
        2. <rt>
        3. <rtc>
        4. <ruby>
    17. S
        1. <s>
        2. <samp>
        3. <script>
        4. <section>
        5. <select>
        6. <shadow>
        7. <slot>
        8. <small>
        9. <source>
        10. <spacer>
        11. <span>
        12. <strike>
        13. <strong>
        14. <style>
        15. <sub>
        16. <summary>
        17. <sup>
    18. T
        1. <table>
        2. <tbody>
        3. <td>
        4. <template>
        5. <textarea>
        6. <tfoot>
        7. <th>
        8. <thead>
        9. <time>
        10. <title>
        11. <tr>
        12. <track>
        13. <tt>
    19. U
        1. <u>
        2. <ul>
    20. V
        1. <var>
        2. <video>
    21. W
        1. <wbr>
    22. X Y Z
        1. <xmp>