Temporal.Instant : méthode subtract()

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 subtract() des instances de Temporal.Instant retourne un nouvel objet Temporal.Instant représentant cet instant reculé d'une durée donnée (sous une forme convertible par Temporal.Duration.from()).

Si vous souhaitez soustraire deux instants et obtenir une durée, utilisez plutôt since() ou until().

Syntaxe

subtract(duration)

Paramètres

duration: Une chaîne de caractères, un objet ou une instance de Temporal.Duration représentant une durée à soustraire de cet instant. Elle est convertie en objet Temporal.Duration en utilisant le même algorithme que Temporal.Duration.from().

Valeur de retour

Un nouvel objet Temporal.Instant représentant la soustraction de duration de cet instant. Si duration est positive, l'instant retourné est antérieur à cet instant ; si duration est négative, l'instant retourné est postérieur à cet instant.

Exceptions

RangeError

Levée dans l'un des cas suivants :

duration est une durée calendaire (elle a des years, months ou weeks non nuls), ou a des days non nuls, car les durées calendaire sont ambiguës sans un calendrier et une référence temporelle.
Le résultat n'est pas dans la plage représentable, qui est ±10⁸ jours, soit environ ±273 972,6 ans, depuis l'époque Unix.

const instant = Temporal.Instant.fromEpochMilliseconds(1000);
const duration = Temporal.Duration.from("PT1S"); // Durée d'une seconde
const newInstant = instant.subtract(duration);
console.log(newInstant.epochMilliseconds); // 0

Pour plus d'exemples, voir add().