Awesome

Adhan CSharp

Adhan CSharp is a well tested and well documented library for calculating Islamic prayer times. Adhan CSharp is written to be compatible with .NET Core. It has a small method overhead, and has no external dependencies.

All astronomical calculations are high precision equations directly from the book “Astronomical Algorithms” by Jean Meeus. This book is recommended by the Astronomical Applications Department of the U.S. Naval Observatory and the Earth System Research Laboratory of the National Oceanic and Atmospheric Administration.

Implementations of Adhan in other languages can be found in the parent repo Adhan.

Usage

Visual Studio Code

Open Visual Studio Code. Choose File Open Folder and select the folder where the cloned repo exists (e.g. c:\repos\adhan-csharp). From a Terminal window (CTRL-SHIFT-`), run the following command:

dotnet build 

Initialization parameters

Coordinates

Create a Coordinates object with the latitude and longitude for the location you want prayer times for.

Coordinates coordinates = new Coordinates(35.78056, -78.6389);

Date

The date parameter passed in should be an instance of the DateComponents object. The year, month, and day values need to be populated. All other values will be ignored. The year, month and day values should be for the local date that you want prayer times for. These date values are expected to be for the Gregorian calendar. There's also a convenience method for converting a System.DateTime to DateComponents.

DateComponents date = new DateComponents(2015, 11, 1);
DateComponents date = DateComponents.From(DateTime.Now);

Calculation parameters

The rest of the needed information is contained within the CalculationParameters class. Instead of manually initializing this class, it is recommended to use one of the pre-populated instances in the CalculationMethod class. You can then further customize the calculation parameters if needed.

CalculationParameters calcParams =
     CalculationMethod.MUSLIM_WORLD_LEAGUE.GetParameters();
calcParams.Madhab = Madhab.HANAFI;
calcParams.Adjustments.Fajr = 2;

CalculationMethod

Madhab

HighLatitudeRule

Prayer Times

Once the PrayerTimes object has been initialized it will contain values for all five prayer times and the time for sunrise. The prayer times will be DateTime object instances initialized with UTC values. To display these times for the local timezone, a formatting and timezone conversion formatter should be used, for example TimeZoneInfo.

TimeZoneInfo easternTime = TimeZoneInfo.FindSystemTimeZoneById("Eastern Standard Time");
TimeZoneInfo.ConvertTimeFromUtc(prayerTimes.Fajr, easternTime)

Qibla

As of version 1.1.0, this library provides a Qibla class for getting the qibla for a given location.

Coordinates coordinates = new Coordinates(latitude, longitude);
Qibla qibla = new Qibla(coordinates);
// qibla.direction is the qibla direction

Full Example

See an example in the Adhan.Samples module.

static void Main(string[] args)
{
     Coordinates coordinates = new Coordinates(43.61, -79.70);
     DateComponents dateComponents = DateComponents.From(DateTime.Now);
     CalculationParameters parameters = CalculationMethod.NORTH_AMERICA.GetParameters();

     TimeZoneInfo easternTime = TimeZoneInfo.FindSystemTimeZoneById("Eastern Standard Time");

     PrayerTimes prayerTimes = new PrayerTimes(coordinates, dateComponents, parameters);
     Console.WriteLine("Fajr   : " + TimeZoneInfo.ConvertTimeFromUtc(prayerTimes.Fajr, easternTime));
     Console.WriteLine("Sunrise: " + TimeZoneInfo.ConvertTimeFromUtc(prayerTimes.Sunrise, easternTime));
     Console.WriteLine("Dhuhr  : " + TimeZoneInfo.ConvertTimeFromUtc(prayerTimes.Dhuhr, easternTime));
     Console.WriteLine("Asr    : " + TimeZoneInfo.ConvertTimeFromUtc(prayerTimes.Asr, easternTime));
     Console.WriteLine("Maghrib: " + TimeZoneInfo.ConvertTimeFromUtc(prayerTimes.Maghrib, easternTime));
     Console.WriteLine("Isha   : " + TimeZoneInfo.ConvertTimeFromUtc(prayerTimes.Isha, easternTime));
}