Salah

用法

将以下内容添加到您的 Cargo.toml 文件的 [dependencies] 部分

[dependencies]
salah = "0.7.5"

要获取祈祷时间，使用 PrayerSchedule 结构体，传递坐标、日期和计算参数。

use salah::prelude::*;

let new_york_city = Coordinates::new(40.7128, -74.0059);
let date          = NaiveDate::from_ymd_opt(2019, 1, 25).expect("Invalid date provided");
let params        = Configuration::with(Method::MoonsightingCommittee, Madhab::Hanafi);
let prayers       = PrayerSchedule::new()
                      .on(date)
                      .for_location(new_york_city)
                      .with_configuration(params)
                      .calculate();

初始化参数

坐标

创建一个 Coordinates 结构体，其中包含您想要获取祈祷时间的位置的纬度和经度。

let coordinates = Coordinates::new(40.7128, -74.0059);

日期

为了避免与时区混淆，传递的日期参数应该是 Date<Utc> 的实例。需要填写年、月和日组件。其他所有组件将被忽略。

let date = Utc.ymd(2019, 1, 25);

配置

祈祷时间的计算需要某些信息。可以使用 Configuration 结构体来配置这些信息，这是底层 Parameters 结构体的构建器。可以通过传递 Method 枚举的一个变体（以下将介绍可用的变体）以及 Madhab 枚举的一个变体来初始化此结构体。如果需要，您可以进一步自定义计算参数。

let params = Configuration::with(Method::NorthAmerica, Madhab::Hanafi);

方法

为计算祷告时间提供了一些权威预设配置。

教法学派

晡时祷告时间的设置。对于哈纳菲教法学派，晡时比沙菲教法学派稍晚。

高纬度规则

用于近似高纬度法吉尔和伊沙的规则。

你可以通过调用recommended(coordinates:)函数并传递位置的坐标来获取某个位置的推荐高纬度规则。

let myCoordinates = Coordinates { latitude: 48.983226, longitude: -3.216649 };
let highLatRule = HighLatitudeRule::recommended(myCoordinates);

沙发

沙发由月亮观测委员会方法用于确定用于确定伊沙时间的黄昏类型。

祈祷时间表

《PrayerSchedule》结构是一个用于构建《PrayerTimes》结构的构建器。一旦对其调用《calculate》方法，就会初始化一个《PrayerTime》结构，并包含所有五个祈祷时间、日出时间和Qiyam祈祷的时间。

祈祷时间将是一个《DateTime》的实例，并因此指代一个固定的时间点。要显示当地时区的这些时间，您需要使用适当的本地时区格式化它们。

此结构提供了方便的方法来简化祈祷时间的使用和显示。

PrayerTime

Prayer

这是一个枚举，具有所有祈祷的变体，包括日出和Qiyam。为此类型提供的方法只有一个，即name方法，它将返回以英语转写的祈祷名称。

完整示例

use salah::prelude::*;

let new_york_city = Coordinates::new(40.7128, -74.0059);
let date          = Utc.ymd(2019, 1, 25);
let params        = Configuration::with(Method::NorthAmerica, Madhab::Hanafi);
let prayers       = PrayerSchedule::new()
                        .on(date)
                        .for_location(new_york_city)
                        .with_configuration(params)
                        .calculate();

match prayers
{
    Ok(prayer) => {
        println!("{}: {}", Prayer::Fajr.name(), prayer.time(Prayer::Fajr).format("%-l:%M %p").to_string());
        println!("{}: {}", Prayer::Sunrise.name(), prayer.time(Prayer::Sunrise).format("%-l:%M %p").to_string());
        println!("{}: {}", Prayer::Dhuhr.name(), prayer.time(Prayer::Dhuhr).format("%-l:%M %p").to_string());
        println!("{}: {}", Prayer::Asr.name(), prayer.time(Prayer::Asr).format("%-l:%M %p").to_string());
        println!("{}: {}", Prayer::Maghrib.name(), prayer.time(Prayer::Maghrib).format("%-l:%M %p").to_string());
        println!("{}: {}", Prayer::Isha.name(), prayer.time(Prayer::Isha).format("%-l:%M %p").to_string());
        println!("{}: {}", Prayer::Qiyam.name(), prayer.time(Prayer::Qiyam).format("%-l:%M %p").to_string());
    },
    Err(error) => println!("Could not calculate prayer times: {}", error)
}

输出将是在UTC时间（

Fajr: 10:53 AM
Sunrise: 12:12 PM
Dhuhr: 5:09 PM
Asr: 8:24 PM
Maghrib: 10:05 PM
Isha: 11:24 PM
Qiyam: 6:37 AM

便利工具

《PrayerTimes`》结构具有获取当前祈祷和下一个祈祷的功能。您还可以获取指定祈祷的时间，这使得动态显示直到下一个祈祷的倒计时变得更容易。

...
let prayers = PrayerSchedule::new()
                .on(date)
                .for_location(new_york_city)
                .with_configuration(params)
                .calculate();
let (hours, minutes) = prayers.current().time_remaining();

println!("Current: {} ({}:{})", prayers.current().name, hours, minutes);
println!("Next prayer is {} at {}.", prayers.next().name, prayers.time(prayer.next()).format("%-l:%M %p").to_string()));

朝向Qibla的方向

获取从给定坐标集得到的Qibla方向，以度为单位从北开始。

let new_york_city   = Coordinates::new(40.7128, -74.0059);
let qiblah_direction = Qiblah::new(new_york_city);

println!("Qiblah: {}", qibla_direction); //  Outputs: Qiblah: 58.4817

要获取Qibla方向的实数值（f64），您可以在《Qiblah`》实例上使用《value`方法。

let new_york_city   = Coordinates::new(40.7128, -74.0059);
let qiblah_direction = Qiblah::new(new_york_city);

println!("Qiblah: {}", qibla_direction.value()); //  Outputs: Qiblah: 58.48176358718943

贡献

有关更多信息，请参阅《CONTRIBUTING.md`文件。

行为准则

我们的贡献者行为准则可以在《code-of-conduct.md`文件中找到。

致谢

此库基于Batoul Apps的《Adhan`库。所有天文计算都是直接来自Jean Meeus的《Astronomical Algorithms`一书中高精度方程。

许可证

Salah遵循三个条款的BSD许可协议。这意味着：只要Salah的版权依然存在，条件未被修改，免责声明存在，你可以随意使用它。此外，未经书面同意，不得使用作者的名字来推广软件的衍生产品。

完整的许可协议文本可以在LICENSE文件中找到。