Temporal.PlainDateTime : méthode withPlainTime()

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 withPlainTime() des instances de Temporal.PlainDateTime retourne un nouvel objet Temporal.PlainDateTime représentant cette date et heure avec la partie temps entièrement remplacée par la nouvelle heure (sous une forme convertible par Temporal.PlainTime.from()).

Cette méthode remplacera toutes les propriétés de temps, en prenant 0 par défaut lorsque des propriétés ne sont pas définies. Si vous souhaitez uniquement remplacer certaines des propriétés de temps, utilisez plutôt la méthode with().

Syntaxe

withPlainTime()
withPlainTime(plainTime)

Paramètres

plainTime Facultatif: Une chaîne de caractères, un objet, ou une instance de Temporal.PlainTime représentant la nouvelle heure. Il est converti en un objet Temporal.PlainTime en utilisant le même algorithme que Temporal.PlainTime.from(). Si non défini, la partie temps est définie sur 00:00:00.

const dt = Temporal.PlainDateTime.from("2021-07-01T12:34:56");

// Vous pouvez passer une chaîne de caractères
const newDT = dt.withPlainTime("13:45:00");
console.log(newDT.toString()); // "2021-07-01T13:45:00"

// Vous pouvez seulement définir certaines propriétés de temps, et le reste passe à 0 ;
// pour la méthode with(), elles seraient copiées depuis la date et heure d'origine
const newDT2 = dt.withPlainTime({ hour: 13 });
console.log(newDT2.toString()); // "2021-07-01T13:00:00"

// Vous pouvez ne rien passer pour définir l'heure à minuit
const newDT3 = dt.withPlainTime();
console.log(newDT3.toString()); // "2021-07-01T00:00:00"