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 |