Temporal.PlainTime : méthode statique from()

Syntaxe

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

Paramètres

info

L'un des éléments suivants :

• Une instance de Temporal.PlainTime, qui crée une copie de l'instance.

• Une instance de Temporal.PlainDateTime, qui fournit l'heure de la même manière que Temporal.PlainDateTime.prototype.toPlainTime().

• Une instance de Temporal.ZonedDateTime, qui fournit l'heure de la même manière que Temporal.ZonedDateTime.prototype.toPlainTime().

• Une chaîne de caractères au format RFC 9557 contenant une heure.

• Un objet contenant au moins l'une des propriétés suivantes (dans l'ordre où elles sont récupérées et validées) :

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

  Ils sont tronqués pour être des entiers. Les valeurs hors plage sont gérées par l'option overflow.

options Facultatif

Un objet contenant la propriété suivante :

overflow Facultatif

Une chaîne de caractères définissant le comportement lorsqu'un composant temporel est hors plage (lors de l'utilisation de l'objet info). Les valeurs possibles sont :

"constrain" (par défaut)

Le composant temporel est limité à la plage valide.

"reject"

Une RangeError est levée si le composant temporel est hors plage.

Valeur de retour

Un nouvel objet Temporal.PlainTime, représentant l'heure définie par info.

Exceptions

TypeError

Levée dans l'un des cas suivants :

• info n'est pas un objet avec au moins une propriété reconnue ou une chaîne de caractères.
• options n'est pas un objet ou est undefined.

RangeError

Levée si les propriétés numériques fournies sont hors plage et que options.overflow est défini sur "reject".

Exemples

Créer un PlainTime à partir d'un objet

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"

Contrôler le comportement en cas de dépassement

Par défaut, les valeurs hors plage sont limitées à la plage valide :

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"

Vous pouvez changer ce comportement pour lever une erreur à la place :

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

Créer un PlainTime à partir d'une chaîne de caractères

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

Créer un PlainTime à partir d'une autre instance de Temporal

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"

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'objet Temporal.PlainTime
• Le constructeur Temporal.PlainTime()
• La méthode Temporal.PlainTime.prototype.with()