Mawaqit — مواقيت

Islamic prayer times for Rust with high-latitude & polar-region support.

Quick start

Add mawaqit under [dependencies] in your Cargo.toml:

[dependencies]
mawaqit = "0.2"

Then set your location, date, and calculation method to get prayer times:

use mawaqit::prelude::*;

// your location (e.g., Brussels — a high-latitude example)
let brussels = Coordinates::new(50.85, 4.35);

// target date
let date = NaiveDate::from_ymd_opt(2026, 6, 21).unwrap();

// calculation parameters
let mut params = Configuration::with(Method::MuslimWorldLeague, Madhab::Shafi);
params.high_latitude_rule = HighLatitudeRule::Recommended;

// compute prayer times
let prayers = PrayerSchedule::new()
    .on(date)
    .for_location(brussels)
    .with_configuration(params)
    .calculate()
    .unwrap();

Initialization parameters

Coordinates

Create a Coordinates struct with the latitude and longitude for the location.

let coordinates = Coordinates::new(31.7683, 35.2137);

Date

Use NaiveDate to avoid timezone confusion. Only the year, month, and day are used (All other components will be ignored).

let date = NaiveDate::from_ymd_opt(2026, 6, 21).unwrap();

Configuration

The Configuration builder constructs a Parameters struct. Use Configuration::with(method, madhab) to start from a preset, or Configuration::new(fajr_angle, isha_angle) for fully custom settings.

let params = Configuration::with(Method::MuslimWorldLeague, Madhab::Shafi);

Parameters

Method

Provides preset configuration for calculating prayer times.

Madhab

Setting for Asr prayer time.

HighLatitudeRule

Fallback approximations for Fajr and Isha when the sun does not reach the required angle.

Defer to try_new() — set the variant on params:

params.high_latitude_rule = HighLatitudeRule::Recommended;

Inspect directly — call the static method:

let rule = HighLatitudeRule::recommended(Coordinates::new(50.85, 4.35));

PolarFallback

Fallback for polar latitudes (>66.5°) where the sun may not rise or set for extended periods. All prayer times use the resolved (nearest/reference) latitude.

Shafaq

Used by the MoonsightingCommittee method to determine Isha twilight.

Note: Auto-selected from Madhab in Configuration::with(). Override with params.shafaq = ....

use mawaqit::Shafaq;

params.shafaq = Shafaq::Ahmer;

Rounding

use mawaqit::Rounding;

params.rounding = Rounding::Nearest;

Adjustments

Add or subtract minutes per prayer using the Adjustment builder.

let adj = Adjustment::new()
    .fajr(-2)
    .sunrise(1)
    .dhuhr(0)
    .asr(0)
    .maghrib(2)
    .isha(4)
    .done();

params.adjustments = adj;

Prayer schedule

PrayerTimes

The PrayerTimes struct holds all computed prayer times as DateTime<Utc>. Convert to local time using chrono's timezone methods.

let (hours, minutes) = schedule.time_remaining();
println!("Next: {} in {}h {}m", schedule.next().name(), hours, minutes);

Prayer

Qibla direction

Get the direction to the Kaaba from any location, in degrees from true north.

let brussels  = Coordinates::new(50.85, 4.35);
let qiblah    = Qiblah::new(brussels);

println!("{}", qiblah);           // Display: 123.4783
println!("{}", qiblah.value());   // Raw f64: 123.4783420

Full example

use mawaqit::prelude::*;

let brussels = Coordinates::new(50.85, 4.35);
let date    = NaiveDate::from_ymd_opt(2026, 6, 21).unwrap();
let mut params = Configuration::with(Method::MuslimWorldLeague, Madhab::Shafi);
params.high_latitude_rule = HighLatitudeRule::SeventhOfTheNight;
let result  = PrayerSchedule::new()
    .on(date)
    .for_location(brussels)
    .with_configuration(params)
    .calculate();

match result {
    Ok(prayer) => {
        println!("{}: {}", Prayer::Fajr.name(),    prayer.time(Prayer::Fajr).format("%-l:%M %p"));
        println!("{}: {}", Prayer::Sunrise.name(),  prayer.time(Prayer::Sunrise).format("%-l:%M %p"));
        println!("{}: {}", Prayer::Dhuhr.name(),    prayer.time(Prayer::Dhuhr).format("%-l:%M %p"));
        println!("{}: {}", Prayer::Asr.name(),      prayer.time(Prayer::Asr).format("%-l:%M %p"));
        println!("{}: {}", Prayer::Maghrib.name(),  prayer.time(Prayer::Maghrib).format("%-l:%M %p"));
        println!("{}: {}", Prayer::Isha.name(),     prayer.time(Prayer::Isha).format("%-l:%M %p"));
        println!("{}: {}", Prayer::Qiyam.name(),    prayer.time(Prayer::Qiyam).format("%-l:%M %p"));
    }
    Err(e) => eprintln!("Error: {}", e),
}

Output (in UTC):

Fajr:     2:25 AM
Sunrise:  3:29 AM
Dhuhr:    11:45 AM
Asr:      4:06 PM
Maghrib:  8:00 PM
Isha:     9:04 PM
Qiyam:    12:17 AM

Code of Conduct

This project is governed by the Code of Conduct.

Contribute & Support

• Report Bugs — Found an issue? Open a ticket.
• Suggest Features — Have an idea? Let me know!
• Share — Tell others about the project.

Ibn Mas'ud (RAA) narrated that the Messenger of Allah (ﷺ) said: "He who guides (others) to an act of goodness will have a reward similar to that of its doer." — Related by Muslim

Acknowledgement

This library was inspired by the salah crate by Farhan Ahmed. May Allah reward him for his work and admit him to Jannah.

Astronomical calculations use high-precision equations from Jean Meeus' Astronomical Algorithms.

License

This project is licensed under the MIT License. See LICENSE for details.