jdtojewish()

Introduzione

La funzione PHP jdtojewish() converte un Numero Giuliano (un numero intero continuo che rappresenta i giorni) in una data nel calendario ebraico (ebraico). Fa parte dell'estensione Calendar di PHP ed è l'inverso di jewishtojd().

Questa pagina illustra la sintassi della funzione, i suoi parametri e il valore restituito, i flag opzionali per la formattazione in ebraico, un esempio funzionante e le insidie più comuni da tenere d'occhio.

Cos'è un Numero Giuliano?

Un Numero Giuliano (JDC) è un conteggio continuo di giorni interi a partire dal mezzogiorno del 1° gennaio 4713 a.C. (nel calendario giuliano prolettico). Poiché ogni data — passata o futura — corrisponde a un singolo intero, il JDC è una comoda rappresentazione neutrale: si converte qualsiasi data di un calendario in un Numero Giuliano, per poi ritrasformarla in un altro calendario. Questo è esattamente il modo in cui funzionano le funzioni di conversione del calendario di PHP: ogni calendario ha una funzione *tojd() e una funzione jdto*().

Si noti che il "Giorno Giuliano" non è correlato al "Calendario Giuliano" — condividono solo il nome.

Sintassi

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

Valore restituito: una stringa. Quando $hebrew è false, il formato è "mese/giorno/anno", ad esempio "8/7/5784". Quando $hebrew è true, la data viene resa come stringa in ebraico.

Flag di formattazione ebraica

Queste costanti possono essere combinate con l'operatore | (OR bit a bit) e hanno effetto solo quando $hebrew è true:

Esempio 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";
?>

Qui si parte dalla data gregoriana del 7 agosto 2024, la si converte in un Numero Giuliano con gregoriantojd(), e poi si passa quel numero a jdtojewish(). Il risultato viene restituito nel formato mese/giorno/anno usando i numeri del mese e dell'anno del calendario ebraico.

Restituire una stringa in ebraico

Passa true come secondo argomento per visualizzare la data come testo ebraico, e combina i flag per una formattazione più completa:

<?php

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

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

echo $hebrew;
?>

Insidie comuni

• Usa un Numero Giuliano intero, non frazionario. Funzioni come gregoriantojd() restituiscono un conteggio intero. Passare un float come 2459401.5 viene rifiutato nelle versioni moderne di PHP — lavora sempre con interi che rappresentano giorni interi.
• I flag vengono ignorati se $hebrew non è true. Le costanti CAL_JEWISH_* modificano solo l'output nella forma di stringa ebraica.
• L'estensione Calendar deve essere disponibile. jdtojewish() fa parte dell'estensione calendar di PHP. È inclusa per impostazione predefinita nella maggior parte delle distribuzioni, ma se la funzione non è definita, abilita o compila l'estensione.

Funzioni correlate

• jewishtojd() — l'inverso: data ebraica in Numero Giuliano.
• gregoriantojd() — data gregoriana in Numero Giuliano.
• jdtogregorian() — Numero Giuliano in data gregoriana.
• jdmonthname() — nome del mese per un Numero Giuliano in un dato calendario.
• jddayofweek() — giorno della settimana per un Numero Giuliano.

Conclusione

jdtojewish() converte un Numero Giuliano in una data del calendario ebraico, opzionalmente come testo in ebraico. Abbinala a gregoriantojd() (o a qualsiasi altra funzione *tojd()) per convertire tra calendari, ricorda di passare un conteggio di giorni intero, e usa i flag CAL_JEWISH_* solo quando richiedi la forma in stringa ebraica.

Pratica