Azan

Additional

Language
Kotlin
Version
3.0.0 (Apr 19, 2019)
Created
Nov 13, 2016
Updated
Jun 27, 2022 (Retired)
Owner
ahmed.eltaher (ahmedeltaher)
Contributors
ahmed.eltaher (ahmedeltaher)
Sigit (sigitbn)
Imran Vora (imranvora)
3
Activity
Badge
Generate
Download
Source code

AZAN

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 .

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

  • latitude
  • longitude
  • timezone
  • height
  • The Way of Calculation

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

  • Add it in your root build.gradle at the end of repositories:

    • in your allprojects section , you have to add maven { url 'https://jitpack.io' }
allprojects {  
 repositories { 
                      maven { 
                                url 'https://jitpack.io' 
                         }
            }
          }
  • in your build.gradle of your app module , Add the dependency

    implementation 'com.github.ahmedeltaher:Azan:3.0'

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.