🚧 This Package Is Depreacted 🚧
This package is deprecated in favor of @jsbits/add-months.
Unlike addMonths, @jsbits/add-months handles changes in the timezone correctly, has better support, 100% coverage, and the version for
Date.prototype is more consistent with other Date methods.
This package will no longer be updated
npm i addmonths --save
bower install addmonths --save
<!-- ...or to inject `addMonths` to `Date.prototype` -->
addMonths function returns a date occurring
count months after
startdate or, if
count is negative, the date occurring
count months before
If there is an overflow in the day, the date is adjusted to the last valid day of the expected month.
startdate is not a date, returns
startdate without changes.
startdate is an invalid date (i.e.
NaN), returns a new
Date instance with an invalid date.
count is evaluated as zero, returns a new
Date instance with the same value as
const addMonths =// 2017-01-01 ==> 2017-03-01// 2017-01-01 ==> 2016-12-01// 2016-01-31 ==> 2016-02-29// new instance with the same value// the same string
If you prefer, you can inject the function into the
Date prototype of Date requiring "auto" or by loading the IIFE from "dist/addmonths.auto.js" in your browser:
const date =
- Production ready version.
- Updated tests.
- Updated devDependencies.
The MIT License (MIT)
Copyright (c) 2017 Alberto Martínez (https://github.com/aMarCruz)