.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Hijri 3pm"
.TH Hijri 3pm "2022-11-20" "perl v5.36.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Date::Hijri \- Perl extension to convert islamic (hijri) and gregorian dates.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\&  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);
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This simple module converts gregorian dates to islamic (hijri) and vice versa.
.PP
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.
.SH "EXAMPLES"
.IX Header "EXAMPLES"
.Vb 1
\&  #!/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
.Ve
.SH "SEE ALSO"
.IX Header "SEE ALSO"
This code is just stolen from \s-1KDE\s0's kcalendarsystemhijri.cpp at
http://webcvs.kde.org/cgi\-bin/cvsweb.cgi/kdelibs/kdecore/kcalendarsystemhijri.cpp
.PP
.Vb 2
\&   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\*(Aq\*(Aq 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.
.Ve
.SH "AUTHOR"
.IX Header "AUTHOR"
Alex Pleiner, <alex@zeitform.de>
.SH "COPYRIGHT AND LICENSE"
.IX Header "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.
.SH "DISCLAIMER"
.IX Header "DISCLAIMER"
I haven't really tested if the converted dates are right and hope
someone will point out mistakes.
.PP
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.
.PP
Please see http://www.rabiah.com/convert/introduction.html for further
explanation.
.PP
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.
.PP
Salam Alaikum (peace be with you)