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 = 2014; $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       Institute of Geophysics, University of Tehran
        #       7       Custom Setting

        $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);
        
        # set text for am/pm suffix for other languages, defaults english
        $prayTime->am_pm("am", "pm");

        # 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-2014 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.