Signatur
Beschreibung
jdtofrench() wandelt eine Julianische Tageszahl (Julian Day Number, JDN) in ein Datum gemäß dem Kalender der Französischen Revolution (Französischer Republikanischer Kalender) um. Das Ergebnis wird als Zeichenkette im Format Monat/Tag/Jahr zurückgegeben.
Der Republikanische Kalender wurde in Frankreich von 1793 bis 1805 verwendet und beginnt mit dem 22. September 1792 (dem ersten Tag der Ersten Republik). Er besteht aus 12 Monaten zu je 30 Tagen sowie 5 oder 6 Ergänzungstagen (Sanculottides). jdtofrench() ist nützlich für historische Berechnungen oder Anwendungen, die diesen Kalender abbilden müssen.
Um ein reguläres Datum zunächst in eine Julianische Tageszahl umzurechnen, können Funktionen wie gregoriantojd() oder cal_to_jd() verwendet werden. Liegt die übergebene Julianische Tageszahl außerhalb des gültigen Bereichs des Republikanischen Kalenders, gibt die Funktion eine leere Zeichenkette zurück.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $julian_day Pflicht | int | Die Julianische Tageszahl (Julian Day Number), die in ein Datum des Republikanischen Kalenders umgerechnet werden soll. |
Rückgabewert
Monat/Tag/Jahr zurück. Liegt die übergebene Julianische Tageszahl außerhalb des gültigen Bereichs des Republikanischen Kalenders, wird eine leere Zeichenkette ('') zurückgegeben.Beispiele
Gregorianisches Datum in Republikanisches Datum umrechnen
<?php
// 22. September 1792 (Beginn der Ersten Französischen Republik)
$jd = gregoriantojd(9, 22, 1792);
$french = jdtofrench($jd);
echo $french; // Ausgabe: 1/1/1 (1. Vendémiaire, Jahr 1)Heutiges Datum in den Republikanischen Kalender konvertieren
<?php
// Beliebiges historisches Datum: 14. Juli 1794 (Hinrichtung von Robespierre)
$jd = gregoriantojd(7, 28, 1794);
$french = jdtofrench($jd);
echo "Julianische Tageszahl: $jd\n";
echo "Republikanisches Datum: $french\n";Ungültige Julianische Tageszahl (außerhalb des Gültigkeitsbereichs)
<?php
// Datum weit vor Beginn des Republikanischen Kalenders
$jd = gregoriantojd(1, 1, 1700);
$french = jdtofrench($jd);
var_dump($french); // Leere Zeichenkette, da außerhalb des gültigen Bereichs// Wichtig · Fallstricke
Gültigkeitsbereich: Der Republikanische Kalender gilt nur für den Zeitraum vom 22. September 1792 bis zum 22. September 1806 (offiziell abgeschafft am 1. Januar 1806). Julianische Tageszahlen außerhalb dieses Bereichs liefern eine leere Zeichenkette.
Format der Rückgabe: Die zurückgegebene Zeichenkette verwendet keine Monatsnamen, sondern numerische Werte. Monat 1 entspricht Vendémiaire, Monat 13 den Ergänzungstagen (Sanculottides). Eine Übersetzung in Monatsnamen muss manuell implementiert werden.
Diese Funktion ist Teil der Kalendererweiterungs-Funktionen von PHP. Die Erweiterung calendar muss aktiviert sein (in den meisten Standard-PHP-Installationen bereits vorhanden).