Lib.rs

✨ 特性

• 位置特定：根据指定位置计算所有相关伊斯兰祈祷时间。
• 时区特定：根据定义的时区输出时间。
• 独立于API：无需任何外部API调用计算时间（需要知道您的纬度/经度）（即将推出主要城市支持）
• 可配置：高度可配置的CLI，可以设置任何相关的计算参数（计算权威、学派等）

👨🏾‍💻 安装

要安装salah，您可以使用cargo或直接从最新版本下载二进制文件

使用cargo

cargo install salah

🤸🏾‍♂️ 使用方法

Usage: salah <COMMAND>

Commands:
  location   Use location (city/country) to get prayer times. WARNING: Uses external API call, network connection required
  coord      Use coordinates (latitude/longitude) to get prayer times
  timings    Lists all the available timings
  authority  Lists all the calculation authorities
  help       Print this message or the help of the given subcommand(s)

Options:
  -h, --help     Print help
  -V, --version  Print version

命令

salah location

salah location [OPTIONS] --city <CITY> --country <COUNTRY> [TIMINGS]...

参数

使用Nominatim OpenStreetMaps API获取计算祈祷时间所需的纬度/经度值。

salah coord

salah coord [OPTIONS] --lat <LAT> --lng <LNG> [TIMINGS]...

参数

直接计算时间，无需任何外部API调用。

[选项]

这些选项对salah location和salah coord都适用

salah 时间

列出 [TIMINGS]... 的所有可用值

Usage: salah <location | coords> [OPTIONS] [TIMINGS]...

The below can be passed to [TIMINGS]...

Timings:
  fajr      The dawn prayer time. Dependent on angle determined by authority (see salah authority)
  sunrise   Sunrise time. Fajr time ends at sunrise.
  dhuhr     The mid-day prayer time.
  asr       The evening prayer time. Dependent on school of thought (Hanafi vs Others).
  maghrib   The sunset prayer time.
  isha      The night prayer time. Dependent on angle determined by authority (see salah authority)
  midnight  The Islamic midnight time. Isha time ends at midnight.

salah 权限

列出所有可用的计算权限，与 --auth <AUTH> 一起使用

Usage: --auth <AUTH>

Explanation:
Calculation authorities are used for the calculation of Fajr and Isha.
The time for Fajr is described as dawn; when there is fine white line at the horizon.
Isha time is described as when the night sky has lost all the light from the sunset.
As this is quite ambiguous, the scholars have differed upon the angle that the sun
makes when these two times occur. Each authority has slightly different angles for
Fajr and Isha. Makkah uses a time difference from Maghrib (sunset).

The below can be used with the --auth <AUTH> option when calculating timings.

Authorities:
  MWL       Fajr at 18 degrees, Isha at 17 degrees. - Muslim World League
  ISNA      Fajr at 15 degrees, Isha at 18 degrees. - Islamic Society of North America
  Egypt     Fajr at 19.5 degrees, Isha at 17.5 degrees - Egyptian General Authority of Survey
  Makkah    Fajr at 18.5 degrees, Isha 90 min after Maghrib. - Umm al-Qura University, Makkah
  Karachi   Fajr at 18 degrees, Isha at 18 degrees. - University of Islamic Sciences, Karachi
  Tehran    Fajr at 17.7 degrees, Isha at 14 degrees. - Institute of Geophysics, University of Tehran
  Jafari    Fajr at 16 degrees, Isha at 14 degrees. - Shia Ithna Ashari, Leva Research Institute, Qum

salah 时区

列出所有可用时区，可使用可选查询参数搜索特定时区。

salah timezones [QUERY]

示例： salah timezones Toronto

Usage: -t, --timezone <TIMEZONE>

The below values can be used with the -t, --timezone <TIMEZONE> option.

Query: `Toronto`

Results:
  America/Toronto
Found 1 result(s)

🚧 示例

获取加拿大多伦多的 Fajr 时间，格式化输出

salah location --city Toronto --country Canada --date 2024-02-11 --format "%I:%M %p" fajr

输出

fajr 06:03 AM

获取巴基斯坦卡拉奇的 fardh 时间，格式化输出

salah location --city Karachi --country Pakistan -t Asia/Karachi --format "%I:%M %p" --date 2024-02-11 fajr dhuhr asr maghrib isha

输出

fajr 06:05 AM
dhuhr 12:46 PM
asr 03:59 PM
maghrib 06:23 PM
isha 07:27 PM

获取加拿大多伦多的 Asr 时间（使用 Hanafi 学派），格式化输出

salah location --city Toronto --country Canada --date 2024-02-11 --format "%I:%M %p" --hanafi asr

输出

asr 03:57 PM

获取沙特阿拉伯麦加的所有时间，格式化输出

salah location --city Makkah --country "Saudi Arabia" --date 2024-02-11 -t Asia/Riyadh --format "%I:%M %p" --auth Makkah --all

输出

fajr 05:37 AM
sunrise 06:54 AM
dhuhr 12:35 PM
asr 03:51 PM
maghrib 06:16 PM
isha 07:46 PM
midnight 12:35 AM

🤝 贡献

欢迎贡献！我非常新接触 Rust（这是我第一个项目哦），所以肯定还有很多可以改进的地方。请随时提交 PR 或创建 issue！

📄 许可证

MIT