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) на основі вихідного коду бібліотеки.