Data Sources
Primary Source
Section titled “Primary Source”Calendar data is sourced from data published publicly by the Ministry of Religious Affairs of the Republic of Indonesia (Kemenag RI) — the MABIMS calendar tables issued annually.
| Property | Value |
|---|---|
| Source | Ministry of Religious Affairs of the Republic of Indonesia — Hijri Calendar |
| Original format | |
| Table coverage | 2023-01-23 → 2026-12-31 |
Computed Tier
Section titled “Computed Tier”Beyond table coverage, the API computes dates using Neo MABIMS criteria (see also the official government announcement via Setkab):
| Parameter | Threshold |
|---|---|
| Moon altitude (topocentric, refraction-corrected) | ≥ 3.0° |
| Elongation (geocentric) | ≥ 6.4° |
| Observation points | 25 coastal sites across Indonesia — fulfilled at any single point → 29-day month (site list) |
| Reference time | At each site’s local sunset (day 29) |
Map data
Section titled “Map data”The map card (/hilal/map) uses the following geographic data:
| Layer | Source | License |
|---|---|---|
| Indonesian landmass + province borders | superpikar/indonesia-geojson | per source repo |
| Surrounding countries | Natural Earth 1:110m admin-0 | Public domain |
| Display points (95) | derived from a 126-city list + the 25 MABIMS observation sites | — |
Retro (below the curated table)
Section titled “Retro (below the curated table)”Dates before 2023-01-23 were never produced under the Neo MABIMS criteria (introduced in 2022). Passing retro=true unlocks computed dates below the curated table down to 1945-01-01, tagged source: "mabims-retro" with a warning that these are a retrospective projection — not official data.
Licensing
Section titled “Licensing”Calendar data is sourced from Indonesian government publications for public use. API source code is licensed under the MIT License.