2026-07-05 06:41:32 +00:00
import getTimezoneOffsetInMilliseconds from "../_lib/getTimezoneOffsetInMilliseconds/index.js" ;
import startOfISOWeek from "../startOfISOWeek/index.js" ;
import requiredArgs from "../_lib/requiredArgs/index.js" ;
var MILLISECONDS _IN _WEEK = 604800000 ;
/**
* @name differenceInCalendarISOWeeks
* @category ISO Week Helpers
* @summary Get the number of calendar ISO weeks between the given dates.
*
* @description
* Get the number of calendar ISO weeks between the given dates.
*
* ISO week-numbering year: http://en.wikipedia.org/wiki/ISO_week_date
*
2026-07-07 07:11:50 +00:00
* ### v2.0.0 breaking changes:
*
* - [Changes that are common for the whole library](https://github.com/date-fns/date-fns/blob/master/docs/upgradeGuide.md#Common-Changes).
*
2026-07-05 06:41:32 +00:00
* @param {Date|Number} dateLeft - the later date
* @param {Date|Number} dateRight - the earlier date
* @returns {Number} the number of calendar ISO weeks
* @throws {TypeError} 2 arguments required
*
* @example
* // How many calendar ISO weeks are between 6 July 2014 and 21 July 2014?
2026-07-07 07:11:50 +00:00
* var result = differenceInCalendarISOWeeks(
2026-07-05 06:41:32 +00:00
* new Date(2014, 6, 21),
* new Date(2014, 6, 6)
* )
* //=> 3
*/
2026-07-07 07:11:50 +00:00
2026-07-05 06:41:32 +00:00
export default function differenceInCalendarISOWeeks ( dirtyDateLeft , dirtyDateRight ) {
requiredArgs ( 2 , arguments ) ;
var startOfISOWeekLeft = startOfISOWeek ( dirtyDateLeft ) ;
var startOfISOWeekRight = startOfISOWeek ( dirtyDateRight ) ;
var timestampLeft = startOfISOWeekLeft . getTime ( ) - getTimezoneOffsetInMilliseconds ( startOfISOWeekLeft ) ;
2026-07-07 07:11:50 +00:00
var timestampRight = startOfISOWeekRight . getTime ( ) - getTimezoneOffsetInMilliseconds ( startOfISOWeekRight ) ; // Round the number of days to the nearest integer
2026-07-05 06:41:32 +00:00
// because the number of milliseconds in a week is not constant
// (e.g. it's different in the week of the daylight saving time clock shift)
2026-07-07 07:11:50 +00:00
2026-07-05 06:41:32 +00:00
return Math . round ( ( timestampLeft - timestampRight ) / MILLISECONDS _IN _WEEK ) ;
}