2026-07-05 06:41:32 +00:00
"use strict" ;
Object . defineProperty ( exports , "__esModule" , {
value : true
} ) ;
exports . default = differenceInMonths ;
2026-07-07 07:11:50 +00:00
2026-07-05 06:41:32 +00:00
var _index = _interopRequireDefault ( require ( "../toDate/index.js" ) ) ;
2026-07-07 07:11:50 +00:00
2026-07-05 06:41:32 +00:00
var _index2 = _interopRequireDefault ( require ( "../differenceInCalendarMonths/index.js" ) ) ;
2026-07-07 07:11:50 +00:00
2026-07-05 06:41:32 +00:00
var _index3 = _interopRequireDefault ( require ( "../compareAsc/index.js" ) ) ;
2026-07-07 07:11:50 +00:00
2026-07-05 06:41:32 +00:00
var _index4 = _interopRequireDefault ( require ( "../_lib/requiredArgs/index.js" ) ) ;
2026-07-07 07:11:50 +00:00
2026-07-05 06:41:32 +00:00
var _index5 = _interopRequireDefault ( require ( "../isLastDayOfMonth/index.js" ) ) ;
2026-07-07 07:11:50 +00:00
function _interopRequireDefault ( obj ) { return obj && obj . _ _esModule ? obj : { default : obj } ; }
2026-07-05 06:41:32 +00:00
/**
* @name differenceInMonths
* @category Month Helpers
* @summary Get the number of full months between the given dates.
*
* @description
2026-07-07 07:11:50 +00:00
* Get the number of full months between the given dates.
*
* ### 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 full months
* @throws {TypeError} 2 arguments required
*
* @example
* // How many full months are between 31 January 2014 and 1 September 2014?
2026-07-07 07:11:50 +00:00
* var result = differenceInMonths(new Date(2014, 8, 1), new Date(2014, 0, 31))
2026-07-05 06:41:32 +00:00
* //=> 7
*/
function differenceInMonths ( dirtyDateLeft , dirtyDateRight ) {
( 0 , _index4 . default ) ( 2 , arguments ) ;
var dateLeft = ( 0 , _index . default ) ( dirtyDateLeft ) ;
var dateRight = ( 0 , _index . default ) ( dirtyDateRight ) ;
var sign = ( 0 , _index3 . default ) ( dateLeft , dateRight ) ;
var difference = Math . abs ( ( 0 , _index2 . default ) ( dateLeft , dateRight ) ) ;
2026-07-07 07:11:50 +00:00
var result ; // Check for the difference of less than month
2026-07-05 06:41:32 +00:00
if ( difference < 1 ) {
result = 0 ;
} else {
if ( dateLeft . getMonth ( ) === 1 && dateLeft . getDate ( ) > 27 ) {
// This will check if the date is end of Feb and assign a higher end of month date
// to compare it with Jan
dateLeft . setDate ( 30 ) ;
}
2026-07-07 07:11:50 +00:00
dateLeft . setMonth ( dateLeft . getMonth ( ) - sign * difference ) ; // Math.abs(diff in full months - diff in calendar months) === 1 if last calendar month is not full
2026-07-05 06:41:32 +00:00
// If so, result must be decreased by 1 in absolute value
2026-07-07 07:11:50 +00:00
var isLastMonthNotFull = ( 0 , _index3 . default ) ( dateLeft , dateRight ) === - sign ; // Check for cases of one full calendar month
2026-07-05 06:41:32 +00:00
if ( ( 0 , _index5 . default ) ( ( 0 , _index . default ) ( dirtyDateLeft ) ) && difference === 1 && ( 0 , _index3 . default ) ( dirtyDateLeft , dateRight ) === 1 ) {
isLastMonthNotFull = false ;
}
2026-07-07 07:11:50 +00:00
result = sign * ( difference - isLastMonthNotFull ) ;
} // Prevent negative zero
2026-07-05 06:41:32 +00:00
return result === 0 ? 0 : result ;
}
2026-07-07 07:11:50 +00:00
2026-07-05 06:41:32 +00:00
module . exports = exports . default ;