vrana Tue Nov 14 16:46:10 2006 UTC Added files: /phpdoc/en/reference/datetime/functions date-create.xml date-date-set.xml date-format.xml date-isodate-set.xml date-modify.xml date-offset-get.xml date-parse.xml date-sun-info.xml date-time-set.xml date-timezone-get.xml date-timezone-set.xml timezone-abbreviations-list.xml timezone-identifiers-list.xml timezone-name-from-abbr.xml timezone-name-get.xml timezone-offset-get.xml timezone-open.xml timezone-transitions-get.xml Log: Initial documentation of PHP 5.2.0 functions
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/datetime/functions/date-create.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/datetime/functions/date-create.xml +++ phpdoc/en/reference/datetime/functions/date-create.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.date-create"> <refnamediv> <refname>date_create</refname> <refpurpose>Returns new DateTime object</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>DateTime</type><methodname>date_create</methodname> <methodparam choice="opt"><type>string</type><parameter>time</parameter></methodparam> <methodparam choice="opt"><type>DateTimeZone</type><parameter>timezone</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>DateTime</type><methodname>DateTime::__construct</methodname> <methodparam choice="opt"><type>string</type><parameter>time</parameter></methodparam> <methodparam choice="opt"><type>DateTimeZone</type><parameter>timezone</parameter></methodparam> </methodsynopsis> </refsect1>
<refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>time</parameter></term> <listitem> <para> String in a format accepted by <function>strtotime</function>, defaults to "now". </para> </listitem> </varlistentry> <varlistentry> <term><parameter>timezone</parameter></term> <listitem> <para> Time zone of the time. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Returns DateTime object on success or &false; on failure. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/datetime/functions/date-date-set.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/datetime/functions/date-date-set.xml +++ phpdoc/en/reference/datetime/functions/date-date-set.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.date-date-set"> <refnamediv> <refname>date_date_set</refname> <refpurpose>Sets the date</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>date_date_set</methodname> <methodparam><type>DateTime</type><parameter>object</parameter></methodparam> <methodparam><type>int</type><parameter>year</parameter></methodparam> <methodparam><type>int</type><parameter>month</parameter></methodparam> <methodparam><type>int</type><parameter>day</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>void</type><methodname>DateTime::setDate</methodname> <methodparam><type>int</type><parameter>year</parameter></methodparam> <methodparam><type>int</type><parameter>month</parameter></methodparam> <methodparam><type>int</type><parameter>day</parameter></methodparam> </methodsynopsis> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>object</parameter></term> <listitem> <para> DateTime object. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>year</parameter></term> <listitem> <para> Year of the date. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>month</parameter></term> <listitem> <para> Month of the date. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>day</parameter></term> <listitem> <para> Day of the date. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Returns &null; on success or &false; on failure. </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>date_isodate_set</function></member> <member><function>date_time_set</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/datetime/functions/date-format.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/datetime/functions/date-format.xml +++ phpdoc/en/reference/datetime/functions/date-format.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.date-format"> <refnamediv> <refname>date_format</refname> <refpurpose>Returns date formatted according to given format</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type><methodname>date_format</methodname> <methodparam><type>DateTime</type><parameter>object</parameter></methodparam> <methodparam><type>string</type><parameter>format</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>string</type><methodname>DateTime::format</methodname> <methodparam><type>string</type><parameter>format</parameter></methodparam> </methodsynopsis> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>object</parameter></term> <listitem> <para> DateTime object. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>format</parameter></term> <listitem> <para> Format accepted by <function>date</function>. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Returns formatted date on success or &false; on failure. </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>date</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/datetime/functions/date-isodate-set.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/datetime/functions/date-isodate-set.xml +++ phpdoc/en/reference/datetime/functions/date-isodate-set.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.date-isodate-set"> <refnamediv> <refname>date_isodate_set</refname> <refpurpose>Sets the ISO date</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>date_isodate_set</methodname> <methodparam><type>DateTime</type><parameter>object</parameter></methodparam> <methodparam><type>int</type><parameter>year</parameter></methodparam> <methodparam><type>int</type><parameter>week</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>day</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>void</type><methodname>DateTime::setISODate</methodname> <methodparam><type>int</type><parameter>year</parameter></methodparam> <methodparam><type>int</type><parameter>week</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>day</parameter></methodparam> </methodsynopsis> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>object</parameter></term> <listitem> <para> DateTime object. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>year</parameter></term> <listitem> <para> Year of the date. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>month</parameter></term> <listitem> <para> Month of the date. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>day</parameter></term> <listitem> <para> Day of the date. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Returns &null; on success or &false; on failure. </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>date_date_set</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/datetime/functions/date-modify.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/datetime/functions/date-modify.xml +++ phpdoc/en/reference/datetime/functions/date-modify.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.date-modify"> <refnamediv> <refname>date_modify</refname> <refpurpose>Alters the timestamp</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>date_modify</methodname> <methodparam><type>DateTime</type><parameter>object</parameter></methodparam> <methodparam><type>string</type><parameter>modify</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>void</type><methodname>DateTime::modify</methodname> <methodparam><type>string</type><parameter>modify</parameter></methodparam> </methodsynopsis> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>object</parameter></term> <listitem> <para> DateTime object. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>modify</parameter></term> <listitem> <para> String in a relative format accepted by <function>strtotime</function>. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Returns &null; on success or &false; on failure. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>A <function>date_modify</function> example</title> <programlisting role="php"> <![CDATA[ <?php $date = new DateTime("2006-12-12"); $date->modify("+1 day"); echo $date->format("Y-m-d"); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ 2006-12-13 ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>strtotime</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/datetime/functions/date-offset-get.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/datetime/functions/date-offset-get.xml +++ phpdoc/en/reference/datetime/functions/date-offset-get.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.date-offset-get"> <refnamediv> <refname>date_offset_get</refname> <refpurpose>Returns the daylight saving time offset</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>date_offset_get</methodname> <methodparam><type>DateTime</type><parameter>object</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>int</type><methodname>DateTime::getOffset</methodname> <void/> </methodsynopsis> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>object</parameter></term> <listitem> <para> DateTime object. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Returns DST offset in seconds on success or &false; on failure. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/datetime/functions/date-parse.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/datetime/functions/date-parse.xml +++ phpdoc/en/reference/datetime/functions/date-parse.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.date-parse"> <refnamediv> <refname>date_parse</refname> <refpurpose>Returns associative array with detailed info about given date</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>array</type><methodname>date_parse</methodname> <methodparam><type>string</type><parameter>date</parameter></methodparam> </methodsynopsis> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>date</parameter></term> <listitem> <para> Date in format accepted by <function>strtotime</function>. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Returns array on success or &false; on failure. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>A <function>date_parse</function> example</title> <programlisting role="php"> <![CDATA[ <?php print_r(date_parse("2006-12-12 10:00:00.5")); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Array ( [year] => 2006 [month] => 12 [day] => 12 [hour] => 10 [minute] => 0 [second] => 0 [fraction] => 0.5 [warning_count] => 0 [warnings] => Array() [error_count] => 0 [errors] => Array() [is_localtime] => ) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>getdate</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/datetime/functions/date-sun-info.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/datetime/functions/date-sun-info.xml +++ phpdoc/en/reference/datetime/functions/date-sun-info.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.date-sun-info"> <refnamediv> <refname>date_sun_info</refname> <refpurpose>Returns an array with information about sunset/sunrise and twilight begin/end</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>array</type><methodname>date_sun_info</methodname> <methodparam><type>int</type><parameter>time</parameter></methodparam> <methodparam><type>float</type><parameter>latitude</parameter></methodparam> <methodparam><type>float</type><parameter>longitude</parameter></methodparam> </methodsynopsis> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>time</parameter></term> <listitem> <para> Timestsmp. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>latitude</parameter></term> <listitem> <para> Latitude in degrees. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>longitude</parameter></term> <listitem> <para> Longitude in degrees. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Returns array on success or &false; on failure. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>A <function>date_sun_info</function> example</title> <programlisting role="php"> <![CDATA[ <?php $sun_info = date_sun_info(strtotime("2006-12-12"), 31.7667, 35.2333); foreach ($sun_info as $key => $val) { echo "$key: " . date("H:i:s", $val) . "\n"; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ sunrise: 05:52:11 sunset: 15:41:21 transit: 10:46:46 civil_twilight_begin: 05:24:08 civil_twilight_end: 16:09:24 nautical_twilight_begin: 04:52:25 nautical_twilight_end: 16:41:06 astronomical_twilight_begin: 04:21:32 astronomical_twilight_end: 17:12:00 ]]> </screen> </example> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/datetime/functions/date-time-set.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/datetime/functions/date-time-set.xml +++ phpdoc/en/reference/datetime/functions/date-time-set.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.date-time-set"> <refnamediv> <refname>date_time_set</refname> <refpurpose>Sets the time</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>date_time_set</methodname> <methodparam><type>DateTime</type><parameter>object</parameter></methodparam> <methodparam><type>int</type><parameter>hour</parameter></methodparam> <methodparam><type>int</type><parameter>minute</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>second</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>void</type><methodname>DateTime::setTime</methodname> <methodparam><type>int</type><parameter>hour</parameter></methodparam> <methodparam><type>int</type><parameter>minute</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>second</parameter></methodparam> </methodsynopsis> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>object</parameter></term> <listitem> <para> DateTime object. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>hour</parameter></term> <listitem> <para> Hour of the time. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>minute</parameter></term> <listitem> <para> Minute of the time. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>second</parameter></term> <listitem> <para> Second of the time. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Returns &null; on success or &false; on failure. </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>date_date_set</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/datetime/functions/date-timezone-get.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/datetime/functions/date-timezone-get.xml +++ phpdoc/en/reference/datetime/functions/date-timezone-get.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.date-timezone-get"> <refnamediv> <refname>date_timezone_get</refname> <refpurpose>Return time zone relative to given DateTime</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>DateTimeZone</type><methodname>date_timezone_get</methodname> <methodparam><type>DateTime</type><parameter>object</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>DateTimeZone</type><methodname>DateTime::getTimezone</methodname> <void/> </methodsynopsis> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>object</parameter></term> <listitem> <para> DateTime object. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Returns DateTimeZone object on success or &false; on failure. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/datetime/functions/date-timezone-set.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/datetime/functions/date-timezone-set.xml +++ phpdoc/en/reference/datetime/functions/date-timezone-set.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.date-timezone-set"> <refnamediv> <refname>date_timezone_set</refname> <refpurpose>Sets the time zone for the DateTime object</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>date_timezone_set</methodname> <methodparam><type>DateTime</type><parameter>object</parameter></methodparam> <methodparam><type>DateTimeZone</type><parameter>timezone</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>void</type><methodname>DateTime::setTimezone</methodname> <methodparam><type>DateTimeZone</type><parameter>timezone</parameter></methodparam> </methodsynopsis> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>object</parameter></term> <listitem> <para> DateTime object. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>timezone</parameter></term> <listitem> <para> Desired time zone. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Returns &null; on success or &false; on failure. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/datetime/functions/timezone-abbreviations-list.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/datetime/functions/timezone-abbreviations-list.xml +++ phpdoc/en/reference/datetime/functions/timezone-abbreviations-list.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.timezone-abbreviations-list"> <refnamediv> <refname>timezone_abbreviations_list</refname> <refpurpose>Returns associative array containing dst, offset and the timezone name</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>array</type><methodname>timezone_abbreviations_list</methodname> <void/> </methodsynopsis> <methodsynopsis> <type>array</type><methodname>DateTimeZone::listAbbreviations</methodname> <void/> </methodsynopsis> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Returns array on success or &false; on failure. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>A <function>timezone_abbreviations_list</function> example</title> <programlisting role="php"> <![CDATA[ <?php $timezone_abbreviations = DateTimeZone::listAbbreviations(); print_r($timezone_abbreviations["acst"]); ?> ]]> </programlisting> &example.outputs.similar; <screen> <![CDATA[ Array ( [0] => Array ( [dst] => 1 [offset] => -14400 [timezone_id] => America/Porto_Acre ) [1] => Array ( [dst] => 1 [offset] => -14400 [timezone_id] => America/Eirunepe ) [2] => Array ( [dst] => 1 [offset] => -14400 [timezone_id] => America/Rio_Branco ) [3] => Array ( [dst] => 1 [offset] => -14400 [timezone_id] => Brazil/Acre ) ) ]]> </screen> </example> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/datetime/functions/timezone-identifiers-list.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/datetime/functions/timezone-identifiers-list.xml +++ phpdoc/en/reference/datetime/functions/timezone-identifiers-list.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.timezone-identifiers-list"> <refnamediv> <refname>timezone_identifiers_list</refname> <refpurpose>Returns numerically index array with all timezone identifiers</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>array</type><methodname>timezone_identifiers_list</methodname> <void/> </methodsynopsis> <methodsynopsis> <type>array</type><methodname>DateTimeZone::listIdentifiers</methodname> <void/> </methodsynopsis> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> What the function returns, first on success, then on failure. See also the &return.success; entity </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>A <function>timezone_identifiers_list</function> example</title> <programlisting role="php"> <![CDATA[ <?php $timezone_identifiers = DateTimeZone::listIdentifiers(); for ($i=0; $i < 5; $i++) { echo "$timezone_identifiers[$i]\n"; } ?> ]]> </programlisting> &example.outputs.similar; <screen> <![CDATA[ Africa/Abidjan Africa/Accra Africa/Addis_Ababa Africa/Algiers Africa/Asmera ]]> </screen> </example> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/datetime/functions/timezone-name-from-abbr.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/datetime/functions/timezone-name-from-abbr.xml +++ phpdoc/en/reference/datetime/functions/timezone-name-from-abbr.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.timezone-name-from-abbr"> <refnamediv> <refname>timezone_name_from_abbr</refname> <refpurpose>Returns the timezone name from abbrevation</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type><methodname>timezone_name_from_abbr</methodname> <methodparam><type>string</type><parameter>abbr</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>gmtOffset</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>isdst</parameter></methodparam> </methodsynopsis> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>abbr</parameter></term> <listitem> <para> Time zone abbreviation. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>gmtOffset</parameter></term> <listitem> <para> Offset from GMT in seconds. Defaults to -1 which means that first found time zone corresponding to <parameter>abbr</parameter> is returned. Otherwise exact offset is searched and only if not found then the first time zone with any offset is returned. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>isdst</parameter></term> <listitem> <para> Daylight saving time indicator. If <parameter>abbr</parameter> doesn't exist then the time zone is searched solely by <parameter>offset</parameter> and <parameter>isdst</parameter>. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Returns time zone name on success or &false; on failure. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>A <function>timezone_name_from_abbr</function> example</title> <programlisting role="php"> <![CDATA[ <?php echo timezone_name_from_abbr("CET") . "\n"; echo timezone_name_from_abbr("", 3600, 0) . "\n"; ?> ]]> </programlisting> &example.outputs.similar; <screen> <![CDATA[ Europe/Berlin Europe/Paris ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>timezone_abbreviations_list</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/datetime/functions/timezone-name-get.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/datetime/functions/timezone-name-get.xml +++ phpdoc/en/reference/datetime/functions/timezone-name-get.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.timezone-name-get"> <refnamediv> <refname>timezone_name_get</refname> <refpurpose>Returns the name of the timezone</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>string</type><methodname>timezone_name_get</methodname> <methodparam><type>DateTimeZone</type><parameter>object</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>string</type><methodname>DateTimeZone::getName</methodname> <void/> </methodsynopsis> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>object</parameter></term> <listitem> <para> DateTimeZone object. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Returns time zone name on success or &false; on failure. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/datetime/functions/timezone-offset-get.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/datetime/functions/timezone-offset-get.xml +++ phpdoc/en/reference/datetime/functions/timezone-offset-get.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.timezone-offset-get"> <refnamediv> <refname>timezone_offset_get</refname> <refpurpose>Returns the timezone offset</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>timezone_offset_get</methodname> <methodparam><type>DateTimeZone</type><parameter>object</parameter></methodparam> <methodparam><type>DateTime</type><parameter>datetime</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>int</type><methodname>DateTimeZone::getOffset</methodname> <methodparam><type>DateTime</type><parameter>datetime</parameter></methodparam> </methodsynopsis> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>object</parameter></term> <listitem> <para> DateTimeZone object. </para> </listitem> </varlistentry> <varlistentry> <term><parameter>datetime</parameter></term> <listitem> <para> DateTime to compute offset from. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Returns time zone offset in seconds on success or &false; on failure. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/datetime/functions/timezone-open.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/datetime/functions/timezone-open.xml +++ phpdoc/en/reference/datetime/functions/timezone-open.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.timezone-open"> <refnamediv> <refname>timezone_open</refname> <refpurpose>Returns new DateTimeZone object</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>DateTimeZone</type><methodname>timezone_open</methodname> <methodparam><type>string</type><parameter>timezone</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>DateTimeZone</type><methodname>DateTimeZone::__construct</methodname> <methodparam><type>string</type><parameter>timezone</parameter></methodparam> </methodsynopsis> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>timezone</parameter></term> <listitem> <para> Time zone identifier as full name (e.g. Europe/Prague) or abbreviation (e.g. CET). </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Returns DateTimeZone object on success or &false; on failure. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/datetime/functions/timezone-transitions-get.xml?view=markup&rev=1.1 Index: phpdoc/en/reference/datetime/functions/timezone-transitions-get.xml +++ phpdoc/en/reference/datetime/functions/timezone-transitions-get.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.timezone-transitions-get"> <refnamediv> <refname>timezone_transitions_get</refname> <refpurpose>Returns all transitions for the timezone</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>array</type><methodname>timezone_transitions_get</methodname> <methodparam><type>DateTimeZone</type><parameter>object</parameter></methodparam> </methodsynopsis> <methodsynopsis> <type>array</type><methodname>DateTimeZone::getTransitions</methodname> <void/> </methodsynopsis> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>object</parameter></term> <listitem> <para> DateTimeZone object. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Returns numeracilly indexed array containing associative array with all transitions on success or &false; on failure. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>A <function>timezone_transitions_get</function> example</title> <programlisting role="php"> <![CDATA[ <?php $timezone = new DateTimeZone("CET"); print_r(reset($timezone->getTransitions())); ?> ]]> </programlisting> &example.outputs.similar; <screen> <![CDATA[ Array ( [ts] => -1693706400 [time] => 1916-04-30T22:00:00+0000 [offset] => 7200 [isdst] => 1 [abbr] => CEST ) ]]> </screen> </example> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->