static json api
Based on data taken from the The United States Naval Observatory (USNO) api before it was taken down for maintenance. Reuse is with permission of USNO but they have not checked my work for errors and can not be held responsible for any errors hereinafter. Example of original response
All times are UTC as the moon appears in the same phase for all locations on the planet. Adjust for local time as required.
- moon-phase-data /api/moon-phase-data/{year}[/index.json]
- new-moon-data /api/new-moon-data/{year}[/index.json]
- lunar-solar-calendar /api/lunar-solar-calendar/{year}[/index.json]
Data can be served at {year} directory or optionally at {year}/index.json. Adding the index.json will negate a 301 redirect to increase the speed of request and may be required if your client does not support redirects.
| Min | Max |
|---|---|
| 1700 | 2082 |
e.g.
https://craigchamberlain.github.io/moon-data/api/moon-phase-data/2083 -> 404 File not found. Http Status Code
Returns a year's worth of DateTime and Phase objects. Phase is 0-3 for the quarters of a moon cycle as detailed in the table below with some sample representations. Date, is the instance when each event will occur or has occurred.
https://craigchamberlain.github.io/moon-data/api/moon-phase-data/1700/[index.json]
[{"Date":"1700-01-05T10:30:00","Phase":2},{"Date":"1700-01-12T03:34:00","Phase":3},{"Date":"1700-01-20T04:20:00","Phase":0},{"Date":"1700-01-28T05:13:00","Phase":1},{"Date":"1700-02-03T21:05:00","Phase":2},{"Date":"1700-02-10T18:59:00","Phase":3},{"Date":"1700-02-18T23:33:00","Phase":0},{"Date":"1700-02-26T16:37:00","Phase":1},...]
Where Phase =
| ID | Name | Alt. | ascii Art | UTF-8 | ascii |
|---|---|---|---|---|---|
| 0 | NewMoon | [____] |
🌑 (U+1F311; f0 9f 8c 91;) |
∙ (∙ ∙) |
|
| 1 | FirstQuarter | WaxingCrescent | `[__ | )_]` | 🌓 (U+1F313; f0 9f 8c 93;) |
| 2 | FullMoon | [_(_)_] |
🌕 (U+1F315; f0 9f 8c 95;) |
○ (○ ○) || ∘ (∘ ∘) |
|
| 3 | LastQuarter | WaningCrescent | `[_( | __]` | 🌗 (U+1F317; f0 9f 8c 97;) |
Returns a year's worth of DateTimes of the instances of a new moon.
https://craigchamberlain.github.io/moon-data/api/new-moon-data/1700/[index.json]
["1700-01-20T04:20:00","1700-02-18T23:33:00","1700-03-20T16:47:00","1700-04-19T06:51:00","1700-05-18T17:45:00","1700-06-17T02:16:00","1700-07-16T09:34:00","1700-08-14T16:47:00","1700-09-13T00:47:00","1700-10-12T10:15:00","1700-11-10T21:44:00","1700-12-10T11:44:00","1700-12-26T00:54:00"]
Returns a year's worth of Lunar Solar Months according to this specification in a DateTime and Number of Days pair. The date indicates the first day of the Lunar Solar month in UTC. A further process must be applied to output in the Lunisolar format specified or to convert any other given UTC time into the Lunisolar format.
https://craigchamberlain.github.io/moon-data/api/lunar-solar-calendar/1700/[index.json]
[{"Date":"1700-01-01T00:00:00","Days":19},{"Date":"1700-01-20T00:00:00","Days":29},{"Date":"1700-02-18T00:00:00","Days":30},{"Date":"1700-03-20T00:00:00","Days":30},{"Date":"1700-04-19T00:00:00","Days":29},{"Date":"1700-05-18T00:00:00","Days":30},{"Date":"1700-06-17T00:00:00","Days":29},{"Date":"1700-07-16T00:00:00","Days":29},{"Date":"1700-08-14T00:00:00","Days":30},{"Date":"1700-09-13T00:00:00","Days":29},{"Date":"1700-10-12T00:00:00","Days":29},{"Date":"1700-11-10T00:00:00","Days":30},{"Date":"1700-12-10T00:00:00","Days":22}]
API files are available as node package for hosting or accessing locally: https://github.com/CraigChamberlain/moon-data/packages/281384