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 .

Download

Step 1. Add the JitPack repository to your build file

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

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.ahmedeltaher:Azan:3.0.0'
	}

	<dependency>
	    <groupId>com.github.ahmedeltaher</groupId>
	    <artifactId>Azan</artifactId>
	    <version>3.0.0</version>
	</dependency>


                            
    libraryDependencies += "com.github.ahmedeltaher" % "Azan" % "3.0.0"


                            
    :dependencies [[com.github.ahmedeltaher/Azan "3.0.0"]]

Readme

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 .

azan-preview

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.