大网数据广告活动
Web 标准与前端开发

HTMLMediaElement: getStartDate() method

· 52CE 我爱测

The **`getStartDate()`** method of the HTMLMediaElement interface returns a new Date object representing the real-world date and time corresponding to the beginning of the media.

HTML DOM

The getStartDate() method of the HTMLMediaElement interface returns a new Date object representing the real-world date and time corresponding to the beginning of the media.

This is useful for media streams that are anchored to a real-world clock, such as a live broadcast that began at a specific date and time. For media that does not include date and time information, the returned Date object will have a time value of NaN.

Syntax

getStartDate()

Parameters

None.

Return value

A Date object representing the start date and time of the media. If the media does not include date and time information, the returned Date object will have a time value of NaN.

Description

Internally, each media element tracks a start date, which begins as NaN (not set). Once the browser has loaded enough data to read the media's metadata, it sets the start date to the real-world time that corresponds to the beginning of the media — if the format provides one. If it doesn't, the start date stays NaN.

For media that does specify a start time and date (for example, a live TV broadcast streamed over the web), getStartDate() returns a Date object corresponding to the real-world time at which the media begins. This allows media player controls to display absolute times (such as "2:30 PM") rather than times relative to the start of playback (such as "3 hours, 12 minutes").

The returned Date will have a time value of NaN (making it an invalid date) in either of the following cases:

  • No data has been loaded yet (HTMLMediaElement.readyState is HAVE_NOTHING), so the start date hasn't been set.
  • The media format doesn't include date and time information.

The start date is not guaranteed to be available as soon as the HTMLMediaElement/loadedmetadata_event event fires. For example, HLS streams carry dates in segment-level #EXT-X-PROGRAM-DATE-TIME tags, which may not have been read yet at that point. Listening for the HTMLMediaElement/loadeddata_event event instead is more reliable across formats, because by then the browser has loaded enough data to determine the start date.

Examples

Displaying the start date of a live stream

This example retrieves the start date of a live stream — the real-world date and time at which the broadcast began, as embedded in the stream by the server — and displays it. It listens for the HTMLMediaElement/loadeddata_event event, which fires once enough data has been loaded for the start date to be available.

HTML

<video src="livestream.m3u8" controls></video>
<output>Start date: loading…</output>

JavaScript

const video = document.querySelector("video");
const display = document.querySelector("output");

video.addEventListener("loadeddata", () => {
  const startDate = video.getStartDate();

  if (isNaN(startDate.getTime())) {
    display.textContent = "Start date: not available";
  } else {
    display.textContent = `Start date: ${startDate.toLocaleString()}`;
  }
});

Result

The output below shows the start date of the media, as provided by the server. Note that this is encoded in the example metadata in stream.m3u8.

dom-examples/media/getstartdate/

Specifications

Browser compatibility

See also

  • HTMLMediaElement
  • HTMLMediaElement.currentTime
  • HTMLMediaElement.duration

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。