Calculation methodology and sources
How Choghadiya turns a selected place and date into local calendar values, and where astronomical calculation ends and tradition-specific interpretation begins.
Content reviewed
1. Place, date and time zone
You explicitly select a place. Its latitude and longitude are used for solar and horizon calculations, and its IANA time zone is used for local dates, clock times and daylight-saving changes. The device’s time zone is not silently substituted. Location names come from a bundled GeoNames-derived dataset.
2. Solar events and Choghadiya
Astronomy Engine calculates sunrise, sunset and the following sunrise. Daytime is divided from sunrise to sunset into eight equal intervals; nighttime is divided from sunset to the next sunrise. Traditional weekday sequences supply the names and qualities. Rahu Kaal and related warnings retain their documented weekday slots.
If polar conditions or another missing solar event prevent an interval from being formed, the result is unavailable. Choghadiya does not insert a standard 6:00 sunrise or copy another city’s times.
3. Panchang astronomy
Tithi and Karana follow the changing angular separation of the Moon and Sun. Nakshatra uses lunar longitude, Yoga uses combined solar and lunar longitude, and Vara follows the selected sunrise-based day. The displayed sunrise tithi is distinct from the tithi at the current moment.
Integer-millisecond interval endpoints are a software containment convention, not a claim of physical millisecond accuracy. Future time-zone rules and astronomical Delta-T also introduce uncertainty.
4. Festivals and calendar traditions
Astronomy alone does not choose every fasting or festival date. Choghadiya applies only named, documented rules for the tradition and observance profile you explicitly select. Regional variants, unsupported precedence and uncertain Sutak rules remain unresolved rather than being replaced with a nearby tithi.
5. Eclipse visibility
Global eclipse contacts, local physical contacts and intervals above the local horizon are kept separate. A global maximum is not presented as automatically visible from your city. Terrain and weather are not modeled.
References
- Astronomy Engine documentation and source — solar, lunar and eclipse calculations (MIT license).
- IANA Time Zone Database — named civil time-zone rules.
- GeoNames — geographical place data (CC BY 4.0).
- Dharma Sindhu working translation — named Smarta observance passages; not a universal rulebook.
- GCAL Events Documentation — the separately selected Gaudiya rule convention.
- Google’s guidance for AI features and Search and structured-data introduction — references for the website’s crawlable content and matching metadata, not for calendar calculations.
Validation and limitations
Automated tests cover astronomical boundaries, time-zone changes and documented rule branches. Independent reference comparisons are kept separate from the production engine; agreement between software packages does not establish religious authority or universal regional agreement.
To report a possible error, use the contact page and include the city, date, selected tradition and the value you expected. Return to the calculator or read the plain-language guides.