Temporal.PlainTime : méthode with()
Disponibilité limitée
Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.
La méthode with() des instances de Temporal.PlainTime retourne un nouvel objet Temporal.PlainTime représentant cette heure avec certains champs remplacés par de nouvelles valeurs. Comme tous les objets Temporal sont conçus pour être immuables, cette méthode fonctionne essentiellement comme un mutateur pour les champs de l'heure.
Syntaxe
with(info)
with(info, options)
Paramètres
info-
Un objet contenant au moins une des propriétés reconnues par
Temporal.PlainTime.from():hour,microsecond,millisecond,minute,nanosecond,second. Les propriétés non définies utilisent les valeurs de l'heure originale. optionsFacultatif-
Un objet contenant la propriété suivante :
overflowFacultatif-
Une chaîne de caractères définissant le comportement lorsque un composant de l'heure est hors de portée. Les valeurs possibles sont :
"constrain"(par défaut)-
Le composant de l'heure est limité à la plage valide.
"reject"-
Un objet
RangeErrorest levé si le composant de l'heure est hors de portée.
Valeur de retour
Un nouvel objet Temporal.PlainTime, où les champs définis dans info qui ne sont pas undefined sont remplacés par les valeurs correspondantes, et le reste des champs est copié à partir de l'heure originale.
Exceptions
TypeError-
Levée dans l'un des cas suivants :
infon'est pas un objet avec au moins une propriété reconnue ou une chaîne de caractères.optionsn'est pas un objet ouundefined.
RangeError-
Levée si les propriétés numériques fournies sont hors de portée et que
options.overflowest défini sur"reject".
Exemples
Utiliser la méthode with()
const time = Temporal.PlainTime.from("12:34:56.123456789");
const newTime = time.with({ hour: 23 });
console.log(newTime.toString()); // '23:34:56.123456789'
Pour plus d'exemples, consultez la documentation des propriétés individuelles qui peuvent être définies à l'aide de with().
Spécifications
| Spécification |
|---|
| Temporal # sec-temporal.plaintime.prototype.with |
Compatibilité des navigateurs
Voir aussi
- L'objet
Temporal.PlainTime - La méthode statique
Temporal.PlainTime.from() - La méthode
Temporal.PlainTime.prototype.add() - La méthode
Temporal.PlainTime.prototype.subtract()