diff

function diff(
  left: Date,
  right: Date,
  unit: TimeUnit = "millisecond",
  float: boolean = false
): number;

Le résultat est la première date moins la seconde : il est donc négatif quand la seconde est postérieure. Des unités entières sont renvoyées par défaut ; passez float pour obtenir aussi la fraction.

Millisecondes, secondes, minutes et heures ont des longueurs fixes et sont divisées exactement. Jours, mois et années sont comptés en unités entières écoulées : deux heures de part et d'autre de minuit font donc 0 jour et non 1.

Paramètres

Paramètre	Type	Description
`left`	`Date`	La date depuis laquelle l'intervalle est mesuré.
`right`	`Date`	La date qui en est retranchée.
`unit` (facultatif) `= "millisecond"`	`TimeUnit`	`"millisecond"`, `"second"`, `"minute"`, `"hour"`, `"day"`, `"month"` ou `"year"`.
`float` (facultatif) `= false`	`boolean`	Conserver la partie fractionnaire au lieu de tronquer. Unités de longueur fixe seulement.

Valeur de retour

number — l'intervalle, négatif lorsque la seconde date est postérieure.

Exceptions

Exception	Condition
`IllegalArgumentException`	un argument n'est pas un `Date` valide, ou l'unité est inconnue.

Exemples

Mesurer un intervalle

diff(new Date(2026, 0, 31), new Date(2026, 0, 1), "day"); // => 30
diff(new Date(2026, 0, 1), new Date(2026, 0, 1, 12), "hour"); // => -12
diff(new Date(2026, 0, 2, 1), new Date(2026, 0, 1, 23), "day"); // => 0

Voir aussi

Code source

src/time/diff.ts

23 September 2026

Cette documentation a été générée par une IA (Claude) à partir du code source de la bibliothèque.