Calendrical conversion library
This library is a straightfoward implementation and adaptation to TypeScript of the calendar computations featured in Edward M. Reingold and Nachum Dershowitz, Calendrical Calculations, The Millenium Edition, Cambridge University Press, 2001, also taking into account the errata published online. NB: a fourth edition was published in April 2018.
The arithmetic formulae are directly taken from Reingold & Dershowitz, with minor adaptations of the naming and cleaner structuring within namespaces.
For the purely astronomical calculations however, it relies mostly on the npm package astronomia, itself derived from the go package meeus.
Calendaria is the plural of the Latin word calendarium.
npm install --save calendaria
Make sure you add <meta charset="UTF-8"> to your HTML or at least include your
bundle with <script src="your-bundle.js" charset="UTF-8"></script> then
this package runs in modern browsers.
- Chrome: >=45
- Firefox: >= 45
- Safari: >=10
- Mobile Safari: >=10
- Edge: >=13
- IE: >=10 (needs
core-js/es6polyfill)
This package offers two complementary modules with a purely functional or purely OO approach, respectively.
import {Calendars} from 'calendaria'
let today = Calendars.Gregorian.toFixed(2018, 11, 11)
Calendars.Hebrew.fromFixed(today) // ...
Calendars.JD.fromFixed(today) // ...import {CalendarDate, CalendarType, DateBuilder} from 'calendaria'
let today = new CalendarDate()
today.convertTo(CalendarType.Hebrew)
// -> [yyyy,mm,dd,0,0,0]
...
let d = new DateBuilder(CalendarType.Coptic).year(1712).month(6).day(17).zone(2).build()
d.convertTo(CalendarType.Gregorian)npm test
If you contribute code to this project, you are implicitly allowing your code to be distributed under the MIT license.
You are also implicitly verifying that all code is your original work or correctly attributed with the source of its origin and licence.
MIT Licensed
See LICENSE for more info.