=head1 NOM

DateTime::Calendar::Hijri - Dates dans le calendrier  Hijri (Islamique ou Hégire)

=head1 RÉSUMÉ

    use DateTime::Calendar::Hijri;
    $dt = DateTime::Calendar::Hijri->new( year => 1424,
                                          month => 1,
                                          day => 1);

    $year = $dt->year;      # 1424
    $month = $dt->month;    # 1
    $day = $dt->day;        # 1

    $str = $dt->datetime;   # "1424-1-1 AH"

    $dt = DateTime::Calendar::Hijri->from_object(
                                            object => $datetime_obj
                                     );

=head1 DESCRIPTION

Le calendrier Hijri a pour origine la fuite de Mohammed de la Mecque
vers Médine, en l'an 622 du calendrer grégorien. Cette date fut
prise comme date origine du calendrier, lequel est encore en vigueur
dans un certain nombre de pays mulsulmans.

Comme le calendrier grégorien, l'année Hijri comporte 12 mois. Le début
de chaque mois se détermine par l'observation de la Lune naissante.
Cela signifie que le calendrer Hijri ne peut pas être déterminé à 
l'S<avance :> on ne sais pas par avance quand débute une lunaison.
Plusieurs algorithmes ont été écrits pour prédire le jour début de
chaque mois et ce module utilise l'un d'entre eux. Néanmoins, les
dates calculées peuvent présenter un décalage d'un jour ou deux 
par rapport aux dates réelles.

=head1 MÉTHODES

=over 4

=item * new( ... )

Crée un nouvel objet date Hijri. Les paramètres autorisés sont C<year> pour
l'année, C<month> pour le mois et C<day> pour le jour.

=item * year , month , day

Renvoie les éléments d'une date Hijri.

=item * datetime

Renvoie une chaîne représentant la date Hijri.

=item * from_object( object => ... )

Crée une date Hijri à partir d'un objet DateTime ou compatible.

=item * utc_rd_values

Renvoie le nombre de jours I<Rata Die>. Cette méthode permet de convertir
une date Hijri dans un autre calendrier.

=head1 BUGS

=item *

Les dates sont parfois décalées d'un jour ou deux lorsque vous convertissez
à partir d'un autre calendrier ou vers un autre calendrier. Il est
impossible de corriger ce bug, car le calendrier Hijri est basé sur
l'observation, pas sur un algorithme.

=item *

Les fonctionnalités de ce module sont très réduites en comparaison avec
les fonctionnalités des autres modules de calendrier du projet DateTime.
C'est parce que je ne connais pas très bien le calendrier Hijri et
je ne m'estime pas en mesure de lui rendre justice. Si c'est dans
vos possibilités et si vous souhaitez consacrer du temps à améliorer
ce module, je serai ravi de vous transmettre la tâche de le maintenir.
Écrivez-S<moi !>

=back

=head1 SUPPORT

Le support de ce module est assuré par la liste de diffusion
C<datetime@perl.org>. Cf. http://lists.perl.org/ pour les détails.
Si vous ne pensez pas maîtriser suffisamment la langue anglaise,
faites-vous aider par l'un de vos proches ou éventuellement
par le traducteur.

=head1 AUTEUR

Eugene van der Pijll (C<pijll> arobase C<gmx> point C<net>)

Ce module utilise le module C<Date::Hijri> d'Alex Pleiner
pour les calculs.

=head1 TRADUCTION

Cette traduction concerne  la version 0.0 de C<DateTime::Calendar::Hijri>.

La traduction a été réalisée par Jean Forget (C<JFORGET> arobase 
C<cpan> point C<org>) le 2004-07-09.

=head1 COPYRIGHT

Copyright (c) 2003 Eugene van der Pijll pour la version originale. Tous 
droits réservés. Ce logiciel est un logiciel S<libre ;>
vous pouvez le redistribuer et le modifier aux mêmes conditions
que Perl lui-même.

Copyright (c) 2004 Jean Forget et les Mongueurs de Perl pour
la traduction française. Tous droits réservés.

=head1 VOIR ÉGALEMENT

La liste de distribution C<datetime@perl.org>

L<DateTime>

http://datetime.perl.org/

http://datetime.mongueurs.net/

=cut