PHP - Calendar frenchtojd() Function



The PHP Calendar frenchtojd() function is used to convert a date from the French Republican calendar to the Julian Day Count. The Julian Day tally is an endless count of days that starts on January 1, 4713 BC. This function makes it easier to work with historical dates in the French Republican calendar.

Syntax

Below is the syntax of the PHP Calendar frenchtojd() function −

int frenchtojd ( int $month, int $day, int $year )

Parameters

Below are the parameters of the frenchtojd() function −

  • $month − It is the month as a number from 1 to 13.

  • $day − It is the day as a number from 1 to 30.

  • $year − It is the year as a number between 1 and 14.

Return Value

The frenchtojd() function returns the julian day for the given french revolution date as an integer.

PHP Version

First introduced in core PHP 4, the frenchtojd() function continues to function easily in PHP 5, PHP 7, and PHP 8.

Example 1

Here is the basic example of the PHP Calendar frenchtojd() function for basic conversion of a French Republican date to Julian Day.

<?php
   // 1st day of the 1st month in the 1st year
   $jd = frenchtojd(1, 1, 1); 

   // Output the result
   echo $jd;
?>

Output

Here is the outcome of the following code −

2375840

Example 2

In the below PHP code we will try to use the frenchtojd() function and convert a date in the middle of the year.

<?php
   // 15th day of the 7th month in the 2nd year
   $jd = frenchtojd(7, 15, 2); 

   // Output the result
   echo $jd;
?> 

Output

This will generate the below output −

2376139

Example 3

Now the below code converts a date near the end of the French Republican year using frenchtojd() function, and prints it.

<?php
   // 30th day of the 12th month in the 3rd year
   $jd = frenchtojd(12, 30, 3); 

   // Output the result
   echo $jd;
?>

Output

This will create the below output −

2376434

Example 4

In the following example, we are using the frenchtojd() function to convert a date in a leap year of the French Republican calendar.

<?php
   // 1st day of the 13th month (leap year) in the 4th year
   $jd = frenchtojd(13, 1, 4); 

   // Output the result
   echo $jd;
?> 

Output

Following is the output of the above code −

2376506

Example 5

Here is one more PHP code to convert a date from french to julian day.

<?php
   //  3rd day of the 3rd month in the 14th year
   $d = frenchtojd(3, 3, 14);

   // Output the result
   echo($d);
?> 

Output

This will produce the following result −

2380650
php_function_reference.htm
Advertisements