Hijri(3pm)						User Contributed Perl Documentation						Hijri(3pm)

NAME

       Date::Hijri - Perl extension to convert islamic (hijri) and gregorian dates.

SYNOPSIS

	 use Date::Hijri;

	 # convert gregorian to hijri date
	 my ($hd, $hm, $hy) = g2h($gd, $gm, $gy);

	 # convert hijri to gregorian date
	 my ($gd, $gm, $gy) = h2g($hd, $hm, $hy);

DESCRIPTION

       This simple module converts gregorian dates to islamic (hijri) and vice versa.

       The dates must be given as an array containing the day, month and year, and return the corresponding date as a list with the same elements.

EXAMPLES

	 #!/usr/bin/perl -w

	 use Date::Hijri;

	 print join("-", g2h(22,8,2003));  # prints 23-6-1424
	 print join("-", h2g(23,6,1424));  # prints 22-8-2003

SEE ALSO

       This code is just stolen from KDE's kcalendarsystemhijri.cpp at
       http://webcvs.kde.org/cgi-bin/cvsweb.cgi/kdelibs/kdecore/kcalendarsystemhijri.cpp

	  Copyright (c) 2002-2003 Carlos Moro <cfmoro@correo.uniovi.es>
	  Copyright (c) 2002-2003 Hans Petter Bieker <bieker@kde.org>

	  kcalendarsystemhijri.cpp is translated from the Lisp code
	  in ``Calendrical Calculations'' by Nachum Dershowitz and
	  Edward M. Reingold, Software---Practice & Experience,
	  vol. 20, no. 9 (September, 1990), pp. 899--928.

	  This code is in the public domain, but any use of it
	  should publically acknowledge its source.

AUTHOR

       Alex Pleiner, <alex@zeitform.de>

COPYRIGHT AND LICENSE

       Copyright (c) 2003 zeitform Internet Dienste. All rights reserved.  This program is free software; you can redistribute it and/or modify it
       under the same terms as Perl itself.

DISCLAIMER

       I haven't really tested if the converted dates are right and hope someone will point out mistakes.

       Hijri calculations are very difficult. The islamic calendar is a pure lunar calendar, the new month starts by a physical (i.e. human)
       sighting of the crescent moon at a given locale. So it depends on several factors (like weather) that make it unreliable to calculate
       islamic calendars in advance. As a result the dates calculated by Date::Hijri can be false by one or more days.

       Please see http://www.rabiah.com/convert/introduction.html for further explanation.

       I'm not a muslim, but interested in Islamic culture, religion and calendar system. I believe in the Internet as a chance to realize that we
       live in a small world with multiple cultures, religions and philosophies. We can learn from others and develop tolerance, respect and
       understanding.

       Salam Alaikum (peace be with you)

perl v5.10.0							    2003-08-26								Hijri(3pm)