Adhan Swift 是一个经过充分测试且文档完善的库，用于计算伊斯兰祈祷时间。 Adhan Swift 支持 Swift 4.0、Swift 4.2、Swift 5.0 和 Objective-C。

所有天文计算均来自 Jean Meeus 的《天文算法》一书中的高精度公式。美国海军天文台天文应用部门和国家海洋和大气管理局地球系统研究实验室推荐了这本书。

github "batoulapps/adhan-swift" "main"

// swift-tools-version:4.2
dependencies: [
    .package(url: "https://github.com/batoulapps/adhan-swift", .branch("main")),
]

要获取祈祷时间，请初始化 PrayerTimes 结构，传入坐标、日期和计算参数。

let prayers = PrayerTimes(coordinates: coordinates, date: date, calculationParameters: params)

创建一个 Coordinates 结构，其中包含您要获取祈祷时间的地点经纬度。

let coordinates = Coordinates(latitude: 35.78056, longitude: -78.6389)

为了避免时区混淆，传入的日期参数应该是 DateComponents 的实例。需要填充年、月和日组件。所有其他组件将被忽略。年、月和日的值应该是您想要祈祷时间的当地日期。这些日期组件应为公历。

let cal = Calendar(identifier: Calendar.Identifier.gregorian)
let date = cal.dateComponents([.year, .month, .day], from: Date())

一旦初始化了 PrayerTimes 结构，它将包含所有五个祈祷时间和日出时间的成员。祈祷时间将是 NSDate 的实例，因此将指代世界标准时间的固定点。要显示本地时区的这些时间，您需要创建一个日期格式化程序并设置适当的时区。

let formatter = DateFormatter()
formatter.timeStyle = .medium
formatter.timeZone = TimeZone(identifier: "America/New_York")!

print("fajr \(formatter.string(from: prayers.fajr))")

let cal = Calendar(identifier: Calendar.Identifier.gregorian)
let date = cal.dateComponents([.year, .month, .day], from: Date())
let coordinates = Coordinates(latitude: 35.78056, longitude: -78.6389)
var params = CalculationMethod.moonsightingCommittee.params
params.madhab = .hanafi
if let prayers = PrayerTimes(coordinates: coordinates, date: date, calculationParameters: params) {
    let formatter = DateFormatter()
    formatter.timeStyle = .medium
    formatter.timeZone = TimeZone(identifier: "America/New_York")!

    print("fajr \(formatter.string(from: prayers.fajr))")
    print("sunrise \(formatter.string(from: prayers.sunrise))")
    print("dhuhr \(formatter.string(from: prayers.dhuhr))")
    print("asr \(formatter.string(from: prayers.asr))")
    print("maghrib \(formatter.string(from: prayers.maghrib))")
    print("isha \(formatter.string(from: prayers.isha))")
}

PrayerTimes 结构具有用于获取当前祈祷和下一次祈祷的功能。您还可以获得指定祈祷的时间，从而更容易动态显示到下一次祈祷的倒计时。

let prayerTimes = PrayerTimes(coordinates: coordinates, date: date, calculationParameters: params)

let current = prayerTimes.currentPrayer()
let next = prayerTimes.nextPrayer()
let countdown = prayerTimes.time(for: next)

Adhan 库还可以计算圣行时间。给定一个 PrayerTimes 实例，您可以获得一个包含 Qiyam 时间的 SunnahTimes 结构。

if let sunnahTimes = SunnahTimes(from: todayPrayers) {
	print(dateFormatter.string(from: sunnahTimes.lastThirdOfTheNight)
	print(dateFormatter.string(from: sunnahTimes.middleOfTheNight)
}

let nyc = Coordinates(latitude: 40.7128, longitude: -74.0059)
let qiblaDirection = Qibla(coordinates: nyc).direction

Adhan 公开提供给所有开发人员，以提供一个经过充分测试且文档完善的伊斯兰祈祷时间库。我们接受功能贡献，前提是它们已正确记录并包含适当的单元测试。我们也欢迎以不同位置的祈祷时间单元测试的形式提供贡献，我们要求正确记录比较值的来源。对于所有 pull requests，使用 develop 作为基础分支。

Adhan 在 MIT 许可证下可用。有关更多信息，请参见 LICENSE 文件。

Adhan Swift

安装

CocoaPods

Carthage

Swift Package Manager

手动

用法

初始化参数

坐标

日期

计算参数 & 计算方法

祈祷时间

完整示例

便捷实用工具

圣行时间

朝拜方向

贡献

许可证