NAME

Religion::Islam::PrayTime - Calculates Muslim Prayers Times, Sunrise, and Sunset

SYNOPSIS

use Religion::Islam::PrayTime;

$date = time();
$latitude = 30.0599;		# Cairo, Egypt
$longitude = 31.2599;		# Cairo, Egypt
$timeZone = 2;				# Cairo, Egypt

($sec, $min, $hour, $mday, $mon, $year, $wday, $yday, $dst) = localtime(time);
$mon++; 	$year += 1900;
#$year = 2013; $month = 12; $day = 5;
print "Today:  $mon/$mday/$year \n";

$calcMethod = 4;
$prayTime = Religion::Islam::PrayTime->new($calcMethod);

#Calculation Method: 0..7
#	0		Ithna Ashari
#	1		University of Islamic Sciences, Karachi
#	2		Islamic Society of North America (ISNA)
#	3		Muslim World League (MWL)
#	4		Umm al-Qura, Makkah
#	5		Egyptian General Authority of Survey
#	6		Custom Setting
#	7		Institute of Geophysics, University of Tehran
$calcMethod = 5;
$prayTime->setCalcMethod($calcMethod);

# Time Formats: 0..3
#	0	24-hour format
#	1	12-hour format
#	2	12-hour format with no suffix
#	3	floating point number
$prayTime->setTimeFormat(1);

#Juristic method for Asr: 0..1
#	0	Shafii (standard)
#	1	Hanafi
$prayTime->setAsrMethod(0);

# Adjusting Methods for Higher Latitudes: 0..3
#	0	No adjustment
#	1	middle of night
#	2	1/7th of night
#	3	angle/60th of night
$prayTime->setHighLatsMethod(0);

# set the angle for calculating Fajr
#$prayTime->setFajrAngle($angle);
#set the angle for calculating Maghrib
#$prayTime->setMaghribAngle($angle);
# set the angle for calculating Isha
#$prayTime->setIshaAngle($angle);
# set the minutes after mid-day for calculating Dhuhr
#$prayTime->setDhuhrMinutes($minutes);
#set the minutes after Sunset for calculating Maghrib
#$prayTime->setMaghribMinutes($minutes);
#set the minutes after Maghrib for calculating Isha
#$prayTime->setIshaMinutes($minutes);

# these functions return array of times
#@times = $prayTime->getPrayerTimes($date, $latitude, $longitude, $timeZone);
#@times = $prayTime->getDatePrayerTimes($year, $month, $day, $latitude, $longitude, $timeZone);
#print "Fajr\tSunrise\tDhuhr\tAsr\tSunset\tMaghrib\tIsha\n";
#print join "\t", @times , "\n";

# these functions return named hash array of times
%times = $prayTime->getDatePrayerTimesHash($year, $month, $day, $latitude, $longitude, $timeZone);
#%times = $prayTime->getPrayerTimesHash($date, $latitude, $longitude, $timeZone);
while (($k, $v) = each %times) {
	print "$k: $v\n";
}

DESCRIPTION

This module calculates Muslim prayers times, sunrise and sunset for any location on the earth.

SEE ALSO

Date::HijriDate Religion::Islam::Qibla Religion::Islam::Quran Religion::Islam::PrayTime

AUTHOR

Ahmed Amin Elsheshtawy, <support@islamware.com> <support@mewsoft.com> Website: http://www.islamware.com http://www.mewsoft.com

COPYRIGHT AND LICENSE

Copyright (C) 2013 by Dr. Ahmed Amin Elsheshtawy webmaster@islamware.com, http://www.islamware.com http://www.mewsoft.com

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.