cvs: phpdoc /en/reference/calendar/functions cal-days-in-month.xml cal-from-jd.xml cal-info.xml cal-to-jd.xml easter-date.xml easter-days.xml
frenchtojd.xml gregoriantojd.xml jddayofweek.xml jdmonthname.xml jdtofrench.xml jdtogregorian.xml jdtojewish.xml jdtojulian.xml jdtounix.xml
jewishtojd.xml juliantojd.xml unixtojd.xml
| From: | Hartmut Holzgraefe | Date: | Sun, 29 Apr 2007 13:18:58 +0000 |
| Subject: | cvs: phpdoc /en/reference/calendar/functions cal-days-in-month.xml cal-from-jd.xml cal-info.xml cal-to-jd.xml easter-date.xml easter-days.xml frenchtojd.xml gregoriantojd.xml jddayofweek.xml jdmonthname.xml jdtofrench.xml jdtogregorian.xml jdtojewish.xml jdtojulian.xml jdtounix.xml jewishtojd.xml juliantojd.xml unixtojd.xml |
||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969376198@lists.php.net to get a copy of this message | ||
hholzgra Sun Apr 29 13:18:58 2007 UTC
Modified files:
/phpdoc/en/reference/calendar/functions cal-days-in-month.xml
cal-from-jd.xml
cal-info.xml cal-to-jd.xml
easter-date.xml
easter-days.xml
frenchtojd.xml
gregoriantojd.xml
jddayofweek.xml
jdmonthname.xml
jdtofrench.xml
jdtogregorian.xml
jdtojewish.xml
jdtojulian.xml jdtounix.xml
jewishtojd.xml
juliantojd.xml unixtojd.xml
Log:
WS in preparaton for new doc style
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/cal-days-in-month.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/calendar/functions/cal-days-in-month.xml diff -u phpdoc/en/reference/calendar/functions/cal-days-in-month.xml:1.5 phpdoc/en/reference/calendar/functions/cal-days-in-month.xml:1.6 --- phpdoc/en/reference/calendar/functions/cal-days-in-month.xml:1.5 Tue Oct 7 03:49:00 2003 +++ phpdoc/en/reference/calendar/functions/cal-days-in-month.xml Sun Apr 29 13:18:58 2007 @@ -1,42 +1,41 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.19 --> - <refentry id="function.cal-days-in-month"> - <refnamediv> - <refname>cal_days_in_month</refname> - <refpurpose>Return the number of days in a month for a given year and calendar</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>cal_days_in_month</methodname> - <methodparam><type>int</type><parameter>calendar</parameter></methodparam> - <methodparam><type>int</type><parameter>month</parameter></methodparam> - <methodparam><type>int</type><parameter>year</parameter></methodparam> - </methodsynopsis> - <para> - This function will return the number of days in the - <parameter>month</parameter> of <parameter>year</parameter> for - the specified <parameter>calendar</parameter>. - </para> - <para> - <example> - <title><function>cal_days_in_month</function> example</title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<refentry id="function.cal-days-in-month"> + <refnamediv> + <refname>cal_days_in_month</refname> + <refpurpose>Return the number of days in a month for a given year and calendar</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>cal_days_in_month</methodname> + <methodparam><type>int</type><parameter>calendar</parameter></methodparam> + <methodparam><type>int</type><parameter>month</parameter></methodparam> + <methodparam><type>int</type><parameter>year</parameter></methodparam> + </methodsynopsis> + <para> + This function will return the number of days in the + <parameter>month</parameter> of <parameter>year</parameter> for + the specified <parameter>calendar</parameter>. + </para> + <para> + <example> + <title><function>cal_days_in_month</function> example</title> + <programlisting role="php"> <![CDATA[ <?php $num = cal_days_in_month(CAL_GREGORIAN, 8, 2003); // 31 echo "There was $num days in August 2003"; ?> ]]> - </programlisting> - </example> - </para> - <para> - See also <function>jdtounix</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + See also <function>jdtounix</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/cal-from-jd.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc/en/reference/calendar/functions/cal-from-jd.xml diff -u phpdoc/en/reference/calendar/functions/cal-from-jd.xml:1.9 phpdoc/en/reference/calendar/functions/cal-from-jd.xml:1.10 --- phpdoc/en/reference/calendar/functions/cal-from-jd.xml:1.9 Mon Nov 1 13:25:29 2004 +++ phpdoc/en/reference/calendar/functions/cal-from-jd.xml Sun Apr 29 13:18:58 2007 @@ -1,41 +1,40 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.19 --> - <refentry id='function.cal-from-jd'> - <refnamediv> - <refname>cal_from_jd</refname> - <refpurpose>Converts from Julian Day Count to a supported calendar</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>array</type><methodname>cal_from_jd</methodname> - <methodparam><type>int</type><parameter>jd</parameter></methodparam> - <methodparam><type>int</type><parameter>calendar</parameter></methodparam> - </methodsynopsis> - <para> - <function>cal_from_jd</function> converts the Julian day given in - <parameter>jd</parameter> into a date of the specified - <parameter>calendar</parameter>. Supported - <parameter>calendar</parameter> values are - <constant>CAL_GREGORIAN</constant>, - <constant>CAL_JULIAN</constant>, - <constant>CAL_JEWISH</constant> and - <constant>CAL_FRENCH</constant>. - </para> - <para> - <example> - <title><function>cal_from_jd</function> example</title> - <programlisting role="php"> +<!-- $Revision: 1.10 $ --> +<refentry id='function.cal-from-jd'> + <refnamediv> + <refname>cal_from_jd</refname> + <refpurpose>Converts from Julian Day Count to a supported calendar</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>array</type><methodname>cal_from_jd</methodname> + <methodparam><type>int</type><parameter>jd</parameter></methodparam> + <methodparam><type>int</type><parameter>calendar</parameter></methodparam> + </methodsynopsis> + <para> + <function>cal_from_jd</function> converts the Julian day given in + <parameter>jd</parameter> into a date of the specified + <parameter>calendar</parameter>. Supported + <parameter>calendar</parameter> values are + <constant>CAL_GREGORIAN</constant>, + <constant>CAL_JULIAN</constant>, + <constant>CAL_JEWISH</constant> and + <constant>CAL_FRENCH</constant>. + </para> + <para> + <example> + <title><function>cal_from_jd</function> example</title> + <programlisting role="php"> <![CDATA[ <?php $today = unixtojd(mktime(0, 0, 0, 8, 16, 2003)); print_r(cal_from_jd($today, CAL_GREGORIAN)); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Array ( @@ -50,14 +49,14 @@ [monthname] => August ) ]]> - </screen> - </example> - </para> - <para> - See also <function>cal_to_jd</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + <para> + See also <function>cal_to_jd</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/cal-info.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc/en/reference/calendar/functions/cal-info.xml diff -u phpdoc/en/reference/calendar/functions/cal-info.xml:1.13 phpdoc/en/reference/calendar/functions/cal-info.xml:1.14 --- phpdoc/en/reference/calendar/functions/cal-info.xml:1.13 Wed Apr 6 07:57:26 2005 +++ phpdoc/en/reference/calendar/functions/cal-info.xml Sun Apr 29 13:18:58 2007 @@ -1,68 +1,67 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.19 --> - <refentry id='function.cal-info'> - <refnamediv> - <refname>cal_info</refname> - <refpurpose>Returns information about a particular calendar</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>array</type><methodname>cal_info</methodname> - <methodparam choice="opt"><type>int</type><parameter>calendar</parameter></methodparam> - </methodsynopsis> - <para> - <function>cal_info</function> returns information on the - specified <parameter>calendar</parameter>. - </para> - <para> - Calendar information is returned as an array containing the - elements <literal>calname</literal>, <literal>calsymbol</literal>, - <literal>month</literal>, <literal>abbrevmonth</literal> and - <literal>maxdaysinmonth</literal>. The names of the different calendars - which can be used as <parameter>calendar</parameter> are as follows: - <itemizedlist> - <listitem> - <simpara> - 0 or <constant>CAL_GREGORIAN</constant> - Gregorian Calendar - </simpara> - </listitem> - <listitem> - <simpara> - 1 or <constant>CAL_JULIAN</constant> - Julian Calendar - </simpara> - </listitem> - <listitem> - <simpara> - 2 or <constant>CAL_JEWISH</constant> - Jewish Calendar - </simpara> - </listitem> - <listitem> - <simpara> - 3 or <constant>CAL_FRENCH</constant> - French Revolutionary Calendar - </simpara> - </listitem> - </itemizedlist> - </para> - <para> - If no <parameter>calendar</parameter> is specified information on all - supported calendars is returned as an array. This functionality - is available beginning with PHP 5. - </para> - <para> - <example> - <title><function>cal_info</function> example</title> - <programlisting role="php"> +<!-- $Revision: 1.14 $ --> +<refentry id='function.cal-info'> + <refnamediv> + <refname>cal_info</refname> + <refpurpose>Returns information about a particular calendar</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>array</type><methodname>cal_info</methodname> + <methodparam choice="opt"><type>int</type><parameter>calendar</parameter></methodparam> + </methodsynopsis> + <para> + <function>cal_info</function> returns information on the + specified <parameter>calendar</parameter>. + </para> + <para> + Calendar information is returned as an array containing the + elements <literal>calname</literal>, <literal>calsymbol</literal>, + <literal>month</literal>, <literal>abbrevmonth</literal> and + <literal>maxdaysinmonth</literal>. The names of the different calendars + which can be used as <parameter>calendar</parameter> are as follows: + <itemizedlist> + <listitem> + <simpara> + 0 or <constant>CAL_GREGORIAN</constant> - Gregorian Calendar + </simpara> + </listitem> + <listitem> + <simpara> + 1 or <constant>CAL_JULIAN</constant> - Julian Calendar + </simpara> + </listitem> + <listitem> + <simpara> + 2 or <constant>CAL_JEWISH</constant> - Jewish Calendar + </simpara> + </listitem> + <listitem> + <simpara> + 3 or <constant>CAL_FRENCH</constant> - French Revolutionary Calendar + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + If no <parameter>calendar</parameter> is specified information on all + supported calendars is returned as an array. This functionality + is available beginning with PHP 5. + </para> + <para> + <example> + <title><function>cal_info</function> example</title> + <programlisting role="php"> <![CDATA[ <?php $info = cal_info(0); print_r($info); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Array ( @@ -103,11 +102,11 @@ [calsymbol] => CAL_GREGORIAN ) ]]> - </screen> - </example> - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/cal-to-jd.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/calendar/functions/cal-to-jd.xml diff -u phpdoc/en/reference/calendar/functions/cal-to-jd.xml:1.8 phpdoc/en/reference/calendar/functions/cal-to-jd.xml:1.9 --- phpdoc/en/reference/calendar/functions/cal-to-jd.xml:1.8 Fri Apr 22 15:39:25 2005 +++ phpdoc/en/reference/calendar/functions/cal-to-jd.xml Sun Apr 29 13:18:58 2007 @@ -1,34 +1,33 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.19 --> - <refentry id='function.cal-to-jd'> - <refnamediv> - <refname>cal_to_jd</refname> - <refpurpose>Converts from a supported calendar to Julian Day Count</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>cal_to_jd</methodname> - <methodparam><type>int</type><parameter>calendar</parameter></methodparam> - <methodparam><type>int</type><parameter>month</parameter></methodparam> - <methodparam><type>int</type><parameter>day</parameter></methodparam> - <methodparam><type>int</type><parameter>year</parameter></methodparam> - </methodsynopsis> - <para> - <function>cal_to_jd</function> calculates the Julian day count - for a date in the specified <parameter>calendar</parameter>. - Supported <parameter>calendar</parameter>s are - <constant>CAL_GREGORIAN</constant>, - <constant>CAL_JULIAN</constant>, - <constant>CAL_JEWISH</constant> and - <constant>CAL_FRENCH</constant>. - </para> - <para> - See also <function>cal_from_jd</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.9 $ --> +<refentry id='function.cal-to-jd'> + <refnamediv> + <refname>cal_to_jd</refname> + <refpurpose>Converts from a supported calendar to Julian Day Count</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>cal_to_jd</methodname> + <methodparam><type>int</type><parameter>calendar</parameter></methodparam> + <methodparam><type>int</type><parameter>month</parameter></methodparam> + <methodparam><type>int</type><parameter>day</parameter></methodparam> + <methodparam><type>int</type><parameter>year</parameter></methodparam> + </methodsynopsis> + <para> + <function>cal_to_jd</function> calculates the Julian day count + for a date in the specified <parameter>calendar</parameter>. + Supported <parameter>calendar</parameter>s are + <constant>CAL_GREGORIAN</constant>, + <constant>CAL_JULIAN</constant>, + <constant>CAL_JEWISH</constant> and + <constant>CAL_FRENCH</constant>. + </para> + <para> + See also <function>cal_from_jd</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/easter-date.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc/en/reference/calendar/functions/easter-date.xml diff -u phpdoc/en/reference/calendar/functions/easter-date.xml:1.12 phpdoc/en/reference/calendar/functions/easter-date.xml:1.13 --- phpdoc/en/reference/calendar/functions/easter-date.xml:1.12 Tue Aug 10 16:30:16 2004 +++ phpdoc/en/reference/calendar/functions/easter-date.xml Sun Apr 29 13:18:58 2007 @@ -1,32 +1,29 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.2 --> - <refentry id="function.easter-date"> - <refnamediv> - <refname>easter_date</refname> - <refpurpose> - Get Unix timestamp for midnight on Easter of a given year - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>easter_date</methodname> - <methodparam choice="opt"><type>int</type><parameter>year</parameter></methodparam> - </methodsynopsis> - <para> - Returns the Unix timestamp corresponding to midnight on Easter of - the given year. - </para> - <para> - Since PHP 4.3.0, the <parameter>year</parameter> - parameter is optional and defaults to the current year according to the - localtime if omitted. - </para> - <para> - <example> - <title><function>easter_date</function> example</title> - <programlisting role="php"> +<!-- $Revision: 1.13 $ --> +<refentry id="function.easter-date"> + <refnamediv> + <refname>easter_date</refname> + <refpurpose>Get Unix timestamp for midnight on Easter of a given year</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>easter_date</methodname> + <methodparam choice="opt"><type>int</type><parameter>year</parameter></methodparam> + </methodsynopsis> + <para> + Returns the Unix timestamp corresponding to midnight on Easter of + the given year. + </para> + <para> + Since PHP 4.3.0, the <parameter>year</parameter> + parameter is optional and defaults to the current year according to the + localtime if omitted. + </para> + <para> + <example> + <title><function>easter_date</function> example</title> + <programlisting role="php"> <![CDATA[ <?php @@ -36,40 +33,40 @@ ?> ]]> - </programlisting> - </example> - </para> - <warning> - <para> - This function will generate a warning if the year is outside - of the range for Unix timestamps (i.e. before 1970 or after 2037). - </para> - </warning> - <para> - The date of Easter Day was defined by the Council of Nicaea in - AD325 as the Sunday after the first full moon which falls on or - after the Spring Equinox. The Equinox is assumed to always fall - on 21st March, so the calculation reduces to determining the date - of the full moon and the date of the following Sunday. The - algorithm used here was introduced around the year 532 by - Dionysius Exiguus. Under the Julian Calendar (for years before - 1753) a simple 19-year cycle is used to track the phases of the - Moon. Under the Gregorian Calendar (for years after 1753 - - devised by Clavius and Lilius, and introduced by Pope Gregory - XIII in October 1582, and into Britain and its then colonies in - September 1752) two correction factors are added to make the - cycle more accurate. - </para> - <para> - (The code is based on a C program by Simon Kershaw, - <webmaster at ely.anglican dot org>) - </para> - <para> - See <function>easter_days</function> for calculating Easter - before 1970 or after 2037. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <warning> + <para> + This function will generate a warning if the year is outside + of the range for Unix timestamps (i.e. before 1970 or after 2037). + </para> + </warning> + <para> + The date of Easter Day was defined by the Council of Nicaea in + AD325 as the Sunday after the first full moon which falls on or + after the Spring Equinox. The Equinox is assumed to always fall + on 21st March, so the calculation reduces to determining the date + of the full moon and the date of the following Sunday. The + algorithm used here was introduced around the year 532 by + Dionysius Exiguus. Under the Julian Calendar (for years before + 1753) a simple 19-year cycle is used to track the phases of the + Moon. Under the Gregorian Calendar (for years after 1753 - + devised by Clavius and Lilius, and introduced by Pope Gregory + XIII in October 1582, and into Britain and its then colonies in + September 1752) two correction factors are added to make the + cycle more accurate. + </para> + <para> + (The code is based on a C program by Simon Kershaw, + <webmaster at ely.anglican dot org>) + </para> + <para> + See <function>easter_days</function> for calculating Easter + before 1970 or after 2037. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/easter-days.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc/en/reference/calendar/functions/easter-days.xml diff -u phpdoc/en/reference/calendar/functions/easter-days.xml:1.11 phpdoc/en/reference/calendar/functions/easter-days.xml:1.12 --- phpdoc/en/reference/calendar/functions/easter-days.xml:1.11 Tue Aug 10 16:30:16 2004 +++ phpdoc/en/reference/calendar/functions/easter-days.xml Sun Apr 29 13:18:58 2007 @@ -1,47 +1,43 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.2 --> - <refentry id="function.easter-days"> - <refnamediv> - <refname>easter_days</refname> - <refpurpose> - Get number of days after March 21 on which Easter falls for a - given year - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>easter_days</methodname> - <methodparam choice="opt"><type>int</type><parameter>year</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>method</parameter></methodparam> - </methodsynopsis> - <para> - Returns the number of days after March 21 on which Easter falls - for a given year. If no year is specified, the current year is - assumed. - </para> - <para> - Since PHP 4.3.0, the <parameter>year</parameter> - parameter is optional and defaults to the current year according to the - localtime if omitted. - </para> - <para> - The <parameter>method</parameter> parameter was also introduced in - PHP 4.3.0 and allows to calculate easter dates based - on the Gregorian calendar during the years 1582 - 1752 when set to - <constant>CAL_EASTER_ROMAN</constant>. See the <link - linkend="calendar.constants">calendar constants</link> for more valid - constants. - </para> - <para> - This function can be used instead of - <function>easter_date</function> to calculate Easter for years - which fall outside the range of Unix timestamps (i.e. before 1970 - or after 2037). - <example> - <title><function>easter_days</function> example</title> - <programlisting role="php"> +<!-- $Revision: 1.12 $ --> +<refentry id="function.easter-days"> + <refnamediv> + <refname>easter_days</refname> + <refpurpose>Get number of days after March 21 on which Easter falls for a given year</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>easter_days</methodname> + <methodparam choice="opt"><type>int</type><parameter>year</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>method</parameter></methodparam> + </methodsynopsis> + <para> + Returns the number of days after March 21 on which Easter falls + for a given year. If no year is specified, the current year is + assumed. + </para> + <para> + Since PHP 4.3.0, the <parameter>year</parameter> + parameter is optional and defaults to the current year according to the + localtime if omitted. + </para> + <para> + The <parameter>method</parameter> parameter was also introduced in + PHP 4.3.0 and allows to calculate easter dates based + on the Gregorian calendar during the years 1582 - 1752 when set to + <constant>CAL_EASTER_ROMAN</constant>. See the <link + linkend="calendar.constants">calendar constants</link> for more valid + constants. + </para> + <para> + This function can be used instead of + <function>easter_date</function> to calculate Easter for years + which fall outside the range of Unix timestamps (i.e. before 1970 + or after 2037). + <example> + <title><function>easter_days</function> example</title> + <programlisting role="php"> <![CDATA[ <?php @@ -51,33 +47,33 @@ ?> ]]> - </programlisting> - </example> - </para> - <para> - The date of Easter Day was defined by the Council of Nicaea in - AD325 as the Sunday after the first full moon which falls on or - after the Spring Equinox. The Equinox is assumed to always fall - on 21st March, so the calculation reduces to determining the date - of the full moon and the date of the following Sunday. The - algorithm used here was introduced around the year 532 by - Dionysius Exiguus. Under the Julian Calendar (for years before - 1753) a simple 19-year cycle is used to track the phases of the - Moon. Under the Gregorian Calendar (for years after 1753 - - devised by Clavius and Lilius, and introduced by Pope Gregory - XIII in October 1582, and into Britain and its then colonies in - September 1752) two correction factors are added to make the - cycle more accurate. - </para> - <para> - (The code is based on a C program by Simon Kershaw, - <webmaster at ely.anglican dot org>) - </para> - <para> - See also <function>easter_date</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + The date of Easter Day was defined by the Council of Nicaea in + AD325 as the Sunday after the first full moon which falls on or + after the Spring Equinox. The Equinox is assumed to always fall + on 21st March, so the calculation reduces to determining the date + of the full moon and the date of the following Sunday. The + algorithm used here was introduced around the year 532 by + Dionysius Exiguus. Under the Julian Calendar (for years before + 1753) a simple 19-year cycle is used to track the phases of the + Moon. Under the Gregorian Calendar (for years after 1753 - + devised by Clavius and Lilius, and introduced by Pope Gregory + XIII in October 1582, and into Britain and its then colonies in + September 1752) two correction factors are added to make the + cycle more accurate. + </para> + <para> + (The code is based on a C program by Simon Kershaw, + <webmaster at ely.anglican dot org>) + </para> + <para> + See also <function>easter_date</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/frenchtojd.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/calendar/functions/frenchtojd.xml diff -u phpdoc/en/reference/calendar/functions/frenchtojd.xml:1.4 phpdoc/en/reference/calendar/functions/frenchtojd.xml:1.5 --- phpdoc/en/reference/calendar/functions/frenchtojd.xml:1.4 Tue Oct 7 03:49:01 2003 +++ phpdoc/en/reference/calendar/functions/frenchtojd.xml Sun Apr 29 13:18:58 2007 @@ -1,34 +1,30 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 --> - <refentry id="function.frenchtojd"> - <refnamediv> - <refname>FrenchToJD</refname> - <refpurpose> - Converts a date from the French Republican Calendar to a Julian - Day Count - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>frenchtojd</methodname> - <methodparam><type>int</type><parameter>month</parameter></methodparam> - <methodparam><type>int</type><parameter>day</parameter></methodparam> - <methodparam><type>int</type><parameter>year</parameter></methodparam> - </methodsynopsis> - <para> - Converts a date from the French Republican Calendar to a Julian - Day Count. - </para> - <para> - These routines only convert dates in years 1 through 14 - (Gregorian dates 22 September 1792 through 22 September - 1806). This more than covers the period when the calendar was in - use. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.frenchtojd"> + <refnamediv> + <refname>FrenchToJD</refname> + <refpurpose>Converts a date from the French Republican Calendar to a Julian Day Count</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>frenchtojd</methodname> + <methodparam><type>int</type><parameter>month</parameter></methodparam> + <methodparam><type>int</type><parameter>day</parameter></methodparam> + <methodparam><type>int</type><parameter>year</parameter></methodparam> + </methodsynopsis> + <para> + Converts a date from the French Republican Calendar to a Julian + Day Count. + </para> + <para> + These routines only convert dates in years 1 through 14 + (Gregorian dates 22 September 1792 through 22 September + 1806). This more than covers the period when the calendar was in + use. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/gregoriantojd.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/calendar/functions/gregoriantojd.xml diff -u phpdoc/en/reference/calendar/functions/gregoriantojd.xml:1.6 phpdoc/en/reference/calendar/functions/gregoriantojd.xml:1.7 --- phpdoc/en/reference/calendar/functions/gregoriantojd.xml:1.6 Thu Dec 18 17:43:30 2003 +++ phpdoc/en/reference/calendar/functions/gregoriantojd.xml Sun Apr 29 13:18:58 2007 @@ -1,34 +1,31 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 --> - <refentry id="function.gregoriantojd"> - <refnamediv> - <refname>GregorianToJD</refname> - <refpurpose> - Converts a Gregorian date to Julian Day Count - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>gregoriantojd</methodname> - <methodparam><type>int</type><parameter>month</parameter></methodparam> - <methodparam><type>int</type><parameter>day</parameter></methodparam> - <methodparam><type>int</type><parameter>year</parameter></methodparam> - </methodsynopsis> - <para> - Valid Range for Gregorian Calendar 4714 B.C. to 9999 A.D.</para> - <para> - Although this function can handle dates all the way back to 4714 - B.C., such use may not be meaningful. The Gregorian calendar was - not instituted until October 15, 1582 (or October 5, 1582 in the - Julian calendar). Some countries did not accept it until much - later. For example, Britain converted in 1752, The USSR in 1918 - and Greece in 1923. Most European countries used the Julian - calendar prior to the Gregorian. - <example> - <title>Calendar functions</title> - <programlisting role="php"> +<!-- $Revision: 1.7 $ --> +<refentry id="function.gregoriantojd"> + <refnamediv> + <refname>GregorianToJD</refname> + <refpurpose>Converts a Gregorian date to Julian Day Count</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>gregoriantojd</methodname> + <methodparam><type>int</type><parameter>month</parameter></methodparam> + <methodparam><type>int</type><parameter>day</parameter></methodparam> + <methodparam><type>int</type><parameter>year</parameter></methodparam> + </methodsynopsis> + <para> + Valid Range for Gregorian Calendar 4714 B.C. to 9999 A.D.</para> + <para> + Although this function can handle dates all the way back to 4714 + B.C., such use may not be meaningful. The Gregorian calendar was + not instituted until October 15, 1582 (or October 5, 1582 in the + Julian calendar). Some countries did not accept it until much + later. For example, Britain converted in 1752, The USSR in 1918 + and Greece in 1923. Most European countries used the Julian + calendar prior to the Gregorian. + <example> + <title>Calendar functions</title> + <programlisting role="php"> <![CDATA[ <?php $jd = GregorianToJD(10, 11, 1970); @@ -37,11 +34,11 @@ echo "$gregorian\n"; ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/jddayofweek.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/calendar/functions/jddayofweek.xml diff -u phpdoc/en/reference/calendar/functions/jddayofweek.xml:1.6 phpdoc/en/reference/calendar/functions/jddayofweek.xml:1.7 --- phpdoc/en/reference/calendar/functions/jddayofweek.xml:1.6 Thu Aug 12 18:11:56 2004 +++ phpdoc/en/reference/calendar/functions/jddayofweek.xml Sun Apr 29 13:18:58 2007 @@ -1,57 +1,56 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 --> - <refentry id="function.jddayofweek"> - <refnamediv> - <refname>JDDayOfWeek</refname> - <refpurpose>Returns the day of the week</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>mixed</type><methodname>jddayofweek</methodname> - <methodparam><type>int</type><parameter>julianday</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> - </methodsynopsis> - <para> - Returns the day of the week. Can return a string or an integer - depending on the mode. - <table> - <title>Calendar week modes</title> - <tgroup cols="2"> - <thead> - <row> - <entry>Mode</entry> - <entry>Meaning</entry> - </row> - </thead> - <tbody> - <row> - <entry>0 (Default)</entry> - <entry> - Returns the day number as an int (0=Sunday, 1=Monday, etc) - </entry> - </row> - <row> - <entry>1</entry> - <entry> - Returns string containing the day of week - (English-Gregorian) - </entry> - </row> - <row> - <entry>2</entry> - <entry> - Returns a string containing the abbreviated day of week - (English-Gregorian) - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<refentry id="function.jddayofweek"> + <refnamediv> + <refname>JDDayOfWeek</refname> + <refpurpose>Returns the day of the week</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>mixed</type><methodname>jddayofweek</methodname> + <methodparam><type>int</type><parameter>julianday</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> + </methodsynopsis> + <para> + Returns the day of the week. Can return a string or an integer + depending on the mode. + <table> + <title>Calendar week modes</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Mode</entry> + <entry>Meaning</entry> + </row> + </thead> + <tbody> + <row> + <entry>0 (Default)</entry> + <entry> + Returns the day number as an int (0=Sunday, 1=Monday, etc) + </entry> + </row> + <row> + <entry>1</entry> + <entry> + Returns string containing the day of week + (English-Gregorian) + </entry> + </row> + <row> + <entry>2</entry> + <entry> + Returns a string containing the abbreviated day of week + (English-Gregorian) + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/jdmonthname.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/calendar/functions/jdmonthname.xml diff -u phpdoc/en/reference/calendar/functions/jdmonthname.xml:1.4 phpdoc/en/reference/calendar/functions/jdmonthname.xml:1.5 --- phpdoc/en/reference/calendar/functions/jdmonthname.xml:1.4 Tue Oct 7 03:49:01 2003 +++ phpdoc/en/reference/calendar/functions/jdmonthname.xml Sun Apr 29 13:18:58 2007 @@ -1,70 +1,69 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 --> - <refentry id="function.jdmonthname"> - <refnamediv> - <refname>JDMonthName</refname> - <refpurpose>Returns a month name</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>jdmonthname</methodname> - <methodparam><type>int</type><parameter>julianday</parameter></methodparam> - <methodparam><type>int</type><parameter>mode</parameter></methodparam> - </methodsynopsis> - <para> - Returns a string containing a month name. - <parameter>mode</parameter> tells this function which calendar to - convert the Julian Day Count to, and what type of month names are - to be returned. - <table> - <title>Calendar modes</title> - <tgroup cols="3"> - <thead> - <row> - <entry>Mode</entry> - <entry>Meaning</entry> - <entry>Values</entry> - </row> - </thead> - <tbody> - <row> - <entry>0</entry> - <entry>Gregorian - abbreviated</entry> - <entry>Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec</entry> - </row> - <row> - <entry>1</entry> - <entry>Gregorian</entry> - <entry>January, February, March, April, May, June, July, August, September, October, November, December</entry> - </row> - <row> - <entry>2</entry> - <entry>Julian - abbreviated</entry> - <entry>Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec</entry> - </row> - <row> - <entry>3</entry> - <entry>Julian</entry> - <entry>January, February, March, April, May, June, July, August, September, October, November, December</entry> - </row> - <row> - <entry>4</entry> - <entry>Jewish</entry> - <entry>Tishri, Heshvan, Kislev, Tevet, Shevat, AdarI, AdarII, Nisan, Iyyar, Sivan, Tammuz, Av, Elul</entry> - </row> - <row> - <entry>5</entry> - <entry>French Republican</entry> - <entry>Vendemiaire, Brumaire, Frimaire, Nivose, Pluviose, Ventose, Germinal, Floreal, Prairial, Messidor, Thermidor, Fructidor, Extra</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.jdmonthname"> + <refnamediv> + <refname>JDMonthName</refname> + <refpurpose>Returns a month name</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>string</type><methodname>jdmonthname</methodname> + <methodparam><type>int</type><parameter>julianday</parameter></methodparam> + <methodparam><type>int</type><parameter>mode</parameter></methodparam> + </methodsynopsis> + <para> + Returns a string containing a month name. + <parameter>mode</parameter> tells this function which calendar to + convert the Julian Day Count to, and what type of month names are + to be returned. + <table> + <title>Calendar modes</title> + <tgroup cols="3"> + <thead> + <row> + <entry>Mode</entry> + <entry>Meaning</entry> + <entry>Values</entry> + </row> + </thead> + <tbody> + <row> + <entry>0</entry> + <entry>Gregorian - abbreviated</entry> + <entry>Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec</entry> + </row> + <row> + <entry>1</entry> + <entry>Gregorian</entry> + <entry>January, February, March, April, May, June, July, August, September, October, November, December</entry> + </row> + <row> + <entry>2</entry> + <entry>Julian - abbreviated</entry> + <entry>Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec</entry> + </row> + <row> + <entry>3</entry> + <entry>Julian</entry> + <entry>January, February, March, April, May, June, July, August, September, October, November, December</entry> + </row> + <row> + <entry>4</entry> + <entry>Jewish</entry> + <entry>Tishri, Heshvan, Kislev, Tevet, Shevat, AdarI, AdarII, Nisan, Iyyar, Sivan, Tammuz, Av, Elul</entry> + </row> + <row> + <entry>5</entry> + <entry>French Republican</entry> + <entry>Vendemiaire, Brumaire, Frimaire, Nivose, Pluviose, Ventose, Germinal, Floreal, Prairial, Messidor, Thermidor, Fructidor, Extra</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/jdtofrench.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/calendar/functions/jdtofrench.xml diff -u phpdoc/en/reference/calendar/functions/jdtofrench.xml:1.4 phpdoc/en/reference/calendar/functions/jdtofrench.xml:1.5 --- phpdoc/en/reference/calendar/functions/jdtofrench.xml:1.4 Tue Oct 7 03:49:01 2003 +++ phpdoc/en/reference/calendar/functions/jdtofrench.xml Sun Apr 29 13:18:58 2007 @@ -1,24 +1,21 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 --> - <refentry id="function.jdtofrench"> - <refnamediv> - <refname>JDToFrench</refname> - <refpurpose> - Converts a Julian Day Count to the French Republican Calendar - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>jdtofrench</methodname> - <methodparam><type>int</type><parameter>juliandaycount</parameter></methodparam> - </methodsynopsis> - <para> - Converts a Julian Day Count to the French Republican Calendar. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.jdtofrench"> + <refnamediv> + <refname>JDToFrench</refname> + <refpurpose>Converts a Julian Day Count to the French Republican Calendar</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>string</type><methodname>jdtofrench</methodname> + <methodparam><type>int</type><parameter>juliandaycount</parameter></methodparam> + </methodsynopsis> + <para> + Converts a Julian Day Count to the French Republican Calendar. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/jdtogregorian.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/calendar/functions/jdtogregorian.xml diff -u phpdoc/en/reference/calendar/functions/jdtogregorian.xml:1.4 phpdoc/en/reference/calendar/functions/jdtogregorian.xml:1.5 --- phpdoc/en/reference/calendar/functions/jdtogregorian.xml:1.4 Tue Oct 7 03:49:01 2003 +++ phpdoc/en/reference/calendar/functions/jdtogregorian.xml Sun Apr 29 13:18:58 2007 @@ -1,23 +1,22 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 --> - <refentry id="function.jdtogregorian"> - <refnamediv> - <refname>JDToGregorian</refname> - <refpurpose>Converts Julian Day Count to Gregorian date</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>jdtogregorian</methodname> - <methodparam><type>int</type><parameter>julianday</parameter></methodparam> - </methodsynopsis> - <para> - Converts Julian Day Count to a string containing the Gregorian - date in the format of "month/day/year". - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.jdtogregorian"> + <refnamediv> + <refname>JDToGregorian</refname> + <refpurpose>Converts Julian Day Count to Gregorian date</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>string</type><methodname>jdtogregorian</methodname> + <methodparam><type>int</type><parameter>julianday</parameter></methodparam> + </methodsynopsis> + <para> + Converts Julian Day Count to a string containing the Gregorian + date in the format of "month/day/year". + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/jdtojewish.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc/en/reference/calendar/functions/jdtojewish.xml diff -u phpdoc/en/reference/calendar/functions/jdtojewish.xml:1.11 phpdoc/en/reference/calendar/functions/jdtojewish.xml:1.12 --- phpdoc/en/reference/calendar/functions/jdtojewish.xml:1.11 Mon Feb 9 23:52:15 2004 +++ phpdoc/en/reference/calendar/functions/jdtojewish.xml Sun Apr 29 13:18:58 2007 @@ -1,51 +1,48 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 --> - <refentry id="function.jdtojewish"> - <refnamediv> - <refname>jdtojewish</refname> - <refpurpose> - Converts a Julian day count to a Jewish calendar date - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>jdtojewish</methodname> - <methodparam><type>int</type><parameter>juliandaycount</parameter></methodparam> - <methodparam choice="opt"><type>bool</type><parameter>hebrew</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>fl</parameter></methodparam> - </methodsynopsis> - <para> - Converts a Julian Day Count to the Jewish Calendar. - </para> - <para> - The optional <parameter>hebrew</parameter> and <parameter>fl</parameter> - parameters became available in PHP 5.0.0 - </para> - <para> - If the <parameter>hebrew</parameter> parameter is set to &true;, the - <parameter>fl</parameter> parameter is used for Hebrew, string based, - output format. The available formats are: - <constant>CAL_JEWISH_ADD_ALAFIM_GERESH</constant>, - <constant>CAL_JEWISH_ADD_ALAFIM</constant>, - <constant>CAL_JEWISH_ADD_GERESHAYIM</constant>. - </para> - <para> - <example> - <title><function>jdtojewish</function> Example</title> - <programlisting role="php"> +<!-- $Revision: 1.12 $ --> +<refentry id="function.jdtojewish"> + <refnamediv> + <refname>jdtojewish</refname> + <refpurpose>Converts a Julian day count to a Jewish calendar date</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>string</type><methodname>jdtojewish</methodname> + <methodparam><type>int</type><parameter>juliandaycount</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>hebrew</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>fl</parameter></methodparam> + </methodsynopsis> + <para> + Converts a Julian Day Count to the Jewish Calendar. + </para> + <para> + The optional <parameter>hebrew</parameter> and <parameter>fl</parameter> + parameters became available in PHP 5.0.0 + </para> + <para> + If the <parameter>hebrew</parameter> parameter is set to &true;, the + <parameter>fl</parameter> parameter is used for Hebrew, string based, + output format. The available formats are: + <constant>CAL_JEWISH_ADD_ALAFIM_GERESH</constant>, + <constant>CAL_JEWISH_ADD_ALAFIM</constant>, + <constant>CAL_JEWISH_ADD_GERESHAYIM</constant>. + </para> + <para> + <example> + <title><function>jdtojewish</function> Example</title> + <programlisting role="php"> <![CDATA[ <?php echo jdtojewish(gregoriantojd(10, 8, 2002), true, CAL_JEWISH_ADD_GERESHAYIM + CAL_JEWISH_ADD_ALAFIM + CAL_JEWISH_ADD_ALAFIM_GERESH); ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/jdtojulian.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/calendar/functions/jdtojulian.xml diff -u phpdoc/en/reference/calendar/functions/jdtojulian.xml:1.4 phpdoc/en/reference/calendar/functions/jdtojulian.xml:1.5 --- phpdoc/en/reference/calendar/functions/jdtojulian.xml:1.4 Tue Oct 7 03:49:01 2003 +++ phpdoc/en/reference/calendar/functions/jdtojulian.xml Sun Apr 29 13:18:58 2007 @@ -1,25 +1,22 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 --> - <refentry id="function.jdtojulian"> - <refnamediv> - <refname>JDToJulian</refname> - <refpurpose> - Converts a Julian Day Count to a Julian Calendar Date - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>jdtojulian</methodname> - <methodparam><type>int</type><parameter>julianday</parameter></methodparam> - </methodsynopsis> - <para> - Converts Julian Day Count to a string containing the Julian - Calendar Date in the format of "month/day/year". - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.jdtojulian"> + <refnamediv> + <refname>JDToJulian</refname> + <refpurpose>Converts a Julian Day Count to a Julian Calendar Date</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>string</type><methodname>jdtojulian</methodname> + <methodparam><type>int</type><parameter>julianday</parameter></methodparam> + </methodsynopsis> + <para> + Converts Julian Day Count to a string containing the Julian + Calendar Date in the format of "month/day/year". + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/jdtounix.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/calendar/functions/jdtounix.xml diff -u phpdoc/en/reference/calendar/functions/jdtounix.xml:1.6 phpdoc/en/reference/calendar/functions/jdtounix.xml:1.7 --- phpdoc/en/reference/calendar/functions/jdtounix.xml:1.6 Sun Dec 21 04:21:42 2003 +++ phpdoc/en/reference/calendar/functions/jdtounix.xml Sun Apr 29 13:18:58 2007 @@ -1,30 +1,29 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.3 --> - <refentry id="function.jdtounix"> - <refnamediv> - <refname>jdtounix</refname> - <refpurpose>Convert Julian Day to Unix timestamp</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>jdtounix</methodname> - <methodparam><type>int</type><parameter>jday</parameter></methodparam> - </methodsynopsis> - <para> - This function will return a Unix timestamp corresponding to the - Julian Day given in <parameter>jday</parameter> or &false; if - <parameter>jday</parameter> is not inside the Unix epoch - (Gregorian years between 1970 and 2037 or 2440588 <= - <parameter>jday</parameter> <= 2465342 ). The time returned is - localtime (and not GMT). - </para> - <para> - See also <function>unixtojd</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<refentry id="function.jdtounix"> + <refnamediv> + <refname>jdtounix</refname> + <refpurpose>Convert Julian Day to Unix timestamp</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>jdtounix</methodname> + <methodparam><type>int</type><parameter>jday</parameter></methodparam> + </methodsynopsis> + <para> + This function will return a Unix timestamp corresponding to the + Julian Day given in <parameter>jday</parameter> or &false; if + <parameter>jday</parameter> is not inside the Unix epoch + (Gregorian years between 1970 and 2037 or 2440588 <= + <parameter>jday</parameter> <= 2465342 ). The time returned is + localtime (and not GMT). + </para> + <para> + See also <function>unixtojd</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/jewishtojd.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/calendar/functions/jewishtojd.xml diff -u phpdoc/en/reference/calendar/functions/jewishtojd.xml:1.4 phpdoc/en/reference/calendar/functions/jewishtojd.xml:1.5 --- phpdoc/en/reference/calendar/functions/jewishtojd.xml:1.4 Tue Oct 7 03:49:01 2003 +++ phpdoc/en/reference/calendar/functions/jewishtojd.xml Sun Apr 29 13:18:58 2007 @@ -1,30 +1,27 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 --> - <refentry id="function.jewishtojd"> - <refnamediv> - <refname>JewishToJD</refname> - <refpurpose> - Converts a date in the Jewish Calendar to Julian Day Count - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>jewishtojd</methodname> - <methodparam><type>int</type><parameter>month</parameter></methodparam> - <methodparam><type>int</type><parameter>day</parameter></methodparam> - <methodparam><type>int</type><parameter>year</parameter></methodparam> - </methodsynopsis> - <para> - Although this function can handle dates all the way back to the year 1 - (3761 B.C.), such use may not be meaningful. The Jewish calendar has - been in use for several thousand years, but in the early days there was - no formula to determine the start of a month. A new month was started - when the new moon was first observed. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.jewishtojd"> + <refnamediv> + <refname>JewishToJD</refname> + <refpurpose>Converts a date in the Jewish Calendar to Julian Day Count</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>jewishtojd</methodname> + <methodparam><type>int</type><parameter>month</parameter></methodparam> + <methodparam><type>int</type><parameter>day</parameter></methodparam> + <methodparam><type>int</type><parameter>year</parameter></methodparam> + </methodsynopsis> + <para> + Although this function can handle dates all the way back to the year 1 + (3761 B.C.), such use may not be meaningful. The Jewish calendar has + been in use for several thousand years, but in the early days there was + no formula to determine the start of a month. A new month was started + when the new moon was first observed. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/juliantojd.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/calendar/functions/juliantojd.xml diff -u phpdoc/en/reference/calendar/functions/juliantojd.xml:1.5 phpdoc/en/reference/calendar/functions/juliantojd.xml:1.6 --- phpdoc/en/reference/calendar/functions/juliantojd.xml:1.5 Tue Oct 7 03:49:01 2003 +++ phpdoc/en/reference/calendar/functions/juliantojd.xml Sun Apr 29 13:18:58 2007 @@ -1,41 +1,38 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 --> - <refentry id="function.juliantojd"> - <refnamediv> - <refname>JulianToJD</refname> - <refpurpose> - Converts a Julian Calendar date to Julian Day Count - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>juliantojd</methodname> - <methodparam><type>int</type><parameter>month</parameter></methodparam> - <methodparam><type>int</type><parameter>day</parameter></methodparam> - <methodparam><type>int</type><parameter>year</parameter></methodparam> - </methodsynopsis> - <para> - Valid Range for Julian Calendar 4713 B.C. to 9999 A.D. - </para> - <para> - Although this function can handle dates all the way back to 4713 - B.C., such use may not be meaningful. The calendar was created in - 46 B.C., but the details did not stabilize until at least 8 A.D., - and perhaps as late at the 4th century. Also, the beginning of a - year varied from one culture to another - not all accepted - January as the first month. - </para> - <caution> - <para> - Remember, the current calendar system being used worldwide is the - Gregorian calendar. <function>gregoriantojd</function> can be used to - convert such dates to their Julian Day count. - </para> - </caution> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<refentry id="function.juliantojd"> + <refnamediv> + <refname>JulianToJD</refname> + <refpurpose>Converts a Julian Calendar date to Julian Day Count</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>juliantojd</methodname> + <methodparam><type>int</type><parameter>month</parameter></methodparam> + <methodparam><type>int</type><parameter>day</parameter></methodparam> + <methodparam><type>int</type><parameter>year</parameter></methodparam> + </methodsynopsis> + <para> + Valid Range for Julian Calendar 4713 B.C. to 9999 A.D. + </para> + <para> + Although this function can handle dates all the way back to 4713 + B.C., such use may not be meaningful. The calendar was created in + 46 B.C., but the details did not stabilize until at least 8 A.D., + and perhaps as late at the 4th century. Also, the beginning of a + year varied from one culture to another - not all accepted + January as the first month. + </para> + <caution> + <para> + Remember, the current calendar system being used worldwide is the + Gregorian calendar. <function>gregoriantojd</function> can be used to + convert such dates to their Julian Day count. + </para> + </caution> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/unixtojd.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/calendar/functions/unixtojd.xml diff -u phpdoc/en/reference/calendar/functions/unixtojd.xml:1.5 phpdoc/en/reference/calendar/functions/unixtojd.xml:1.6 --- phpdoc/en/reference/calendar/functions/unixtojd.xml:1.5 Sun Dec 21 04:21:42 2003 +++ phpdoc/en/reference/calendar/functions/unixtojd.xml Sun Apr 29 13:18:58 2007 @@ -1,27 +1,26 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.3 --> - <refentry id="function.unixtojd"> - <refnamediv> - <refname>unixtojd</refname> - <refpurpose>Convert Unix timestamp to Julian Day</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>unixtojd</methodname> - <methodparam choice="opt"><type>int</type><parameter>timestamp</parameter></methodparam> - </methodsynopsis> - <para> - Return the Julian Day for a Unix <parameter>timestamp</parameter> - (seconds since 1.1.1970), or for the current day if no - <parameter>timestamp</parameter> is given. - </para> - <para> - See also <function>jdtounix</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<refentry id="function.unixtojd"> + <refnamediv> + <refname>unixtojd</refname> + <refpurpose>Convert Unix timestamp to Julian Day</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>unixtojd</methodname> + <methodparam choice="opt"><type>int</type><parameter>timestamp</parameter></methodparam> + </methodsynopsis> + <para> + Return the Julian Day for a Unix <parameter>timestamp</parameter> + (seconds since 1.1.1970), or for the current day if no + <parameter>timestamp</parameter> is given. + </para> + <para> + See also <function>jdtounix</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables:
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/cal-days-in-month.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/calendar/functions/cal-days-in-month.xml diff -u phpdoc/en/reference/calendar/functions/cal-days-in-month.xml:1.5 phpdoc/en/reference/calendar/functions/cal-days-in-month.xml:1.6 --- phpdoc/en/reference/calendar/functions/cal-days-in-month.xml:1.5 Tue Oct 7 03:49:00 2003 +++ phpdoc/en/reference/calendar/functions/cal-days-in-month.xml Sun Apr 29 13:18:58 2007 @@ -1,42 +1,41 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.19 --> - <refentry id="function.cal-days-in-month"> - <refnamediv> - <refname>cal_days_in_month</refname> - <refpurpose>Return the number of days in a month for a given year and calendar</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>cal_days_in_month</methodname> - <methodparam><type>int</type><parameter>calendar</parameter></methodparam> - <methodparam><type>int</type><parameter>month</parameter></methodparam> - <methodparam><type>int</type><parameter>year</parameter></methodparam> - </methodsynopsis> - <para> - This function will return the number of days in the - <parameter>month</parameter> of <parameter>year</parameter> for - the specified <parameter>calendar</parameter>. - </para> - <para> - <example> - <title><function>cal_days_in_month</function> example</title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<refentry id="function.cal-days-in-month"> + <refnamediv> + <refname>cal_days_in_month</refname> + <refpurpose>Return the number of days in a month for a given year and calendar</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>cal_days_in_month</methodname> + <methodparam><type>int</type><parameter>calendar</parameter></methodparam> + <methodparam><type>int</type><parameter>month</parameter></methodparam> + <methodparam><type>int</type><parameter>year</parameter></methodparam> + </methodsynopsis> + <para> + This function will return the number of days in the + <parameter>month</parameter> of <parameter>year</parameter> for + the specified <parameter>calendar</parameter>. + </para> + <para> + <example> + <title><function>cal_days_in_month</function> example</title> + <programlisting role="php"> <![CDATA[ <?php $num = cal_days_in_month(CAL_GREGORIAN, 8, 2003); // 31 echo "There was $num days in August 2003"; ?> ]]> - </programlisting> - </example> - </para> - <para> - See also <function>jdtounix</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + See also <function>jdtounix</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/cal-from-jd.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc/en/reference/calendar/functions/cal-from-jd.xml diff -u phpdoc/en/reference/calendar/functions/cal-from-jd.xml:1.9 phpdoc/en/reference/calendar/functions/cal-from-jd.xml:1.10 --- phpdoc/en/reference/calendar/functions/cal-from-jd.xml:1.9 Mon Nov 1 13:25:29 2004 +++ phpdoc/en/reference/calendar/functions/cal-from-jd.xml Sun Apr 29 13:18:58 2007 @@ -1,41 +1,40 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.19 --> - <refentry id='function.cal-from-jd'> - <refnamediv> - <refname>cal_from_jd</refname> - <refpurpose>Converts from Julian Day Count to a supported calendar</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>array</type><methodname>cal_from_jd</methodname> - <methodparam><type>int</type><parameter>jd</parameter></methodparam> - <methodparam><type>int</type><parameter>calendar</parameter></methodparam> - </methodsynopsis> - <para> - <function>cal_from_jd</function> converts the Julian day given in - <parameter>jd</parameter> into a date of the specified - <parameter>calendar</parameter>. Supported - <parameter>calendar</parameter> values are - <constant>CAL_GREGORIAN</constant>, - <constant>CAL_JULIAN</constant>, - <constant>CAL_JEWISH</constant> and - <constant>CAL_FRENCH</constant>. - </para> - <para> - <example> - <title><function>cal_from_jd</function> example</title> - <programlisting role="php"> +<!-- $Revision: 1.10 $ --> +<refentry id='function.cal-from-jd'> + <refnamediv> + <refname>cal_from_jd</refname> + <refpurpose>Converts from Julian Day Count to a supported calendar</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>array</type><methodname>cal_from_jd</methodname> + <methodparam><type>int</type><parameter>jd</parameter></methodparam> + <methodparam><type>int</type><parameter>calendar</parameter></methodparam> + </methodsynopsis> + <para> + <function>cal_from_jd</function> converts the Julian day given in + <parameter>jd</parameter> into a date of the specified + <parameter>calendar</parameter>. Supported + <parameter>calendar</parameter> values are + <constant>CAL_GREGORIAN</constant>, + <constant>CAL_JULIAN</constant>, + <constant>CAL_JEWISH</constant> and + <constant>CAL_FRENCH</constant>. + </para> + <para> + <example> + <title><function>cal_from_jd</function> example</title> + <programlisting role="php"> <![CDATA[ <?php $today = unixtojd(mktime(0, 0, 0, 8, 16, 2003)); print_r(cal_from_jd($today, CAL_GREGORIAN)); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Array ( @@ -50,14 +49,14 @@ [monthname] => August ) ]]> - </screen> - </example> - </para> - <para> - See also <function>cal_to_jd</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + <para> + See also <function>cal_to_jd</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/cal-info.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc/en/reference/calendar/functions/cal-info.xml diff -u phpdoc/en/reference/calendar/functions/cal-info.xml:1.13 phpdoc/en/reference/calendar/functions/cal-info.xml:1.14 --- phpdoc/en/reference/calendar/functions/cal-info.xml:1.13 Wed Apr 6 07:57:26 2005 +++ phpdoc/en/reference/calendar/functions/cal-info.xml Sun Apr 29 13:18:58 2007 @@ -1,68 +1,67 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.19 --> - <refentry id='function.cal-info'> - <refnamediv> - <refname>cal_info</refname> - <refpurpose>Returns information about a particular calendar</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>array</type><methodname>cal_info</methodname> - <methodparam choice="opt"><type>int</type><parameter>calendar</parameter></methodparam> - </methodsynopsis> - <para> - <function>cal_info</function> returns information on the - specified <parameter>calendar</parameter>. - </para> - <para> - Calendar information is returned as an array containing the - elements <literal>calname</literal>, <literal>calsymbol</literal>, - <literal>month</literal>, <literal>abbrevmonth</literal> and - <literal>maxdaysinmonth</literal>. The names of the different calendars - which can be used as <parameter>calendar</parameter> are as follows: - <itemizedlist> - <listitem> - <simpara> - 0 or <constant>CAL_GREGORIAN</constant> - Gregorian Calendar - </simpara> - </listitem> - <listitem> - <simpara> - 1 or <constant>CAL_JULIAN</constant> - Julian Calendar - </simpara> - </listitem> - <listitem> - <simpara> - 2 or <constant>CAL_JEWISH</constant> - Jewish Calendar - </simpara> - </listitem> - <listitem> - <simpara> - 3 or <constant>CAL_FRENCH</constant> - French Revolutionary Calendar - </simpara> - </listitem> - </itemizedlist> - </para> - <para> - If no <parameter>calendar</parameter> is specified information on all - supported calendars is returned as an array. This functionality - is available beginning with PHP 5. - </para> - <para> - <example> - <title><function>cal_info</function> example</title> - <programlisting role="php"> +<!-- $Revision: 1.14 $ --> +<refentry id='function.cal-info'> + <refnamediv> + <refname>cal_info</refname> + <refpurpose>Returns information about a particular calendar</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>array</type><methodname>cal_info</methodname> + <methodparam choice="opt"><type>int</type><parameter>calendar</parameter></methodparam> + </methodsynopsis> + <para> + <function>cal_info</function> returns information on the + specified <parameter>calendar</parameter>. + </para> + <para> + Calendar information is returned as an array containing the + elements <literal>calname</literal>, <literal>calsymbol</literal>, + <literal>month</literal>, <literal>abbrevmonth</literal> and + <literal>maxdaysinmonth</literal>. The names of the different calendars + which can be used as <parameter>calendar</parameter> are as follows: + <itemizedlist> + <listitem> + <simpara> + 0 or <constant>CAL_GREGORIAN</constant> - Gregorian Calendar + </simpara> + </listitem> + <listitem> + <simpara> + 1 or <constant>CAL_JULIAN</constant> - Julian Calendar + </simpara> + </listitem> + <listitem> + <simpara> + 2 or <constant>CAL_JEWISH</constant> - Jewish Calendar + </simpara> + </listitem> + <listitem> + <simpara> + 3 or <constant>CAL_FRENCH</constant> - French Revolutionary Calendar + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + If no <parameter>calendar</parameter> is specified information on all + supported calendars is returned as an array. This functionality + is available beginning with PHP 5. + </para> + <para> + <example> + <title><function>cal_info</function> example</title> + <programlisting role="php"> <![CDATA[ <?php $info = cal_info(0); print_r($info); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ Array ( @@ -103,11 +102,11 @@ [calsymbol] => CAL_GREGORIAN ) ]]> - </screen> - </example> - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/cal-to-jd.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/calendar/functions/cal-to-jd.xml diff -u phpdoc/en/reference/calendar/functions/cal-to-jd.xml:1.8 phpdoc/en/reference/calendar/functions/cal-to-jd.xml:1.9 --- phpdoc/en/reference/calendar/functions/cal-to-jd.xml:1.8 Fri Apr 22 15:39:25 2005 +++ phpdoc/en/reference/calendar/functions/cal-to-jd.xml Sun Apr 29 13:18:58 2007 @@ -1,34 +1,33 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.19 --> - <refentry id='function.cal-to-jd'> - <refnamediv> - <refname>cal_to_jd</refname> - <refpurpose>Converts from a supported calendar to Julian Day Count</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>cal_to_jd</methodname> - <methodparam><type>int</type><parameter>calendar</parameter></methodparam> - <methodparam><type>int</type><parameter>month</parameter></methodparam> - <methodparam><type>int</type><parameter>day</parameter></methodparam> - <methodparam><type>int</type><parameter>year</parameter></methodparam> - </methodsynopsis> - <para> - <function>cal_to_jd</function> calculates the Julian day count - for a date in the specified <parameter>calendar</parameter>. - Supported <parameter>calendar</parameter>s are - <constant>CAL_GREGORIAN</constant>, - <constant>CAL_JULIAN</constant>, - <constant>CAL_JEWISH</constant> and - <constant>CAL_FRENCH</constant>. - </para> - <para> - See also <function>cal_from_jd</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.9 $ --> +<refentry id='function.cal-to-jd'> + <refnamediv> + <refname>cal_to_jd</refname> + <refpurpose>Converts from a supported calendar to Julian Day Count</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>cal_to_jd</methodname> + <methodparam><type>int</type><parameter>calendar</parameter></methodparam> + <methodparam><type>int</type><parameter>month</parameter></methodparam> + <methodparam><type>int</type><parameter>day</parameter></methodparam> + <methodparam><type>int</type><parameter>year</parameter></methodparam> + </methodsynopsis> + <para> + <function>cal_to_jd</function> calculates the Julian day count + for a date in the specified <parameter>calendar</parameter>. + Supported <parameter>calendar</parameter>s are + <constant>CAL_GREGORIAN</constant>, + <constant>CAL_JULIAN</constant>, + <constant>CAL_JEWISH</constant> and + <constant>CAL_FRENCH</constant>. + </para> + <para> + See also <function>cal_from_jd</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/easter-date.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc/en/reference/calendar/functions/easter-date.xml diff -u phpdoc/en/reference/calendar/functions/easter-date.xml:1.12 phpdoc/en/reference/calendar/functions/easter-date.xml:1.13 --- phpdoc/en/reference/calendar/functions/easter-date.xml:1.12 Tue Aug 10 16:30:16 2004 +++ phpdoc/en/reference/calendar/functions/easter-date.xml Sun Apr 29 13:18:58 2007 @@ -1,32 +1,29 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.2 --> - <refentry id="function.easter-date"> - <refnamediv> - <refname>easter_date</refname> - <refpurpose> - Get Unix timestamp for midnight on Easter of a given year - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>easter_date</methodname> - <methodparam choice="opt"><type>int</type><parameter>year</parameter></methodparam> - </methodsynopsis> - <para> - Returns the Unix timestamp corresponding to midnight on Easter of - the given year. - </para> - <para> - Since PHP 4.3.0, the <parameter>year</parameter> - parameter is optional and defaults to the current year according to the - localtime if omitted. - </para> - <para> - <example> - <title><function>easter_date</function> example</title> - <programlisting role="php"> +<!-- $Revision: 1.13 $ --> +<refentry id="function.easter-date"> + <refnamediv> + <refname>easter_date</refname> + <refpurpose>Get Unix timestamp for midnight on Easter of a given year</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>easter_date</methodname> + <methodparam choice="opt"><type>int</type><parameter>year</parameter></methodparam> + </methodsynopsis> + <para> + Returns the Unix timestamp corresponding to midnight on Easter of + the given year. + </para> + <para> + Since PHP 4.3.0, the <parameter>year</parameter> + parameter is optional and defaults to the current year according to the + localtime if omitted. + </para> + <para> + <example> + <title><function>easter_date</function> example</title> + <programlisting role="php"> <![CDATA[ <?php @@ -36,40 +33,40 @@ ?> ]]> - </programlisting> - </example> - </para> - <warning> - <para> - This function will generate a warning if the year is outside - of the range for Unix timestamps (i.e. before 1970 or after 2037). - </para> - </warning> - <para> - The date of Easter Day was defined by the Council of Nicaea in - AD325 as the Sunday after the first full moon which falls on or - after the Spring Equinox. The Equinox is assumed to always fall - on 21st March, so the calculation reduces to determining the date - of the full moon and the date of the following Sunday. The - algorithm used here was introduced around the year 532 by - Dionysius Exiguus. Under the Julian Calendar (for years before - 1753) a simple 19-year cycle is used to track the phases of the - Moon. Under the Gregorian Calendar (for years after 1753 - - devised by Clavius and Lilius, and introduced by Pope Gregory - XIII in October 1582, and into Britain and its then colonies in - September 1752) two correction factors are added to make the - cycle more accurate. - </para> - <para> - (The code is based on a C program by Simon Kershaw, - <webmaster at ely.anglican dot org>) - </para> - <para> - See <function>easter_days</function> for calculating Easter - before 1970 or after 2037. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <warning> + <para> + This function will generate a warning if the year is outside + of the range for Unix timestamps (i.e. before 1970 or after 2037). + </para> + </warning> + <para> + The date of Easter Day was defined by the Council of Nicaea in + AD325 as the Sunday after the first full moon which falls on or + after the Spring Equinox. The Equinox is assumed to always fall + on 21st March, so the calculation reduces to determining the date + of the full moon and the date of the following Sunday. The + algorithm used here was introduced around the year 532 by + Dionysius Exiguus. Under the Julian Calendar (for years before + 1753) a simple 19-year cycle is used to track the phases of the + Moon. Under the Gregorian Calendar (for years after 1753 - + devised by Clavius and Lilius, and introduced by Pope Gregory + XIII in October 1582, and into Britain and its then colonies in + September 1752) two correction factors are added to make the + cycle more accurate. + </para> + <para> + (The code is based on a C program by Simon Kershaw, + <webmaster at ely.anglican dot org>) + </para> + <para> + See <function>easter_days</function> for calculating Easter + before 1970 or after 2037. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/easter-days.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc/en/reference/calendar/functions/easter-days.xml diff -u phpdoc/en/reference/calendar/functions/easter-days.xml:1.11 phpdoc/en/reference/calendar/functions/easter-days.xml:1.12 --- phpdoc/en/reference/calendar/functions/easter-days.xml:1.11 Tue Aug 10 16:30:16 2004 +++ phpdoc/en/reference/calendar/functions/easter-days.xml Sun Apr 29 13:18:58 2007 @@ -1,47 +1,43 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.2 --> - <refentry id="function.easter-days"> - <refnamediv> - <refname>easter_days</refname> - <refpurpose> - Get number of days after March 21 on which Easter falls for a - given year - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>easter_days</methodname> - <methodparam choice="opt"><type>int</type><parameter>year</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>method</parameter></methodparam> - </methodsynopsis> - <para> - Returns the number of days after March 21 on which Easter falls - for a given year. If no year is specified, the current year is - assumed. - </para> - <para> - Since PHP 4.3.0, the <parameter>year</parameter> - parameter is optional and defaults to the current year according to the - localtime if omitted. - </para> - <para> - The <parameter>method</parameter> parameter was also introduced in - PHP 4.3.0 and allows to calculate easter dates based - on the Gregorian calendar during the years 1582 - 1752 when set to - <constant>CAL_EASTER_ROMAN</constant>. See the <link - linkend="calendar.constants">calendar constants</link> for more valid - constants. - </para> - <para> - This function can be used instead of - <function>easter_date</function> to calculate Easter for years - which fall outside the range of Unix timestamps (i.e. before 1970 - or after 2037). - <example> - <title><function>easter_days</function> example</title> - <programlisting role="php"> +<!-- $Revision: 1.12 $ --> +<refentry id="function.easter-days"> + <refnamediv> + <refname>easter_days</refname> + <refpurpose>Get number of days after March 21 on which Easter falls for a given year</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>easter_days</methodname> + <methodparam choice="opt"><type>int</type><parameter>year</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>method</parameter></methodparam> + </methodsynopsis> + <para> + Returns the number of days after March 21 on which Easter falls + for a given year. If no year is specified, the current year is + assumed. + </para> + <para> + Since PHP 4.3.0, the <parameter>year</parameter> + parameter is optional and defaults to the current year according to the + localtime if omitted. + </para> + <para> + The <parameter>method</parameter> parameter was also introduced in + PHP 4.3.0 and allows to calculate easter dates based + on the Gregorian calendar during the years 1582 - 1752 when set to + <constant>CAL_EASTER_ROMAN</constant>. See the <link + linkend="calendar.constants">calendar constants</link> for more valid + constants. + </para> + <para> + This function can be used instead of + <function>easter_date</function> to calculate Easter for years + which fall outside the range of Unix timestamps (i.e. before 1970 + or after 2037). + <example> + <title><function>easter_days</function> example</title> + <programlisting role="php"> <![CDATA[ <?php @@ -51,33 +47,33 @@ ?> ]]> - </programlisting> - </example> - </para> - <para> - The date of Easter Day was defined by the Council of Nicaea in - AD325 as the Sunday after the first full moon which falls on or - after the Spring Equinox. The Equinox is assumed to always fall - on 21st March, so the calculation reduces to determining the date - of the full moon and the date of the following Sunday. The - algorithm used here was introduced around the year 532 by - Dionysius Exiguus. Under the Julian Calendar (for years before - 1753) a simple 19-year cycle is used to track the phases of the - Moon. Under the Gregorian Calendar (for years after 1753 - - devised by Clavius and Lilius, and introduced by Pope Gregory - XIII in October 1582, and into Britain and its then colonies in - September 1752) two correction factors are added to make the - cycle more accurate. - </para> - <para> - (The code is based on a C program by Simon Kershaw, - <webmaster at ely.anglican dot org>) - </para> - <para> - See also <function>easter_date</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + The date of Easter Day was defined by the Council of Nicaea in + AD325 as the Sunday after the first full moon which falls on or + after the Spring Equinox. The Equinox is assumed to always fall + on 21st March, so the calculation reduces to determining the date + of the full moon and the date of the following Sunday. The + algorithm used here was introduced around the year 532 by + Dionysius Exiguus. Under the Julian Calendar (for years before + 1753) a simple 19-year cycle is used to track the phases of the + Moon. Under the Gregorian Calendar (for years after 1753 - + devised by Clavius and Lilius, and introduced by Pope Gregory + XIII in October 1582, and into Britain and its then colonies in + September 1752) two correction factors are added to make the + cycle more accurate. + </para> + <para> + (The code is based on a C program by Simon Kershaw, + <webmaster at ely.anglican dot org>) + </para> + <para> + See also <function>easter_date</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/frenchtojd.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/calendar/functions/frenchtojd.xml diff -u phpdoc/en/reference/calendar/functions/frenchtojd.xml:1.4 phpdoc/en/reference/calendar/functions/frenchtojd.xml:1.5 --- phpdoc/en/reference/calendar/functions/frenchtojd.xml:1.4 Tue Oct 7 03:49:01 2003 +++ phpdoc/en/reference/calendar/functions/frenchtojd.xml Sun Apr 29 13:18:58 2007 @@ -1,34 +1,30 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 --> - <refentry id="function.frenchtojd"> - <refnamediv> - <refname>FrenchToJD</refname> - <refpurpose> - Converts a date from the French Republican Calendar to a Julian - Day Count - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>frenchtojd</methodname> - <methodparam><type>int</type><parameter>month</parameter></methodparam> - <methodparam><type>int</type><parameter>day</parameter></methodparam> - <methodparam><type>int</type><parameter>year</parameter></methodparam> - </methodsynopsis> - <para> - Converts a date from the French Republican Calendar to a Julian - Day Count. - </para> - <para> - These routines only convert dates in years 1 through 14 - (Gregorian dates 22 September 1792 through 22 September - 1806). This more than covers the period when the calendar was in - use. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.frenchtojd"> + <refnamediv> + <refname>FrenchToJD</refname> + <refpurpose>Converts a date from the French Republican Calendar to a Julian Day Count</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>frenchtojd</methodname> + <methodparam><type>int</type><parameter>month</parameter></methodparam> + <methodparam><type>int</type><parameter>day</parameter></methodparam> + <methodparam><type>int</type><parameter>year</parameter></methodparam> + </methodsynopsis> + <para> + Converts a date from the French Republican Calendar to a Julian + Day Count. + </para> + <para> + These routines only convert dates in years 1 through 14 + (Gregorian dates 22 September 1792 through 22 September + 1806). This more than covers the period when the calendar was in + use. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/gregoriantojd.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/calendar/functions/gregoriantojd.xml diff -u phpdoc/en/reference/calendar/functions/gregoriantojd.xml:1.6 phpdoc/en/reference/calendar/functions/gregoriantojd.xml:1.7 --- phpdoc/en/reference/calendar/functions/gregoriantojd.xml:1.6 Thu Dec 18 17:43:30 2003 +++ phpdoc/en/reference/calendar/functions/gregoriantojd.xml Sun Apr 29 13:18:58 2007 @@ -1,34 +1,31 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 --> - <refentry id="function.gregoriantojd"> - <refnamediv> - <refname>GregorianToJD</refname> - <refpurpose> - Converts a Gregorian date to Julian Day Count - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>gregoriantojd</methodname> - <methodparam><type>int</type><parameter>month</parameter></methodparam> - <methodparam><type>int</type><parameter>day</parameter></methodparam> - <methodparam><type>int</type><parameter>year</parameter></methodparam> - </methodsynopsis> - <para> - Valid Range for Gregorian Calendar 4714 B.C. to 9999 A.D.</para> - <para> - Although this function can handle dates all the way back to 4714 - B.C., such use may not be meaningful. The Gregorian calendar was - not instituted until October 15, 1582 (or October 5, 1582 in the - Julian calendar). Some countries did not accept it until much - later. For example, Britain converted in 1752, The USSR in 1918 - and Greece in 1923. Most European countries used the Julian - calendar prior to the Gregorian. - <example> - <title>Calendar functions</title> - <programlisting role="php"> +<!-- $Revision: 1.7 $ --> +<refentry id="function.gregoriantojd"> + <refnamediv> + <refname>GregorianToJD</refname> + <refpurpose>Converts a Gregorian date to Julian Day Count</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>gregoriantojd</methodname> + <methodparam><type>int</type><parameter>month</parameter></methodparam> + <methodparam><type>int</type><parameter>day</parameter></methodparam> + <methodparam><type>int</type><parameter>year</parameter></methodparam> + </methodsynopsis> + <para> + Valid Range for Gregorian Calendar 4714 B.C. to 9999 A.D.</para> + <para> + Although this function can handle dates all the way back to 4714 + B.C., such use may not be meaningful. The Gregorian calendar was + not instituted until October 15, 1582 (or October 5, 1582 in the + Julian calendar). Some countries did not accept it until much + later. For example, Britain converted in 1752, The USSR in 1918 + and Greece in 1923. Most European countries used the Julian + calendar prior to the Gregorian. + <example> + <title>Calendar functions</title> + <programlisting role="php"> <![CDATA[ <?php $jd = GregorianToJD(10, 11, 1970); @@ -37,11 +34,11 @@ echo "$gregorian\n"; ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/jddayofweek.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/calendar/functions/jddayofweek.xml diff -u phpdoc/en/reference/calendar/functions/jddayofweek.xml:1.6 phpdoc/en/reference/calendar/functions/jddayofweek.xml:1.7 --- phpdoc/en/reference/calendar/functions/jddayofweek.xml:1.6 Thu Aug 12 18:11:56 2004 +++ phpdoc/en/reference/calendar/functions/jddayofweek.xml Sun Apr 29 13:18:58 2007 @@ -1,57 +1,56 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 --> - <refentry id="function.jddayofweek"> - <refnamediv> - <refname>JDDayOfWeek</refname> - <refpurpose>Returns the day of the week</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>mixed</type><methodname>jddayofweek</methodname> - <methodparam><type>int</type><parameter>julianday</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> - </methodsynopsis> - <para> - Returns the day of the week. Can return a string or an integer - depending on the mode. - <table> - <title>Calendar week modes</title> - <tgroup cols="2"> - <thead> - <row> - <entry>Mode</entry> - <entry>Meaning</entry> - </row> - </thead> - <tbody> - <row> - <entry>0 (Default)</entry> - <entry> - Returns the day number as an int (0=Sunday, 1=Monday, etc) - </entry> - </row> - <row> - <entry>1</entry> - <entry> - Returns string containing the day of week - (English-Gregorian) - </entry> - </row> - <row> - <entry>2</entry> - <entry> - Returns a string containing the abbreviated day of week - (English-Gregorian) - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<refentry id="function.jddayofweek"> + <refnamediv> + <refname>JDDayOfWeek</refname> + <refpurpose>Returns the day of the week</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>mixed</type><methodname>jddayofweek</methodname> + <methodparam><type>int</type><parameter>julianday</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> + </methodsynopsis> + <para> + Returns the day of the week. Can return a string or an integer + depending on the mode. + <table> + <title>Calendar week modes</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Mode</entry> + <entry>Meaning</entry> + </row> + </thead> + <tbody> + <row> + <entry>0 (Default)</entry> + <entry> + Returns the day number as an int (0=Sunday, 1=Monday, etc) + </entry> + </row> + <row> + <entry>1</entry> + <entry> + Returns string containing the day of week + (English-Gregorian) + </entry> + </row> + <row> + <entry>2</entry> + <entry> + Returns a string containing the abbreviated day of week + (English-Gregorian) + </entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/jdmonthname.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/calendar/functions/jdmonthname.xml diff -u phpdoc/en/reference/calendar/functions/jdmonthname.xml:1.4 phpdoc/en/reference/calendar/functions/jdmonthname.xml:1.5 --- phpdoc/en/reference/calendar/functions/jdmonthname.xml:1.4 Tue Oct 7 03:49:01 2003 +++ phpdoc/en/reference/calendar/functions/jdmonthname.xml Sun Apr 29 13:18:58 2007 @@ -1,70 +1,69 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 --> - <refentry id="function.jdmonthname"> - <refnamediv> - <refname>JDMonthName</refname> - <refpurpose>Returns a month name</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>jdmonthname</methodname> - <methodparam><type>int</type><parameter>julianday</parameter></methodparam> - <methodparam><type>int</type><parameter>mode</parameter></methodparam> - </methodsynopsis> - <para> - Returns a string containing a month name. - <parameter>mode</parameter> tells this function which calendar to - convert the Julian Day Count to, and what type of month names are - to be returned. - <table> - <title>Calendar modes</title> - <tgroup cols="3"> - <thead> - <row> - <entry>Mode</entry> - <entry>Meaning</entry> - <entry>Values</entry> - </row> - </thead> - <tbody> - <row> - <entry>0</entry> - <entry>Gregorian - abbreviated</entry> - <entry>Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec</entry> - </row> - <row> - <entry>1</entry> - <entry>Gregorian</entry> - <entry>January, February, March, April, May, June, July, August, September, October, November, December</entry> - </row> - <row> - <entry>2</entry> - <entry>Julian - abbreviated</entry> - <entry>Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec</entry> - </row> - <row> - <entry>3</entry> - <entry>Julian</entry> - <entry>January, February, March, April, May, June, July, August, September, October, November, December</entry> - </row> - <row> - <entry>4</entry> - <entry>Jewish</entry> - <entry>Tishri, Heshvan, Kislev, Tevet, Shevat, AdarI, AdarII, Nisan, Iyyar, Sivan, Tammuz, Av, Elul</entry> - </row> - <row> - <entry>5</entry> - <entry>French Republican</entry> - <entry>Vendemiaire, Brumaire, Frimaire, Nivose, Pluviose, Ventose, Germinal, Floreal, Prairial, Messidor, Thermidor, Fructidor, Extra</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.jdmonthname"> + <refnamediv> + <refname>JDMonthName</refname> + <refpurpose>Returns a month name</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>string</type><methodname>jdmonthname</methodname> + <methodparam><type>int</type><parameter>julianday</parameter></methodparam> + <methodparam><type>int</type><parameter>mode</parameter></methodparam> + </methodsynopsis> + <para> + Returns a string containing a month name. + <parameter>mode</parameter> tells this function which calendar to + convert the Julian Day Count to, and what type of month names are + to be returned. + <table> + <title>Calendar modes</title> + <tgroup cols="3"> + <thead> + <row> + <entry>Mode</entry> + <entry>Meaning</entry> + <entry>Values</entry> + </row> + </thead> + <tbody> + <row> + <entry>0</entry> + <entry>Gregorian - abbreviated</entry> + <entry>Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec</entry> + </row> + <row> + <entry>1</entry> + <entry>Gregorian</entry> + <entry>January, February, March, April, May, June, July, August, September, October, November, December</entry> + </row> + <row> + <entry>2</entry> + <entry>Julian - abbreviated</entry> + <entry>Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec</entry> + </row> + <row> + <entry>3</entry> + <entry>Julian</entry> + <entry>January, February, March, April, May, June, July, August, September, October, November, December</entry> + </row> + <row> + <entry>4</entry> + <entry>Jewish</entry> + <entry>Tishri, Heshvan, Kislev, Tevet, Shevat, AdarI, AdarII, Nisan, Iyyar, Sivan, Tammuz, Av, Elul</entry> + </row> + <row> + <entry>5</entry> + <entry>French Republican</entry> + <entry>Vendemiaire, Brumaire, Frimaire, Nivose, Pluviose, Ventose, Germinal, Floreal, Prairial, Messidor, Thermidor, Fructidor, Extra</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/jdtofrench.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/calendar/functions/jdtofrench.xml diff -u phpdoc/en/reference/calendar/functions/jdtofrench.xml:1.4 phpdoc/en/reference/calendar/functions/jdtofrench.xml:1.5 --- phpdoc/en/reference/calendar/functions/jdtofrench.xml:1.4 Tue Oct 7 03:49:01 2003 +++ phpdoc/en/reference/calendar/functions/jdtofrench.xml Sun Apr 29 13:18:58 2007 @@ -1,24 +1,21 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 --> - <refentry id="function.jdtofrench"> - <refnamediv> - <refname>JDToFrench</refname> - <refpurpose> - Converts a Julian Day Count to the French Republican Calendar - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>jdtofrench</methodname> - <methodparam><type>int</type><parameter>juliandaycount</parameter></methodparam> - </methodsynopsis> - <para> - Converts a Julian Day Count to the French Republican Calendar. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.jdtofrench"> + <refnamediv> + <refname>JDToFrench</refname> + <refpurpose>Converts a Julian Day Count to the French Republican Calendar</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>string</type><methodname>jdtofrench</methodname> + <methodparam><type>int</type><parameter>juliandaycount</parameter></methodparam> + </methodsynopsis> + <para> + Converts a Julian Day Count to the French Republican Calendar. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/jdtogregorian.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/calendar/functions/jdtogregorian.xml diff -u phpdoc/en/reference/calendar/functions/jdtogregorian.xml:1.4 phpdoc/en/reference/calendar/functions/jdtogregorian.xml:1.5 --- phpdoc/en/reference/calendar/functions/jdtogregorian.xml:1.4 Tue Oct 7 03:49:01 2003 +++ phpdoc/en/reference/calendar/functions/jdtogregorian.xml Sun Apr 29 13:18:58 2007 @@ -1,23 +1,22 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 --> - <refentry id="function.jdtogregorian"> - <refnamediv> - <refname>JDToGregorian</refname> - <refpurpose>Converts Julian Day Count to Gregorian date</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>jdtogregorian</methodname> - <methodparam><type>int</type><parameter>julianday</parameter></methodparam> - </methodsynopsis> - <para> - Converts Julian Day Count to a string containing the Gregorian - date in the format of "month/day/year". - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.jdtogregorian"> + <refnamediv> + <refname>JDToGregorian</refname> + <refpurpose>Converts Julian Day Count to Gregorian date</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>string</type><methodname>jdtogregorian</methodname> + <methodparam><type>int</type><parameter>julianday</parameter></methodparam> + </methodsynopsis> + <para> + Converts Julian Day Count to a string containing the Gregorian + date in the format of "month/day/year". + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/jdtojewish.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc/en/reference/calendar/functions/jdtojewish.xml diff -u phpdoc/en/reference/calendar/functions/jdtojewish.xml:1.11 phpdoc/en/reference/calendar/functions/jdtojewish.xml:1.12 --- phpdoc/en/reference/calendar/functions/jdtojewish.xml:1.11 Mon Feb 9 23:52:15 2004 +++ phpdoc/en/reference/calendar/functions/jdtojewish.xml Sun Apr 29 13:18:58 2007 @@ -1,51 +1,48 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 --> - <refentry id="function.jdtojewish"> - <refnamediv> - <refname>jdtojewish</refname> - <refpurpose> - Converts a Julian day count to a Jewish calendar date - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>jdtojewish</methodname> - <methodparam><type>int</type><parameter>juliandaycount</parameter></methodparam> - <methodparam choice="opt"><type>bool</type><parameter>hebrew</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>fl</parameter></methodparam> - </methodsynopsis> - <para> - Converts a Julian Day Count to the Jewish Calendar. - </para> - <para> - The optional <parameter>hebrew</parameter> and <parameter>fl</parameter> - parameters became available in PHP 5.0.0 - </para> - <para> - If the <parameter>hebrew</parameter> parameter is set to &true;, the - <parameter>fl</parameter> parameter is used for Hebrew, string based, - output format. The available formats are: - <constant>CAL_JEWISH_ADD_ALAFIM_GERESH</constant>, - <constant>CAL_JEWISH_ADD_ALAFIM</constant>, - <constant>CAL_JEWISH_ADD_GERESHAYIM</constant>. - </para> - <para> - <example> - <title><function>jdtojewish</function> Example</title> - <programlisting role="php"> +<!-- $Revision: 1.12 $ --> +<refentry id="function.jdtojewish"> + <refnamediv> + <refname>jdtojewish</refname> + <refpurpose>Converts a Julian day count to a Jewish calendar date</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>string</type><methodname>jdtojewish</methodname> + <methodparam><type>int</type><parameter>juliandaycount</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>hebrew</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>fl</parameter></methodparam> + </methodsynopsis> + <para> + Converts a Julian Day Count to the Jewish Calendar. + </para> + <para> + The optional <parameter>hebrew</parameter> and <parameter>fl</parameter> + parameters became available in PHP 5.0.0 + </para> + <para> + If the <parameter>hebrew</parameter> parameter is set to &true;, the + <parameter>fl</parameter> parameter is used for Hebrew, string based, + output format. The available formats are: + <constant>CAL_JEWISH_ADD_ALAFIM_GERESH</constant>, + <constant>CAL_JEWISH_ADD_ALAFIM</constant>, + <constant>CAL_JEWISH_ADD_GERESHAYIM</constant>. + </para> + <para> + <example> + <title><function>jdtojewish</function> Example</title> + <programlisting role="php"> <![CDATA[ <?php echo jdtojewish(gregoriantojd(10, 8, 2002), true, CAL_JEWISH_ADD_GERESHAYIM + CAL_JEWISH_ADD_ALAFIM + CAL_JEWISH_ADD_ALAFIM_GERESH); ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/jdtojulian.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/calendar/functions/jdtojulian.xml diff -u phpdoc/en/reference/calendar/functions/jdtojulian.xml:1.4 phpdoc/en/reference/calendar/functions/jdtojulian.xml:1.5 --- phpdoc/en/reference/calendar/functions/jdtojulian.xml:1.4 Tue Oct 7 03:49:01 2003 +++ phpdoc/en/reference/calendar/functions/jdtojulian.xml Sun Apr 29 13:18:58 2007 @@ -1,25 +1,22 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 --> - <refentry id="function.jdtojulian"> - <refnamediv> - <refname>JDToJulian</refname> - <refpurpose> - Converts a Julian Day Count to a Julian Calendar Date - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>jdtojulian</methodname> - <methodparam><type>int</type><parameter>julianday</parameter></methodparam> - </methodsynopsis> - <para> - Converts Julian Day Count to a string containing the Julian - Calendar Date in the format of "month/day/year". - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.jdtojulian"> + <refnamediv> + <refname>JDToJulian</refname> + <refpurpose>Converts a Julian Day Count to a Julian Calendar Date</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>string</type><methodname>jdtojulian</methodname> + <methodparam><type>int</type><parameter>julianday</parameter></methodparam> + </methodsynopsis> + <para> + Converts Julian Day Count to a string containing the Julian + Calendar Date in the format of "month/day/year". + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/jdtounix.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/calendar/functions/jdtounix.xml diff -u phpdoc/en/reference/calendar/functions/jdtounix.xml:1.6 phpdoc/en/reference/calendar/functions/jdtounix.xml:1.7 --- phpdoc/en/reference/calendar/functions/jdtounix.xml:1.6 Sun Dec 21 04:21:42 2003 +++ phpdoc/en/reference/calendar/functions/jdtounix.xml Sun Apr 29 13:18:58 2007 @@ -1,30 +1,29 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.3 --> - <refentry id="function.jdtounix"> - <refnamediv> - <refname>jdtounix</refname> - <refpurpose>Convert Julian Day to Unix timestamp</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>jdtounix</methodname> - <methodparam><type>int</type><parameter>jday</parameter></methodparam> - </methodsynopsis> - <para> - This function will return a Unix timestamp corresponding to the - Julian Day given in <parameter>jday</parameter> or &false; if - <parameter>jday</parameter> is not inside the Unix epoch - (Gregorian years between 1970 and 2037 or 2440588 <= - <parameter>jday</parameter> <= 2465342 ). The time returned is - localtime (and not GMT). - </para> - <para> - See also <function>unixtojd</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<refentry id="function.jdtounix"> + <refnamediv> + <refname>jdtounix</refname> + <refpurpose>Convert Julian Day to Unix timestamp</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>jdtounix</methodname> + <methodparam><type>int</type><parameter>jday</parameter></methodparam> + </methodsynopsis> + <para> + This function will return a Unix timestamp corresponding to the + Julian Day given in <parameter>jday</parameter> or &false; if + <parameter>jday</parameter> is not inside the Unix epoch + (Gregorian years between 1970 and 2037 or 2440588 <= + <parameter>jday</parameter> <= 2465342 ). The time returned is + localtime (and not GMT). + </para> + <para> + See also <function>unixtojd</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/jewishtojd.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/calendar/functions/jewishtojd.xml diff -u phpdoc/en/reference/calendar/functions/jewishtojd.xml:1.4 phpdoc/en/reference/calendar/functions/jewishtojd.xml:1.5 --- phpdoc/en/reference/calendar/functions/jewishtojd.xml:1.4 Tue Oct 7 03:49:01 2003 +++ phpdoc/en/reference/calendar/functions/jewishtojd.xml Sun Apr 29 13:18:58 2007 @@ -1,30 +1,27 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 --> - <refentry id="function.jewishtojd"> - <refnamediv> - <refname>JewishToJD</refname> - <refpurpose> - Converts a date in the Jewish Calendar to Julian Day Count - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>jewishtojd</methodname> - <methodparam><type>int</type><parameter>month</parameter></methodparam> - <methodparam><type>int</type><parameter>day</parameter></methodparam> - <methodparam><type>int</type><parameter>year</parameter></methodparam> - </methodsynopsis> - <para> - Although this function can handle dates all the way back to the year 1 - (3761 B.C.), such use may not be meaningful. The Jewish calendar has - been in use for several thousand years, but in the early days there was - no formula to determine the start of a month. A new month was started - when the new moon was first observed. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.jewishtojd"> + <refnamediv> + <refname>JewishToJD</refname> + <refpurpose>Converts a date in the Jewish Calendar to Julian Day Count</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>jewishtojd</methodname> + <methodparam><type>int</type><parameter>month</parameter></methodparam> + <methodparam><type>int</type><parameter>day</parameter></methodparam> + <methodparam><type>int</type><parameter>year</parameter></methodparam> + </methodsynopsis> + <para> + Although this function can handle dates all the way back to the year 1 + (3761 B.C.), such use may not be meaningful. The Jewish calendar has + been in use for several thousand years, but in the early days there was + no formula to determine the start of a month. A new month was started + when the new moon was first observed. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/juliantojd.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/calendar/functions/juliantojd.xml diff -u phpdoc/en/reference/calendar/functions/juliantojd.xml:1.5 phpdoc/en/reference/calendar/functions/juliantojd.xml:1.6 --- phpdoc/en/reference/calendar/functions/juliantojd.xml:1.5 Tue Oct 7 03:49:01 2003 +++ phpdoc/en/reference/calendar/functions/juliantojd.xml Sun Apr 29 13:18:58 2007 @@ -1,41 +1,38 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.4 --> - <refentry id="function.juliantojd"> - <refnamediv> - <refname>JulianToJD</refname> - <refpurpose> - Converts a Julian Calendar date to Julian Day Count - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>juliantojd</methodname> - <methodparam><type>int</type><parameter>month</parameter></methodparam> - <methodparam><type>int</type><parameter>day</parameter></methodparam> - <methodparam><type>int</type><parameter>year</parameter></methodparam> - </methodsynopsis> - <para> - Valid Range for Julian Calendar 4713 B.C. to 9999 A.D. - </para> - <para> - Although this function can handle dates all the way back to 4713 - B.C., such use may not be meaningful. The calendar was created in - 46 B.C., but the details did not stabilize until at least 8 A.D., - and perhaps as late at the 4th century. Also, the beginning of a - year varied from one culture to another - not all accepted - January as the first month. - </para> - <caution> - <para> - Remember, the current calendar system being used worldwide is the - Gregorian calendar. <function>gregoriantojd</function> can be used to - convert such dates to their Julian Day count. - </para> - </caution> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<refentry id="function.juliantojd"> + <refnamediv> + <refname>JulianToJD</refname> + <refpurpose>Converts a Julian Calendar date to Julian Day Count</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>juliantojd</methodname> + <methodparam><type>int</type><parameter>month</parameter></methodparam> + <methodparam><type>int</type><parameter>day</parameter></methodparam> + <methodparam><type>int</type><parameter>year</parameter></methodparam> + </methodsynopsis> + <para> + Valid Range for Julian Calendar 4713 B.C. to 9999 A.D. + </para> + <para> + Although this function can handle dates all the way back to 4713 + B.C., such use may not be meaningful. The calendar was created in + 46 B.C., but the details did not stabilize until at least 8 A.D., + and perhaps as late at the 4th century. Also, the beginning of a + year varied from one culture to another - not all accepted + January as the first month. + </para> + <caution> + <para> + Remember, the current calendar system being used worldwide is the + Gregorian calendar. <function>gregoriantojd</function> can be used to + convert such dates to their Julian Day count. + </para> + </caution> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/calendar/functions/unixtojd.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/calendar/functions/unixtojd.xml diff -u phpdoc/en/reference/calendar/functions/unixtojd.xml:1.5 phpdoc/en/reference/calendar/functions/unixtojd.xml:1.6 --- phpdoc/en/reference/calendar/functions/unixtojd.xml:1.5 Sun Dec 21 04:21:42 2003 +++ phpdoc/en/reference/calendar/functions/unixtojd.xml Sun Apr 29 13:18:58 2007 @@ -1,27 +1,26 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./en/functions/calendar.xml, last change in rev 1.3 --> - <refentry id="function.unixtojd"> - <refnamediv> - <refname>unixtojd</refname> - <refpurpose>Convert Unix timestamp to Julian Day</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>unixtojd</methodname> - <methodparam choice="opt"><type>int</type><parameter>timestamp</parameter></methodparam> - </methodsynopsis> - <para> - Return the Julian Day for a Unix <parameter>timestamp</parameter> - (seconds since 1.1.1970), or for the current day if no - <parameter>timestamp</parameter> is given. - </para> - <para> - See also <function>jdtounix</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<refentry id="function.unixtojd"> + <refnamediv> + <refname>unixtojd</refname> + <refpurpose>Convert Unix timestamp to Julian Day</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>unixtojd</methodname> + <methodparam choice="opt"><type>int</type><parameter>timestamp</parameter></methodparam> + </methodsynopsis> + <para> + Return the Julian Day for a Unix <parameter>timestamp</parameter> + (seconds since 1.1.1970), or for the current day if no + <parameter>timestamp</parameter> is given. + </para> + <para> + See also <function>jdtounix</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: