jewishtojd — Funktion · PHP-Referenz

Signatur

jewishtojd(int $month, int $day, int $year): int

Beschreibung

jewishtojd() wandelt ein Datum nach dem jüdischen (hebräischen) Kalender in die entsprechende Julianische Tageszahl (Julian Day Number, JDN) um. Die Julianische Tageszahl ist eine fortlaufende ganzzählige Zählung der Tage seit dem 1. Januar 4713 v. Chr. (julianischer Kalender) und dient als gemeinsame Basis für alle Kalenderkonvertierungen in PHP.

Der jüdische Kalender ist ein lunisolar-Kalender, d. h. er orientiert sich sowohl am Mondlauf als auch am Sonnenjahr. Er umfasst in Schaltjahren 13 Monate (Adar I und Adar II) und in normalen Jahren 12 Monate. Schaltjahre treten in einem 19-Jahres-Zyklus (Metonischer Zyklus) auf. Die Funktion berücksichtigt Schaltjahre und erlaubt daher für Schaltjahre auch den Monat 13.

Typischerweise wird das Ergebnis dieser Funktion zusammen mit jdtogregorian(), jdtojulian() oder anderen JD-Konvertierungsfunktionen verwendet, um jüdische Datumsangaben in bekannte Kalenderformate umzurechnen. Der gültige Bereich umfasst Jahreszahlen von 1 bis 9999 im jüdischen Kalender.

Parameter

Name	Typ	Beschreibung
$month Pflicht	int	Der Monat im jüdischen Kalender (1–13). In normalen Jahren sind 1–12 gültig, in Schaltjahren auch 13 (Adar II).
$day Pflicht	int	Der Tag im jüdischen Monat (1–30, abhängig vom Monat).
$year Pflicht	int	Das Jahr im jüdischen Kalender (1–9999). Das jüdische Jahr 5784 entspricht z. B. dem gregorianischen Jahr 2023/2024.

Rückgabewert

Typ

int

Beschreibung

Gibt die Julianische Tageszahl (Julian Day Number) als Ganzzahl zurück, die dem angegebenen jüdischen Datum entspricht. Bei ungültigen Eingaben kann der Rückgabewert 0 sein.

Beispiele

Jüdisches Datum in gregorianisches Datum umrechnen

<?php
// 1. Tishri 5784 (jüdisches Neujahr, Rosch haSchana) in gregorianisch umrechnen
$month = 7;  // Tishri ist der 7. Monat im jüdischen Kalender
$day   = 1;
$year  = 5784;

$jd = jewishtojd($month, $day, $year);
$gregorianDate = jdtogregorian($jd);

echo "Jüdisch: {$month}/{$day}/{$year}" . PHP_EOL;
echo "Gregorianisch: {$gregorianDate}" . PHP_EOL;

Jüdisch: 7/1/5784 Gregorianisch: 9/16/2023

Mehrere jüdische Feiertage umrechnen und ausgeben

<?php
// Einige jüdische Feiertage im Jahr 5784 und ihre gregorianischen Entsprechungen
$feiertage = [
    'Rosch haSchana' => [7, 1, 5784],
    'Jom Kippur'     => [7, 10, 5784],
    'Pessach'        => [1, 15, 5784],
];

foreach ($feiertage as $name => $datum) {
    [$m, $d, $y] = $datum;
    $jd = jewishtojd($m, $d, $y);
    $greg = jdtogregorian($jd);
    echo "{$name}: jüdisch {$m}/{$d}/{$y} => gregorianisch {$greg}" . PHP_EOL;
}

Rosch haSchana: jüdisch 7/1/5784 => gregorianisch 9/16/2023 Jom Kippur: jüdisch 7/10/5784 => gregorianisch 9/25/2023 Pessach: jüdisch 1/15/5784 => gregorianisch 4/23/2024

// Wichtig · Fallstricke

Schaltjahre: Im jüdischen Kalender gibt es Schaltjahre mit einem zusätzlichen 13. Monat (Adar I/Adar II). Monat 13 ist nur in Schaltjahren gültig; bei Übergabe von Monat 13 in einem normalen Jahr sind die Ergebnisse undefiniert.

Monatszählung: Im jüdischen Kalender beginnt das religiöse Jahr mit Nisan (Monat 1), das zivile Jahr jedoch mit Tishri (Monat 7). Dies kann bei der Übergabe des Monatsparameters zu Verwechslungen führen.

Gültigkeitsbereich: Die Funktion ist für jüdische Jahre zwischen 1 und 9999 ausgelegt. Werte außerhalb dieses Bereichs können zu fehlerhaften Ergebnissen führen.

Die Funktion erfordert die Calendar-Erweiterung (ext/calendar), die in den meisten Standard-PHP-Installationen enthalten ist, aber ggf. separat aktiviert werden muss.

Siehe auch

jdtojewish jdtogregorian gregoriantojd jdtojulian cal_info cal_days_in_month