cal_info

(PHP 4 >= 4.1.0, PHP 5)

cal_info -- Returns information about a particular calendar

Description

array cal_info ( [int calendar] )

cal_info() returns information on the specified calendar.

Calendar information is returned as an array containing the elements calname, calsymbol, month, abbrevmonth and maxdaysinmonth. The names of the different calendars which can be used as calendar are as follows:

  • 0 or CAL_GREGORIAN - Gregorian Calendar

  • 1 or CAL_JULIAN - Julian Calendar

  • 2 or CAL_JEWISH - Jewish Calendar

  • 3 or CAL_FRENCH - French Revolutionary Calendar

If no calendar is specified information on all supported calendars is returned as an array. This functionality is available beginning with PHP 5.

Пример 1. cal_info() example

<?php
$info
= cal_info(0);
print_r($info);
?>

Результат выполнения данного примера:

Array
(
    [months] => Array
        (
            [1] => January
            [2] => February
            [3] => March
            [4] => April
            [5] => May
            [6] => June
            [7] => July
            [8] => August
            [9] => September
            [10] => October
            [11] => November
            [12] => December
        )

    [abbrevmonths] => Array
        (
            [1] => Jan
            [2] => Feb
            [3] => Mar
            [4] => Apr
            [5] => May
            [6] => Jun
            [7] => Jul
            [8] => Aug
            [9] => Sep
            [10] => Oct
            [11] => Nov
            [12] => Dec
        )

    [maxdaysinmonth] => 31
    [calname] => Gregorian
    [calsymbol] => CAL_GREGORIAN
)



cal_info
colin at wonuke dot org
18-Oct-2005 01:38
The above example doesn't actually output the way that the instructions specify.  Write the code like this to get the more human readable output:

<?php
$info
= cal_info(0);
print (
'<pre>' );
print_r($info);
print (
'</pre>' );
?>
oliver DOT pliquett @mediagear DOT de
27-Nov-2002 05:44
A little example code to show the array structure:

<?php
$aCalendars
= array( CAL_GREGORIAN, CAL_JULIAN, CALL_JEWISH, CAL_FRENCH );

foreach (
$aCalendars as $cal ) {

    
$aCalInfo = cal_info( $cal );

     echo
"cal_info( " . $aCalInfo['calsymbol'] . " ) = ";
    
print_r( $aCalInfo );
     echo
"\n\n";
}
?>

will return this:

cal_info( CAL_GREGORIAN ) = Array
(
   [months] => Array
       (
           [1] => January
           [2] => February
           [3] => March
           [4] => April
           [5] => May
           [6] => June
           [7] => July
           [8] => August
           [9] => September
           [10] => October
           [11] => November
           [12] => December
       )

   [abbrevmonths] => Array
       (
           [1] => Jan
           [2] => Feb
           [3] => Mar
           [4] => Apr
           [5] => May
           [6] => Jun
           [7] => Jul
           [8] => Aug
           [9] => Sep
           [10] => Oct
           [11] => Nov
           [12] => Dec
       )

   [maxdaysinmonth] => 31
   [calname] => Gregorian
   [calsymbol] => CAL_GREGORIAN
)

cal_info( CAL_JULIAN ) = Array
(
   [months] => Array
       (
           [1] => January
           [2] => February
           [3] => March
           [4] => April
           [5] => May
           [6] => June
           [7] => July
           [8] => August
           [9] => September
           [10] => October
           [11] => November
           [12] => December
       )

   [abbrevmonths] => Array
       (
           [1] => Jan
           [2] => Feb
           [3] => Mar
           [4] => Apr
           [5] => May
           [6] => Jun
           [7] => Jul
           [8] => Aug
           [9] => Sep
           [10] => Oct
           [11] => Nov
           [12] => Dec
       )

   [maxdaysinmonth] => 31
   [calname] => Julian
   [calsymbol] => CAL_JULIAN
)

cal_info( CAL_JEWISH ) = Array
(
   [months] => Array
       (
           [1] => Tishri
           [2] => Heshvan
           [3] => Kislev
           [4] => Tevet
           [5] => Shevat
           [6] => AdarI
           [7] => AdarII
           [8] => Nisan
           [9] => Iyyar
           [10] => Sivan
           [11] => Tammuz
           [12] => Av
           [13] => Elul
       )

   [abbrevmonths] => Array
       (
           [1] => Tishri
           [2] => Heshvan
           [3] => Kislev
           [4] => Tevet
           [5] => Shevat
           [6] => AdarI
           [7] => AdarII
           [8] => Nisan
           [9] => Iyyar
           [10] => Sivan
           [11] => Tammuz
           [12] => Av
           [13] => Elul
       )

   [maxdaysinmonth] => 30
   [calname] => Jewish
   [calsymbol] => CAL_JEWISH
)

cal_info( CAL_FRENCH ) = Array
(
   [months] => Array
       (
           [1] => Vendemiaire
           [2] => Brumaire
           [3] => Frimaire
           [4] => Nivose
           [5] => Pluviose
           [6] => Ventose
           [7] => Germinal
           [8] => Floreal
           [9] => Prairial
           [10] => Messidor
           [11] => Thermidor
           [12] => Fructidor
           [13] => Extra
       )

   [abbrevmonths] => Array
       (
           [1] => Vendemiaire
           [2] => Brumaire
           [3] => Frimaire
           [4] => Nivose
           [5] => Pluviose
           [6] => Ventose
           [7] => Germinal
           [8] => Floreal
           [9] => Prairial
           [10] => Messidor
           [11] => Thermidor
           [12] => Fructidor
           [13] => Extra
       )

   [maxdaysinmonth] => 30
   [calname] => French
   [calsymbol] => CAL_FRENCH
)
lovan at lifesci dot ucsb dot edu
07-Mar-2002 04:55
I think I've identified the calendar indexes used in the 'cal_*' functions, though this may be incomplete.
   0  - Gregorian
   1  - Julian
   2  - Jewish
   3  - French Revolutionary

<cal_from_jdcal_to_jd>
 Last updated: Tue, 15 Nov 2005