The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
Date-Holidays-PAK-0.02
++
/ Date::Holidays::PAK

NAME

Date::Holidays::PAK - Interface to Pakistan national holidays.

VERSION

Version 0.02

SYNOPSIS

Pakistan Day (Yom-e-Pakistan)

The Pakistan Day is a national holiday in Pakistan to commemorate the Lahore Resolution.That was passed on March 23, 1940 in Lahore,by the Muslim League under the leadership of the founder of Pakistan, Quaid-e Azam Mohammad Ali Jinnah.This was a demand for a separate independent state for the Muslims of South Asia. It is a public holiday therefore all the government offices including banks and educational institutions will remain closed.

Labour Day (Yom-e-Mazdoor)

Like other parts of the world,Labour Day also celebrated in Pakistan on 1 May.In Urdu this day called as Yom-e-Karegar. Various worker's organizations, associations and federations took out worker's rallies in different parts of the country,demonstrating their solidarity with the workers of the world in the struggle for their rights.

Independence Day (Yom-e-Istiqlal)

Pakistan's independence day also known as Yom-e-Istiqlal, celebrated on 14 August. Pakistan became an independent country in 1947. It is the national holiday in Pakistan. This day celebrated all over the country with flag raising ceremonies, tributes to the national heroes and fireworks taking place in the capital, Islamabad. The main celebrations takes place in Islamabad, where the President and Prime Minister raise the national flag at the Presidential and Parliament buildings and deliver speeches that are televised live.

Birthday of Muhammad Iqbal

Sir Muhammad Iqbal was the poet, philosopher and politician in British India.He was the first person to give out the idea of creation of Pakistan.Being a close associate of Muhammad Ali Jinnah and an active member of the All India Muslim League that later spearheaded the Pakistan Movement, Iqbal is widely regarded as a national hero in Pakistan.The birth anniversary of Muhammad Iqbal on November 9.So this day declared as national holiday and a number of educational institutions organize programmes to shed light on the life and achievements of Mr. Iqbal.

Birthday of Quaid-e-Azam Muhammad Ali Jinnah

Mohammad Ali Jinnah was a 20th century lawyer, politician, statesman and the founder of Pakistan. He is popularly and officially known in Pakistan as Quaid-e-Azam.Jinnah served as leader of the All-India Muslim League from 1913 until Pakistan's independence on August 14, 1947 and Pakistan's first Governor-General from August 15, 1947 until his death on September 11, 1948.His birthday is a national holiday in Pakistan.

Eid-ul-Fitr Day

Eid ul-Fitr is a Muslim holiday that marks the end of Ramadan, the Islamic holy month of fasting. Eid is an Arabic word meaning "festivity", while Fitr means "to break fast"; and so the holiday symbolizes the breaking of the fasting period. It is celebrated after the end of the Islamic month of Ramadan, on the first day of Shawwal. It is the day when the Muslims thank Allah for having given them the will, the strength and the endurance to observe fast and obey His commandment during the holy month of Ramadan.It is celebrated for two days in a holiday called Eid-ul-Fitr (the Feast of Fast Breaking).

Eid ul-Azha Day

Eid al-Adha means "Festival of Sacrifice" or "Greater Eid" is an important holiday celebrated in Pakistan, to commemorate the willingness of Abraham (Ibrahim) to sacrifice his son Ishmael as an act of obedience to God. Eid al-Adha is celebrated annually on the 10th and 11th day of the month of Dhu al-Hijjah of the lunar Islamic calendar.

Milad an-Nabi (Mawlid)

The Birth Day of Prophet Muhammad celebrated as Milad-un-Nabi or Mawlid,which occurs in Rabi' al-awwal, the third month in the Islamic calendar.During this occasion people decorate mosques, their houses and streets with colourful flags, lightings. Special activities including reciting of the Holy Quran, Mehfal-e-Naat and Qawalis are arranged. The women also arrange Milad Mehfils to pay tributes to Holy Prophet Muhammed. Milad an-Nabi is celebrated with very high spirit across Pakistan.

Ashura

It is commemorated as a day of mourning for the martyrdom of Husayn ibn Ali, the grandson of the Islamic Prophet Muhammad at the Battle of Karbala on 9th and 10th Muharram in the year 61 AH. In Pakistan this is the national holiday.

Shab-e-Miraj

Celebrated on the 27th Rajab.

Holidays Table

    ----------------------------------------------
    | Date     |    Name                         |
    ----------------------------------------------
    | 23rd Mar | Pakistan Day                    |
    | 01st May | Labour day (May Day)            |
    | 14th Aug | Independence Day                |
    | 09th Nov | Birthday of Muhammad Iqbal      |
    | 25th Dec | Birthday of Muhammad Ali Jinnah |
    ----------------------------------------------
    
    Dates following the Lunar Islamic calendar
    
    ----------------------------------------------
    | Date            |    Name                  |
    ----------------------------------------------
    | 09th Muharram   | Ashura Day 1             |
    | 10th Muharram   | Ashura Day 2             |
    | 12th Rabi-Awwal | Milad-un-Nabi            |
    | 27th Rajab      | Shab-e-Miraj             |
    | 01st Shawwal    | Eid-ul-Fitr Day 1        |
    | 02nd Shawwal    | Eid-ul-Fitr Day 2        |
    | 10th Dhul Hijja | Eid ul-Adha Day 1        |
    | 11th Dhul Hijja | Eid ul-Adha Day 2        |
    ----------------------------------------------

METHODS

get_holidays()

Return Pakistan national holidays.

    use strict; use warnings;
    use Date::Holidays::PAK;

    my $pak      = Date::Holidays::PAK->new(2011);
    my $holidays = $pak->get_holidays();

get_holidays_count()

Return Pakistan national holidays count.

    use strict; use warnings;
    use Date::Holidays::PAK;

    my $pak   = Date::Holidays::PAK->new(2011);
    my $count = $pak->get_holidays_count();

as_string()

Return holidays in human readable format.

    use strict; use warnings;
    use Date::Holidays::PAK;

    my $pak = Date::Holidays::PAK->new(2011);
    print $pak->as_string();
    
    # or even simply
    print $pak;

AUTHOR

Mohammad S Anwar, <mohammad.anwar at yahoo.com>

BUGS

Please report any bugs or feature requests to bug-date-holidays-pak at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Date-Holidays-PAK. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc Date::Holidays::PAK

You can also look for information at:

ACKNOWLEDGEMENTS

The information here is based on http://en.wikipedia.org/wiki/Public_holidays_in_Pakistan.

LICENSE AND COPYRIGHT

Copyright 2011 Mohammad S Anwar.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.

DISCLAIMER

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.