1. 開発者向けのウェブ技術
  2. JavaScript
  3. JavaScript リファレンス
  4. 標準組み込みオブジェクト
  5. Date
  6. Date.prototype.toTemporalInstant()

このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

Date.prototype.toTemporalInstant()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

toTemporalInstant() は Date インスタンスのメソッドで、新しい Temporal.Instant オブジェクトを作成し、 epochMilliseconds 値をこの日時のタイムスタンプと同にして返します。

このメソッドを使用して、古い Date 値を Temporal API に変換し、必要に応じて他の Temporal クラスにさらに変換してください。

構文

js
toTemporalInstant()

引数

なし。

返値

新しい Temporal.Instant オブジェクトで、この日時のタイムスタンプと同じ epochMilliseconds 値を持ちます。マイクロ秒およびナノ秒の要素は常に 0 です。

例外

RangeError

この日時が無効（タイムスタンプが NaN）である場合。

例

toTemporalInstant() の使用

js
const legacyDate = new Date("2021-07-01T12:34:56.789Z");
const instant = legacyDate.toTemporalInstant();

// 更に他のオブジェクトに変換
const zdt = instant.toZonedDateTimeISO("UTC");
const date = zdt.toPlainDate();
console.log(date.toString()); // 2021-07-01

仕様書

Specification
Temporal
# sec-date.prototype.totemporalinstant

ブラウザーの互換性

関連情報

Help improve MDN

Learn how to contribute

This page was last modified on by MDN contributors.

View this page on GitHub • Report a problem with this content