Temporal.PlainTime.from()

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 statische Methode Temporal.PlainTime.from() erstellt ein neues Temporal.PlainTime-Objekt aus einem anderen Temporal.PlainTime-Objekt, einem Objekt mit Zeiteigenschaften oder einem RFC 9557-String.

Syntax

Temporal.PlainTime.from(info)
Temporal.PlainTime.from(info, options)

Parameter

info

Eines der folgenden:

Eine Temporal.PlainTime Instanz, die eine Kopie der Instanz erstellt.
Eine Temporal.PlainDateTime Instanz, die die Zeit auf die gleiche Weise bereitstellt wie Temporal.PlainDateTime.prototype.toPlainTime().
Eine Temporal.ZonedDateTime Instanz, die die Zeit auf die gleiche Weise bereitstellt wie Temporal.ZonedDateTime.prototype.toPlainTime().
Ein RFC 9557-String, der eine Zeit enthält.
Ein Objekt, das mindestens eine der folgenden Eigenschaften enthält (in der Reihenfolge, in der sie abgerufen und validiert werden):
Sie werden auf ganze Zahlen gekürzt. Werte außerhalb des zulässigen Bereichs werden durch die overflow-Option behandelt.

options Optional

Ein Objekt, das die folgende Eigenschaft enthält:

overflow Optional

Ein String, der das Verhalten definiert, wenn eine Zeitkomponente außerhalb des Bereichs liegt (bei Verwendung des Objekts info). Mögliche Werte sind:

"constrain" (Standard): Die Zeitkomponente wird auf den gültigen Bereich begrenzt.
"reject": Ein RangeError wird ausgelöst, wenn die Zeitkomponente außerhalb des Bereichs liegt.

Rückgabewert

Ein neues Temporal.PlainTime-Objekt, das die durch info angegebene Zeit darstellt.

Ausnahmen

TypeError

Wird in einem der folgenden Fälle ausgelöst:

info ist kein Objekt mit mindestens einer erkannten Eigenschaft oder ein String.
options ist kein Objekt oder undefined.

RangeError

Wird ausgelöst, wenn die bereitgestellten numerischen Eigenschaften außerhalb des Bereichs liegen und options.overflow auf "reject" gesetzt ist.

Beispiele

Ein PlainTime aus einem Objekt erstellen

const t1 = Temporal.PlainTime.from({ hour: 0 });
console.log(t1.toString()); // "00:00:00"

const t2 = Temporal.PlainTime.from({ hour: 12, minute: 34, second: 56 });
console.log(t2.toString()); // "12:34:56"

const t3 = Temporal.PlainTime.from({
  hour: 12,
  minute: 34,
  second: 56,
  millisecond: 123,
  microsecond: 456,
  nanosecond: 789,
});
console.log(t3.toString()); // "12:34:56.123456789"

Überlaufverhalten steuern

Standardmäßig werden Werte außerhalb des Bereichs auf den gültigen Bereich beschränkt:

const t1 = Temporal.PlainTime.from({ hour: 25 });
console.log(t1.toString()); // "23:00:00"

const t2 = Temporal.PlainTime.from({ hour: 25, minute: 60 });
console.log(t2.toString()); // "23:59:00"

Sie können dieses Verhalten ändern, um stattdessen einen Fehler auszulösen:

Temporal.PlainTime.from({ hour: 25 }, { overflow: "reject" });
// RangeError: time value "hour" not in 0..23: 25

Ein PlainTime aus einem String erstellen

const t1 = Temporal.PlainTime.from("12:34:56.123456789");
console.log(t1.toLocaleString("en-US", { timeStyle: "full" }));
// 12:34:56 PM

Ein PlainTime aus einer anderen Temporal-Instanz erstellen

const dt = Temporal.PlainDateTime.from("2021-07-01T12:00");
const t = Temporal.PlainTime.from(dt);
console.log(t.toString()); // "12:00:00"

const zdt = Temporal.ZonedDateTime.from(
  "2021-07-01T00:00+08:00[Asia/Shanghai]",
);
const t2 = Temporal.PlainTime.from(zdt);
console.log(t2.toString()); // "00:00:00"

const t3 = Temporal.PlainTime.from(t);
console.log(t3.toString()); // "12:00:00"

Spezifikationen

Specification
Temporal # sec-temporal.plaintime.from