Chinese years

a simple NPM package to tell you what Chinese zodiac name in a certain year.

npm i chinese-year



I created this repo out of a heat of the moment, especially after seeing this repo, which only stored a few JSON data with some simple API representing logics. The message was clear; I could make an elegant somehow useful package in NPM myself.

About the API

The logic was straightforward; I had 12 animals’ name stored in an object and then created two functions: one for exporting all the data in the object; one for getting a name every zodiacal period(12 years). If not, throw an error.


I use Jest for testing, and again, the logic is simple, since the results only have 13 possible outputs. Also, I have continuous testing implemented.

Tagged withnpm, nodejs, javascript, package

Questions, Comments, Suggestions?Open an Issue