ahmedeltaher / Prayer-Times-Android-Azan

Prayer + Time + Android + Kotlin + Azan + Library + timezone + islamic + salah + Library aiming to calculate prayer time with one line code , if you implement prayer time application , there is no need to do this headache again .
Apache License 2.0
363 stars 94 forks source link
adhan adhan-player android android-library android-prayer-times azan dates islamic islamic-prayer-times java kotlin longitude prayer prayer-times prayertime prayertimes salah time times timezone

AZAN

Android Arsenal Android ArsenalLICENSE Build Kotlin

What is Azan ?
The Muslim call to ritual prayer made by a muezzin from the minaret of a mosque (or now often played from a recording) . Muslims have 5 prayers per day, at each time all muslims are notified by Azan, to pray. first Muslims used to calcualte prayer time with sun raise and sun shadows, but to simplyied it and make it moreaccurent speacilly in cloudy cities, Mosques currently use a complex calcualtion based on latitude, longitude, height, timezone, sun raise time.

What is Azan library?

Library aiming to calculate prayer time with one line code , if you implement prayer time application , there is no need to do this headache again .

azan-preview

Islam Time prayers is every complex to calculate, cause there is many variables in this calculations like:

Azan library enables you to determin latitude, longitude, timezone, height, The Way of Calculation as Inputes.

Supported Calculation Methods :

Method Name Fajr Angel Isha Angel
Umm al-Qura University, Makkah 18.5 90 min after Maghrib , 120 min during Ramadan
MUHAMMADIYAH 20 18
Muslim World League (MWL) 18 17
Egyptian General Authority of Survey 19.5 17.5
University of Islamic Sciences, Karachi 18 18
Islamic Society of North America (ISNA) 15 15
Ithna Ashari 16 14
Institute of Geophysics, University of Tehran 17.7 14
UOIF (Union des organisations islamiques de France) 12 12
Kuwait Calc method 18 17.5

How to use ?

Add it to dependencies in your gradle file

allprojects {  
 repositories { 
                      maven { 
                                url 'https://jitpack.io' 
                            }
               }
             }

Example how to get prayer times

val today = SimpleDate(GregorianCalendar())
val location = Location(30.045411, 31.236735, 2.0, 0)
val azan = Azan(location, Method.EGYPT_SURVEY)
val prayerTimes = azan.getPrayerTimes(today)
val imsaak = azan.getImsaak(today) 
println("----------------results------------------------") 
println("date ---> " + today.day + " / " + today.month + " / " + today.year)
println("imsaak ---> $imsaak") println("Fajr ---> " + prayerTimes.fajr()) 
println("sunrise --->" + prayerTimes.shuruq())
println("Zuhr --->" + prayerTimes.thuhr())
println("Asr --->" + prayerTimes.assr()) 
println("Maghrib --->" + prayerTimes.maghrib())
println("ISHA  --->" + prayerTimes.ishaa())
println("----------------------------------------") 

LICENSE

Ahmed Eltaher 2016

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.