HTMLTimeElement .dateTime 特性为 DOMString that reflects the datetime HTML attribute, containing a machine-readable form of the element's date and time value.

The format of the string must follow one of the following HTML microsyntaxes:

Microsyntax 描述 范例
Valid month string YYYY - MM 2011-11 , 2013-05
Valid date string YYYY - MM - DD 1887-12-01
Valid yearless date string MM - DD 11-12
Valid time string HH : MM
HH : MM : SS
HH : MM : SS . mmm
23:59
12:15:47
12:15:52.998
Valid local date and time string YYYY - MM - DD HH : MM
YYYY - MM - DD HH : MM : SS
YYYY - MM - DD HH : MM : SS . mmm
YYYY - MM - DD T HH : MM
YYYY - MM - DD T HH : MM : SS
YYYY - MM - DD T HH : MM : SS . mmm
2013-12-25 11:12
1972-07-25 13:43:07
1941-03-15 07:06:23.678
2013-12-25T11:12
1972-07-25T13:43:07
1941-03-15T07:06:23.678
Valid time-zone offset string Z
+ HHMM
+
HH : MM
- HHMM
-
HH : MM
Z
+0200
+04:30
-0300
-08:00
Valid global date and time string Any combination of a valid local date and time string followed by a valid time-zone offset string 2013-12-25 11:12+0200
1972-07-25 13:43:07+04:30
1941-03-15 07:06:23.678Z
2013-12-25T11:12-08:00
Valid week string YYYY -W WW 2013-W46
Four or more ASCII digits YYYY 2013 , 0001
Valid duration string P d D T h H m M s S
P d D T h H m M s . X S
P d D T h H m M s . XX S
P d D T h H m M s . XXX S
P T h H m M s S
P T h H m M s . X S
P T h H m M s . XX S
P T h H m M s . XXX S
w w d d h h m m s s
P12DT7H12M13S
P12DT7H12M13.3S
P12DT7H12M13.45S
P12DT7H12M13.455S
PT7H12M13S
PT7H12M13.2S
PT7H12M13.56S
PT7H12M13.999S
7d 5h 24m 13s

句法

dateTimeString = timeElt.dateTime;
timeElt.dateTime = dateTimeString
					

范例

// Assumes there is <time id="t"> element in the HTML
var t = document.getElementById("t");
t.dateTime = "6w 5h 34m 5s";
					

规范

规范 状态 注释
HTML 实时标准
The definition of 'HTMLTimeElement' in that specification.
实时标准 无变化自 HTML 5.1 .
HTML 5.1
The definition of 'HTMLTimeElement' in that specification.
推荐 无变化自 HTML5 .
HTML5
The definition of 'HTMLTimeElement' 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
dateTime Chrome 62 Edge 14 Firefox 22 IE 不支持 No Opera 49
49
11.5 — 15
Safari 10 WebView Android 62 Chrome Android 62 Firefox Android 22 Opera Android 46
46
11.5 — 14
Safari iOS 10 Samsung Internet Android 8.0

图例

完整支持

完整支持

不支持

不支持

另请参阅

元数据

  • 最后修改:
  1. HTMLTimeElement
  2. 特性
    1. dateTime
  3. 继承:
    1. HTMLElement
    2. 元素
    3. 节点
    4. EventTarget
  4. HTML DOM 相关页面
    1. BeforeUnloadEvent
    2. DOMStringMap
    3. ErrorEvent
    4. GlobalEventHandlers
    5. HTMLAnchorElement
    6. HTMLAreaElement
    7. HTMLAudioElement
    8. HTMLBRElement
    9. HTMLBaseElement
    10. HTMLBaseFontElement
    11. HTMLBodyElement
    12. HTMLButtonElement
    13. HTMLCanvasElement
    14. HTMLContentElement
    15. HTMLDListElement
    16. HTMLDataElement
    17. HTMLDataListElement
    18. HTMLDialogElement
    19. HTMLDivElement
    20. HTMLDocument
    21. HTMLElement
    22. HTMLEmbedElement
    23. HTMLFieldSetElement
    24. HTMLFormControlsCollection
    25. HTMLFormElement
    26. HTMLFrameSetElement
    27. HTMLHRElement
    28. HTMLHeadElement
    29. HTMLHeadingElement
    30. HTMLHtmlElement
    31. HTMLIFrameElement
    32. HTMLImageElement
    33. HTMLInputElement
    34. HTMLIsIndexElement
    35. HTMLKeygenElement
    36. HTMLLIElement
    37. HTMLLabelElement
    38. HTMLLegendElement
    39. HTMLLinkElement
    40. HTMLMapElement
    41. HTMLMediaElement
    42. HTMLMetaElement
    43. HTMLMeterElement
    44. HTMLModElement
    45. HTMLOListElement
    46. HTMLObjectElement
    47. HTMLOptGroupElement
    48. HTMLOptionElement
    49. HTMLOptionsCollection
    50. HTMLOutputElement
    51. HTMLParagraphElement
    52. HTMLParamElement
    53. HTMLPictureElement
    54. HTMLPreElement
    55. HTMLProgressElement
    56. HTMLQuoteElement
    57. HTMLScriptElement
    58. HTMLSelectElement
    59. HTMLShadowElement
    60. HTMLSourceElement
    61. HTMLSpanElement
    62. HTMLStyleElement
    63. HTMLTableCaptionElement
    64. HTMLTableCellElement
    65. HTMLTableColElement
    66. HTMLTableDataCellElement
    67. HTMLTableElement
    68. HTMLTableHeaderCellElement
    69. HTMLTableRowElement
    70. HTMLTableSectionElement
    71. HTMLTemplateElement
    72. HTMLTextAreaElement
    73. HTMLTitleElement
    74. HTMLTrackElement
    75. HTMLUListElement
    76. HTMLUnknownElement
    77. HTMLVideoElement
    78. HashChangeEvent
    79. 历史
    80. ImageData
    81. 定位
    82. MessageChannel
    83. MessageEvent
    84. MessagePort
    85. Navigator
    86. NavigatorGeolocation
    87. NavigatorID
    88. NavigatorLanguage
    89. NavigatorOnLine
    90. NavigatorPlugins
    91. PageTransitionEvent
    92. Plugin
    93. PluginArray
    94. PopStateEvent
    95. PortCollection
    96. PromiseRejectionEvent
    97. RadioNodeList
    98. Transferable
    99. ValidityState
    100. Window
    101. WindowBase64
    102. WindowEventHandlers
    103. WindowTimers