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"

---

More indepth implementation documentation