Calculate

Date arithmetic, differences, and business day calculations

Edit and run examples against `ts-time-utils@4.4.1` in your browser.

Date Differences

Calculate the difference between dates in any unit

index.ts

import { differenceInUnits, differenceInCalendarDays, addTime, subtractTime } from 'ts-time-utils/calculate';

const date1 = new Date('2025-01-01');
const date2 = new Date('2025-09-14');

// Get difference in various units
console.log(differenceInUnits(date1, date2, 'days'));
// 256

console.log(differenceInUnits(date1, date2, 'months'));
// 8

console.log(differenceInUnits(date1, date2, 'weeks'));
// 36

// Count local calendar date boundaries, ignoring time of day
console.log(differenceInCalendarDays(
  new Date('2026-05-22T21:17:00'),
  new Date('2026-05-24T00:00:00')
));
// 2

// Add/subtract time
console.log(addTime(new Date(), 5, 'hours'));
console.log(subtractTime(new Date(), 3, 'days'));

Console

Press Run to execute the example.

Start/End of Period

Get the start or end of time periods

index.ts

import { startOf, endOf, businessDaysBetween } from 'ts-time-utils/calculate';

const date = new Date('2025-09-14T14:30:45');

// Start of periods
console.log(startOf(date, 'day'));
// 2025-09-14T00:00:00

console.log(startOf(date, 'week'));
// Start of week

console.log(startOf(date, 'month'));
// 2025-09-01T00:00:00

// End of periods
console.log(endOf(date, 'day'));
// 2025-09-14T23:59:59.999

console.log(endOf(date, 'month'));
// 2025-09-30T23:59:59.999

// Business days
const start = new Date('2025-09-01');
const end = new Date('2025-09-30');
console.log(businessDaysBetween(start, end));
// Number of weekdays in September

Console

Press Run to execute the example.