prayer-times-calculator-offline 1.0.1

Prayer Times Calculator - Offline

Prayer Times Calculator - Offline

Not designed as a general purpose prayer time library. This is meant as a cloud-free, drop-in replacement for prayer-times-calculator, which in turn is used by the Islamic Prayer Times HomeAssistant integration.

Equivalence to the prayer-times-calculator library was checked by emperical comparison of 50,000 requests (each with randomized parameters). The original intention was to replicate the output exactly, however please note the following exceptions where prayer-times-calculator-offline will return a different result than prayer-times-calculator for the same call:

• Asr calculation is stable; at time of writing, AlAdhan's API uses the API server's local time as part of the Asr calculation, causing the returned time to drift as the server's day progresses.
• ISO8601 date components are correct; at time of writing, AlAdhan's API sometime returns ISO8601 timestamps with correct times but incorrect dates.
  • E.g. this API call where all timestamps are returned with the same date component, making Isha appear to happen before Maghrib and Fajr appear to happen after Sunrise
• Portugal Maghrib tuning applied correctly; At time of writing, AlAdhan's API maps the Asr tuning value to Maghrib
• Local time output (iso8601=False) is not supported, as it is not required for use in HomeAssistant (which deals only with UTC internally)
• 'None' is supported as a high-latitude adjustment method
• Angles of 0 are supported for the "custom" calculation method; at time of writing, AlAdhan's API silently ignores such angles and uses a different default angle in their place.
• Floating point computations take place on your CPU, which may vary from the AlAdhan API server's CPU; there may be 1-minute differences if these computational variations span a rounding break. Hijri date calculation may also be affected, including the 30-minute Isha offset during Ramadan when using the Makkah calculation method.

The remainder of this README is based on that from prayer-times-calculator.

Usage

Please refer to the usage section of prayer-times-calculator.