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
)


add a note add a note User Contributed Notes
oliver DOT pliquett @mediagear DOT de
27-Nov-2002 09: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
08-Mar-2002 08: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