jdtojewish()

Introduction

La fonction PHP jdtojewish() convertit un numéro de jour julien (un entier représentant un compte continu de jours) en date dans le calendrier juif (hébreu). Elle fait partie de l'extension Calendar de PHP et est l'inverse de jewishtojd().

Cette page couvre la syntaxe de la fonction, ses paramètres et sa valeur de retour, les drapeaux de formatage hébreu optionnels, un exemple fonctionnel, ainsi que les erreurs courantes à éviter.

Qu'est-ce qu'un numéro de jour julien ?

Un numéro de jour julien (JDC) est un compte continu de jours entiers depuis le midi du 1er janvier 4713 av. J.-C. (dans le calendrier julien proleptique). Comme chaque date — passée ou future — correspond à un seul entier, le JDC est une représentation neutre pratique : vous convertissez n'importe quelle date de calendrier en jour julien, puis de nouveau vers un autre calendrier. C'est exactement ainsi que fonctionnent les fonctions de conversion de calendrier de PHP : chaque calendrier possède une fonction *tojd() et une fonction jdto*().

Notez que le « jour julien » n'a aucun lien avec le « calendrier julien » — ils ne partagent que le nom.

Syntaxe

jdtojewish(int $julian_day, bool $hebrew = false, int $flags = 0): string

Valeur de retour : une chaîne de caractères. Lorsque $hebrew est false, le format est "mois/jour/année", par exemple "8/7/5784". Lorsque $hebrew est true, la date est rendue sous forme de chaîne hébraïque.

Drapeaux de formatage hébreu

Ces constantes peuvent être combinées avec l'opérateur | (OU bit à bit) et ne prennent effet que lorsque $hebrew est true :

Exemple de base

<?php

// First convert a Gregorian date to a Julian Day Count.
$julianDay = gregoriantojd(8, 7, 2024); // month, day, year

// Then convert that Julian Day to a Jewish calendar date.
$jewishDate = jdtojewish($julianDay);

echo "Julian Day Count: $julianDay\n";
echo "Jewish date (month/day/year): $jewishDate\n";
?>

Ici, nous partons de la date grégorienne du 7 août 2024, nous la convertissons en numéro de jour julien avec gregoriantojd(), puis nous passons ce compte à jdtojewish(). Le résultat est retourné sous la forme mois/jour/année en utilisant les numéros de mois et d'année du calendrier juif.

Retourner une chaîne hébraïque

Passez true comme deuxième argument pour afficher la date en texte hébreu, et combinez les drapeaux pour un formatage plus complet :

<?php

$julianDay = gregoriantojd(8, 7, 2024);

$hebrew = jdtojewish(
    $julianDay,
    true,
    CAL_JEWISH_ADD_GERESHAYIM | CAL_JEWISH_ADD_ALAFIM_GERESH
);

echo $hebrew;
?>

Erreurs courantes

• Utilisez un entier pour le jour julien, pas un nombre décimal. Les fonctions comme gregoriantojd() retournent un entier. Passer un flottant tel que 2459401.5 est rejeté par les versions modernes de PHP — travaillez toujours avec des entiers représentant des jours complets.
• Les drapeaux sont ignorés si $hebrew n'est pas true. Les constantes CAL_JEWISH_* ne modifient que la sortie sous forme de chaîne hébraïque.
• L'extension Calendar doit être disponible. jdtojewish() fait partie de l'extension calendar de PHP. Elle est incluse par défaut dans la plupart des distributions, mais si la fonction n'est pas définie, activez ou compilez l'extension.

Fonctions associées

• jewishtojd() — l'inverse : date juive vers numéro de jour julien.
• gregoriantojd() — date grégorienne vers numéro de jour julien.
• jdtogregorian() — numéro de jour julien vers date grégorienne.
• jdmonthname() — nom du mois pour un jour julien dans un calendrier donné.
• jddayofweek() — jour de la semaine pour un jour julien.

Conclusion

jdtojewish() convertit un numéro de jour julien en date du calendrier juif, optionnellement sous forme de texte hébreu. Associez-la à gregoriantojd() (ou à toute autre fonction *tojd()) pour convertir entre calendriers, pensez à passer un entier pour le compte de jours, et utilisez les drapeaux CAL_JEWISH_* uniquement lorsque vous demandez la forme hébraïque.

Practice