salahtimes
A tiny library to get the exact date and time in an ISO 8601 format for any of the five daily prayers at any location and date.
Install
npm install salahtimes
Api Reference
Functions
getFajrDateTimeUtc(date, latitude, longitude, islamicConvention, highLatitudeMethod) ⇒string
Gets the date and time for fajr in UTC expressed in an ISO 8601 format for date instance, latitude, longitude value and optional islamic convention and high laltitude method.
getDhuhrDateTimeUtc(date, longitude) ⇒string
Gets the date and time for dhuhr in UTC expressed in an ISO 8601 format for date instance and longitude value.
getAsrDateTimeUtc(date, latitude, longitude, madhab) ⇒string
Gets the date and time for asr in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value and optional madhab value.
getMaghribDateTimeUtc(date, longitude): string; ⇒string
Gets the date and time for maghrib in UTC expressed in an ISO 8601 format for date instance, latitude and longitude value.
getIshaaDateTimeUtc(date, latitude, longitude, islamicConvention, highLatitudeMethod) ⇒string
Gets the date and time for ishaa in UTC expressed in an ISO 8601 format for date instance, latitude, longitude value and optional islamic convention and high laltitude method.
Const getFajrDateTimeUtc
▸ getFajrDateTimeUtc(date: Date, latitude: number, longitude: number, islamicConvention: SupportedConventions, highLatitudeMethod: HighLatitudeMethod): string
Defined in src/client/adapter.ts:16
Parameters:
| Name | Type | Default |
|---|---|---|
date |
Date | - |
latitude |
number | - |
longitude |
number | - |
islamicConvention |
SupportedConventions | "MuslimWorldLeague" |
highLatitudeMethod |
HighLatitudeMethod | "AngleBasedMethod" |
Returns: string
Example (Example usage of getFajrDateTimeUtc)
// returns '2021-03-01T04:57:11.422Z'
getFajrDateTimeUtc(new Date(2021, 2, 1), 51.522079, -0.191380);Example (Example usage of getFajrDateTimeUtc)
// returns '2021-03-01T04:47:21.866Z'
getFajrDateTimeUtc(new Date(2021, 2, 1), 51.522079, -0.191380, 'EgyptianGeneralAuthorityOfSurvey');Example (Example usage of getFajrDateTimeUtc)
* // returns '2021-03-01T04:47:21.866Z'
* getFajrDateTimeUtc(new Date(2021, 2, 1), 51.522079, -0.191380, 'EgyptianGeneralAuthorityOfSurvey'. 'MiddleOfTheNightMethod');Const getDhuhrDateTimeUtc
▸ getDhuhrDateTimeUtc(date: Date, longitude: number): string
Defined in src/client/adapter.ts:29
Parameters:
| Name | Type |
|---|---|
date |
Date |
longitude |
number |
Returns: string
Example (Example usage of getDhuhrDateTimeUtc)
// returns "2025-01-18T12:10:20.853Z"
getDhuhrDateTimeUtc(new Date(2025, 0, 18), -0.010150);Const getAsrDateTimeUtc
▸ getAsrDateTimeUtc(date: Date, latitude: number, longitude: number, madhab: Madhab): string
Defined in src/client/adapter.ts:41
Parameters:
| Name | Type | Default |
|---|---|---|
date |
Date | - |
latitude |
number | - |
longitude |
number | - |
madhab |
Madhab | "Standard" |
Returns: string
Example (Example usage of getAsrDateTimeUtc)
// returns "2021-03-01T15:02:05.884Z"
getAsrDateTimeUtc(new Date(2021, 2, 1), 51.522079, -0.191380);Example (Example usage of getAsrDateTimeUtc)
// returns "2021-03-01T15:02:05.884Z"
getAsrDateTimeUtc(new Date(2021, 2, 1), 51.522079, -0.191380, 'Shafii');Example (Example usage of getAsrDateTimeUtc)
// returns "2021-03-01T15:45:41.293Z"
getAsrDateTimeUtc(new Date(2021, 2, 1), 51.522079, -0.191380, 'Hanafi');Const getMaghribDateTimeUtc
▸ getMaghribDateTimeUtc(date: Date, latitude: number,longitude: number): string
Defined in src/client/adapter.ts:54
Parameters:
| Name | Type |
|---|---|
date |
Date |
latitude |
number |
longitude |
number |
Returns: string
Example (Example usage of getMaghribDateTimeUtc)
// returns "2025-01-18T12:10:20.853Z"
getMaghribDateTimeUtc(new Date(2025, 0, 18), -0.010150);Example (Example usage of getMaghribDateTimeUtc)
// returns '2037-08-02T17:59:44.502Z'
getMaghribDateTimeUtc(new Date(2037, 7, 2), 42.637610, 21.092160);Example (Example usage of getMaghribDateTimeUtc)
// returns 'The sun is up all day on 2037-08-01T23:00:00.000Z at latitude: 71.98007 and longitude: 102.47427'
getMaghribDateTimeUtc(new Date(2037, 7, 2), 71.980070, 102.474270);Example (Example usage of getMaghribDateTimeUtc)
// returns 'The sun is down all day on 2032-01-01T00:00:00.000Z at latitude: 89.525 and longitude: -30.45'
getMaghribDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);Example (Example usage of getMaghribDateTimeUtc)
// returns 'The sun is down all day on 2032-01-01T00:00:00.000Z at latitude: 89.525 and longitude: -30.45'
getMaghribDateTimeUtc(new Date(2032, 0, 1), 89.5250, -30.4500);Const getIshaaDateTimeUtc
▸ getIshaaDateTimeUtc(date: Date, latitude: number, longitude: number, islamicConvention: SupportedConventions, highLatitudeMethod: HighLatitudeMethod): string
Defined in src/client/adapter.ts:16
Parameters:
| Name | Type | Default |
|---|---|---|
date |
Date | - |
latitude |
number | - |
longitude |
number | - |
islamicConvention |
SupportedConventions | "MuslimWorldLeague" |
highLatitudeMethod |
HighLatitudeMethod | "AngleBasedMethod" |
Returns: string
Example (Example usage of getIshaaDateTimeUtc)
// returns '2021-03-01T19:22:33.506Z'
getIshaaDateTimeUtc(new Date(2021, 2, 1), 51.522079, -0.191380);Example (Example usage of getIshaaDateTimeUtc)
// returns '2021-03-01T19:29:04.467Z'
getIshaaDateTimeUtc(new Date(2021, 2, 1), 51.522079, -0.191380, 'UniversityOfIslamicSciencesKarachi');Example (Example usage of getIshaaDateTimeUtc)
// returns '2021-03-01T19:29:04.467Z'
getIshaaDateTimeUtc(new Date(2021, 2, 1), 51.522079, -0.191380, 'UniversityOfIslamicSciencesKarachi', 'MiddleOfTheNightMethod');SupportedConventions
Ƭ SupportedConventions: "MuslimWorldLeague" | "IslamicSocietyOfNorthAmerica" | "EgyptianGeneralAuthorityOfSurvey" | "UmmAlQuraUniversityMekkah" | "UniversityOfIslamicSciencesKarachi" | "InstituteOfGeophysicsUniversityOfTehranOfSurvey" | "ShiaIthnaAshariLevaResearchInstituteQumOfSurvey"
HighLatitudeMethod
Ƭ HighLatitudeMethod: "AngleBasedMethod" | "MiddleOfTheNightMethod" | "OneSeventhMethod"
Madhab
Ƭ Madhab: "Standard" | "Shafii" | "Maliki" | "Hanbali" | "Hanafi"