Temporal.ZonedDateTime.prototype.offsetNanoseconds

Limited availability

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

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die offsetNanoseconds Accessor-Eigenschaft von Temporal.ZonedDateTime Instanzen gibt eine Ganzzahl zurück, die den Offset darstellt, der verwendet wird, um den internen Zeitpunkt in Nanosekunden (positiv oder negativ) zu interpretieren. Der Wert ist eine sichere Ganzzahl, da er weniger als ein Tag beträgt, was 8.64e15 Nanosekunden entspricht.

Der Set-Accessor von offsetNanoseconds ist undefined. Sie können diese Eigenschaft nicht direkt ändern. Ändern Sie offset, um diese Eigenschaft ebenfalls zu ändern.

Beispiele

Verwendung von offsetNanoseconds

js
const dt = Temporal.ZonedDateTime.from(
  "2021-07-01T12:00:00-07:00[America/Los_Angeles]",
);
console.log(dt.offsetNanoseconds); // -25200000000000

const dt2 = Temporal.ZonedDateTime.from(
  "2021-07-01T12:00:00+08:00[Asia/Shanghai]",
);
console.log(dt2.offsetNanoseconds); // 28800000000000

const dt3 = Temporal.ZonedDateTime.from(
  "1900-01-01T00:00:00+00:09:21[Europe/Paris]",
);
console.log(dt3.offsetNanoseconds); // 561000000000

Hier ist eine Möglichkeit, einen ZonedDateTime zu erhalten, der die gleiche Uhrzeit in UTC darstellt:

js
const dt = Temporal.ZonedDateTime.from(
  "2021-07-01T12:00:00-07:00[America/Los_Angeles]",
);
const dtInUTC = dt.add({ nanoseconds: dt.offsetNanoseconds });
console.log(dtInUTC.withTimeZone("UTC").toString()); // "2021-07-01T12:00:00+00:00[UTC]"

Hier ist eine bessere Möglichkeit, das gleiche Ergebnis zu erzielen:

js
const dt = Temporal.ZonedDateTime.from(
  "2021-07-01T12:00:00-07:00[America/Los_Angeles]",
);
const dtInUTC = dt.toPlainDateTime().toZonedDateTime("UTC");
console.log(dtInUTC.toString()); // "2021-07-01T12:00:00+00:00[UTC]"

Spezifikationen

Specification
Temporal
# sec-get-temporal.zoneddatetime.prototype.offsetnanoseconds

Browser-Kompatibilität

Siehe auch