Skip to content

daysDifference

Gets the difference in days between two dates.

Available since v2.0.0

import { daysDifference } from '@helpers4/date';
daysDifference(date1: Date, date2: Date): number
ParameterTypeDescription
date1DateFirst date
date2DateSecond date

number — Number of days difference (rounded)

Returns the absolute number of days between two dates.

daysDifference(new Date('2025-01-01'), new Date('2025-01-10'))
// => 9

Options for date difference calculation

interface DateDifferenceOptions {
  absolute?: boolean;
  unit?: DifferenceUnit;
}

Unit for date difference calculation

type DifferenceUnit = 'milliseconds' | 'seconds' | 'minutes' | 'hours' | 'days'

View source on GitHub