Temporal.PlainTime.from()

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):

  • hour
  • microsecond
  • millisecond
  • minute
  • nanosecond
  • second

  Sie werden auf Ganzzahlen gekürzt. Werte außerhalb des gültigen Bereichs werden durch die overflow-Option behandelt.

options Optional

Ein Objekt, das die folgende Eigenschaft enthält:

overflow Optional

Ein String, der das Verhalten angibt, wenn ein Zeitbestandteil außerhalb des gültigen Bereichs liegt (bei Verwendung des Objekts info). Mögliche Werte sind:

"constrain" (Standard)

Der Zeitbestandteil wird auf den gültigen Bereich eingegrenzt.

"reject"

Ein RangeError wird ausgelöst, wenn der Zeitbestandteil außerhalb des gültigen 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 anerkannten Eigenschaft oder kein String.
• options ist kein Objekt oder undefined.

RangeError

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

Beispiele

Erstellen eines PlainTime aus einem Objekt

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"

Kontrollieren des Überlaufverhaltens

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

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

Erstellen eines PlainTime aus einem String

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

Erstellen eines PlainTime aus einer anderen Temporal-Instanz

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

Browser-Kompatibilität

Siehe auch

• Temporal.PlainTime
• Temporal.PlainTime()
• Temporal.PlainTime.prototype.with()