diff

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

Результат — первая дата минус вторая, поэтому он отрицателен, если вторая позже. По умолчанию возвращаются целые единицы; передайте float, чтобы получить и дробную часть.

Миллисекунды, секунды, минуты и часы имеют фиксированную длину и делятся точно. Дни, месяцы и годы считаются целыми прошедшими единицами — поэтому два часа через полночь дают 0 дней, а не 1.

Параметры

Параметр	Тип	Описание
`left`	`Date`	Дата, от которой отмеряется интервал.
`right`	`Date`	Дата, которая вычитается.
`unit` (необязательный) `= "millisecond"`	`TimeUnit`	`"millisecond"`, `"second"`, `"minute"`, `"hour"`, `"day"`, `"month"` или `"year"`.
`float` (необязательный) `= false`	`boolean`	Сохранить дробную часть вместо усечения. Только для единиц фиксированной длины.

Возвращает

number — интервал, отрицательный, если вторая дата позже.

Исключения

Исключение	Условие
`IllegalArgumentException`	аргумент не является корректным `Date` или единица неизвестна.

Примеры

Измерение интервала

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

Смотрите также

Исходный код

src/time/diff.ts

23 September 2026

Эта документация сгенерирована нейросетью (Claude) на основе исходного кода библиотеки.