PHPのjdtofrench()関数とは？ユリウス日をフランス共和暦に変換する方法

PHPのjdtofrench()関数は、ユリウス日（Julian Day Count）をフランス共和暦（フランス革命暦）の日付に変換するための関数です。フランス共和暦は、フランス革命期に導入された暦で、1793年から1805年頃まで実際に使用されていました。

構文

jdtofrench(julian_day);

パラメータ

• julian_day − 変換対象となるユリウス日番号を指定します。

戻り値

jdtofrench()関数は、フランス共和暦の日付を「月/日/年」の形式の文字列として返します。指定されたユリウス日が変換可能な範囲外の場合は、空の文字列または0が返される点に注意してください。

使用例

以下に、jdtofrench()関数の基本的な使用例を示します。

<?php
   $res = frenchtojd(11,11,18);
   echo $res . "<br>";
   echo jdtofrench($res);
?>

出力結果

上記のコードを実行すると、次のような出力が得られます。

2380715
5/8/14

処理の流れの解説

この例では、まずfrenchtojd()関数を使ってフランス共和暦の日付をユリウス日（2380715）に変換し、その結果をjdtofrench()関数に渡すことで、再びフランス共和暦の日付形式の文字列に変換しています。このように、両関数は互いに逆の変換を行うペアとして利用できます。

注意点

PHPのフランス共和暦関連の関数は、共和暦の第1年から第14年まで（グレゴリオ暦で1792年9月22日〜1806年9月23日頃）の日付のみを正しく扱えます。それ以外の日付を指定した場合、期待どおりの結果が得られないことがあるため、実装時には範囲チェックを行うことをおすすめします。