PrayerTimes

Pray Times is an Islamic project aimed at providing an open-source library for calculating Muslim prayer times. The first version of Pray Times was released in early 2007. The code is currently used in a wide range of Islamic websites and applications. 🔗 http://praytimes.org/

• User's Manual: http://praytimes.org/manual
• Calculation Formulas: http://praytimes.org/calculation

Compatible with Python 3.x Improved version: PEP8 compliant, bugs fixed, and ready to use

---

Features

• Various methods of time calculation
• Global location support
• Local prayer time calculation (no internet required)
• Multiple time formats
• Time adjustments
• No external dependencies

---

Prerequisites

Make sure you have the following installed:

• Git
• Python 3.x

---

Installation

git clone https://github.com/QuantumPrayerTimes/prayertimes.git
cd prayertimes
python setup.py install

---

Usage

Available Calculation Methods

Method	Description
MWL	Muslim World League
ISNA	Islamic Society of North America
Egypt	Egyptian General Authority of Survey
Makkah	Umm al-Qura University
Karachi	University of Islamic Sciences, Karachi
Tehran	Institute of Geophysics, University of Tehran
Jafari	Shia Ithna Ashari (Jafari)
UOIF	Union of Islamic Organizations of France
Singapore	Majlis Ugama Islam Singapura
Turkey	Diyanet İşleri Başkanlığı

---

Using Today's Date

from prayertimes import PrayTimes
import datetime

today = datetime.datetime.today()

# Using ISNA method
pt = PrayTimes(method='ISNA')

# Get times using UTC offset
times = pt.get_times(today, (43, -80), -5)

# Or using a timezone string
times = pt.get_times(today, (43, -80), "America/New_York")

---

Using a Specific Date

from prayertimes import PrayTimes

pt = PrayTimes(method='ISNA')

# February 25, 2011 at location (43, -80)
times = pt.get_times((2011, 2, 25), (43, -80), -5)

---

Available Time Formats

Format	Description	Example
24h	24-hour format	16:45
12h	12-hour format with suffix	4:45 pm
12hNS	12-hour format no suffix	4:45
Float	Decimal hours (floating point)	16.75

---

Changing Time Format

from prayertimes import PrayTimes

pt = PrayTimes('ISNA')

# Set 12-hour format
pt.time_format = '12h'

times = pt.get_times((2011, 2, 25), (43, -80), -5)

---

Asr Methods

Method	Description
Standard	Shafii, Maliki, Jafari, Hanbali (shadow factor = 1)
Hanafi	Hanafi school of thought (shadow factor = 2)

---

Midnight Methods

Method	Description
Standard	Mean time from Sunset to Sunrise
Hanafi	Mean time from Maghrib to Fajr

---

Higher Latitude Methods

Method	Description
None	No adjustments
NightMiddle	Middle of the night
OneSeventh	1/7th of the night
AngleBased	Angle-based (recommended)

---

Modifying Settings

from prayertimes import PrayTimes

pt = PrayTimes(method='ISNA')

# Use Hanafi method for Asr
pt.adjust({'asr': 'Hanafi'})

times = pt.get_times((2011, 2, 25), (43, -80), -5)

---

Tuning Prayer Times

from prayertimes import PrayTimes

pt = PrayTimes(method='ISNA')

# Add/subtract minutes to specific times
pt.tune({
    'fajr': +10,
    'dhuhr': -10,
    'asr': -10,
    'maghrib': -10,
    'isha': +10,
    'midnight': +5,
    'sunrise': -2,
    'sunset': +9,
    'imsak': +15
})

times = pt.get_times((2011, 2, 25), (43, -80), -5)

---

Resources

• Homepage: https://github.com/QuantumPrayerTimes/prayertimes
• Source: Browse Repository

---

Issues

Have suggestions or run into problems? 👉 Open an issue or submit a pull request!