Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including calendar-dates with all npm packages installed. Try it out:

var calendarDates = require("calendar-dates")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

calendar-dates v2.6.1

Get calendar dates for a given month - Mostly for creating a custom calendar control


All Contributors Minzipped Size Minified Size
Maintainability Test Coverage Known Vulnerabilities


📆 Get a list of calendar dates with no external dependencies.

You can use this to create your own calendar controls

🗜️ Installation

npm i calendar-dates
# or
yarn add calendar-dates

How to use it

Full documentation.

Change Log


Fix data for December and January dates #33 by ewolfe. Decided to bump up the minor as it was a significant bug fix.

Decision based on React team's decision (even though this is not a React component) on releasing v16.7 not including Hooks.


Fixed ISO8601 date return value to match current date.

  • Thank you again ewolfe 👊.


  1. Returns ISO8601 date.
  2. Removed package-lock.json, which was accidentally added by using npm instead of yarn.


Removed all methods except two methods, which return a promise.

  1. getDates(date)
  2. getMatrix(date)

Following methods are removed

  1. getDatesAsync
  2. getMatrixAsync
  3. getDatesWithMetadata
  4. getDatesWithMetadataAsync
  5. getMatrixWithMetadata
  6. getMatrixWithMetadataAsync


Updated README to include *WithMetadata examples


Fixed runtimeGenerator issue


Added *WithMetadata methods


Added "*Async" versions


FOSSA Status


Thanks goes to these wonderful people (emoji key):

| [Sung Kim
Sung Kim](
[💻]( "Code") [🎨](#design-dance2die "Design") [⚠️]( "Tests") | [ewolfe
[💻]( "Code") [⚠️]( "Tests") | [Dave Follett
Dave Follett](
[📖]( "Documentation") | | :---: | :---: | :---: |

This project follows the all-contributors specification. Contributions of any kind welcome!

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free