cvs: phpdoc-ru /reference/datetime/functions mktime.xml

tony2001 Sat Apr 15 12:11:31 2006 UTC Modified files: /phpdoc-ru/reference/datetime/functions mktime.xml Log: fix typos remove some weird parts invented by the translator update the translation http://cvs.php.net/viewcvs.cgi/phpdoc-ru/reference/datetime/functions/mktime.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-ru/reference/datetime/functions/mktime.xml diff -u phpdoc-ru/reference/datetime/functions/mktime.xml:1.3 phpdoc-ru/reference/datetime/functions/mktime.xml:1.4 --- phpdoc-ru/reference/datetime/functions/mktime.xml:1.3 Sun Mar 6 16:44:18 2005 +++ phpdoc-ru/reference/datetime/functions/mktime.xml Sat Apr 15 12:11:31 2006 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- EN-Revision: 1.8 Maintainer: blindman Status: ready --> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> <refentry id="function.mktime"> <refnamediv> @@ -20,27 +20,25 @@ <methodparam choice="opt"><type>int</type><parameter>is_dst</parameter></methodparam> </methodsynopsis> <para> - <emphasis>Предепреждение:</emphasis> Обратите внимание на странный - порядок аргументов, отличающийся от порядка аргументов стандартной - функции Unix mktime() и делающий неудобной работу с необязательными - аргументами. Часто при написании скриптов путают порядок аргументов, - что приводит к ошибкам. - </para> - <para> Функция возвращает метку времени Unix, соответствующую дате и времени, заданным аргументами. - Метка времени - это цело число, равное разнице в секундах между + Метка времени - это целое число равное разнице в секундах между заданной датой/временем и началом Эпохи Unix (The Unix Epoch, 1 января 1970 г). </para> <para> - Аргументы могут быть опущены в порядке справа налево. Опущенные - аргументы считаются равными соответствующим компонентам локальной + Функция <function>mktime</function> возвращает &false;, если аргументы + были неверны (до 5.1.0 в этом случае она возвращала -1). + </para> + </para> + <para> + Аргументы могут быть опущены в порядке справа налево. В этом случае их + значения по умолчанию равны соответствующим компонентам локальной даты/времени. </para> <para> Аргумент <parameter>is_dst</parameter> может быть установлен в 1, если заданной дате соответствует летнее время, 0 в противном случае, - или -1 (значение по умолчанию), если неизвестно, действует ли летнеее + или -1 (значение по умолчанию), если неизвестно, действует ли летнее время на заданную дату. В последнем случае PHP пытается определить это самостоятельно. Это можно привести к неожиданному результату (который, тем не менее, не будет неверным). @@ -48,6 +46,9 @@ <note> <para> Аргумент <parameter>is_dst</parameter> был добавлен в версии 3.0.10. + Начиная с версии 5.1.0 этот параметр более не рекомендуется к + использованию. Вместо этого рекомендуется устанавливать соответствующую + временную зону. </para> </note> <para> @@ -55,6 +56,8 @@ выполнения арифметических операций с датами, так как она вычисляет верные значения при некорректных аргументах. Например, в следующем примере каждая строка выведет "Jan-01-1998". + </para> + <para> <example> <title>Пример использования функции <function>mktime</function></title> <programlisting role="php"> @@ -68,7 +71,9 @@ ]]> </programlisting> </example> - <parameter>Year</parameter> может быть двух- или четырехзначным + </para> + <para> + <parameter>year</parameter> может быть двух- или четырехзначным числом. Значения от 0 до 69 соответствуют 2000-2069, а 70-99 соответствуют 1970-1999 (в большинстве современных систем, где время представляется 32-битным целым со знаком, допустимыми являются @@ -76,11 +81,12 @@ </para> <para> <note> - <title>Windows</title> + <title>Внимание</title> <simpara> - Ни одна из версий Windows не поддерживает отрицательные метки - времени. Поэтому для Windows допустимыми являются значения - <parameter>year</parameter> между 1970 и 2038. + До PHP 5.1.0 отрицательные метки времени не поддерживались под всеми + системами Windows, а также некоторыми другими. Следовательно, + допустимые значения параметра <parameter>year</parameter> были + между 1970 и 2038. </simpara> </note> </para> @@ -89,7 +95,7 @@ следующего месяца. Оба приведенных ниже примера выведут "Последний день в феврале 2000 г: 29". <example> - <title>Last day of next month</title> + <title>Последний день следующего месяца</title> <programlisting role="php"> <![CDATA[ <?php @@ -103,13 +109,9 @@ </programlisting> </example> </para> - <simpara> - Даты, в которых год, месяц и день равны 0, считаются неверными - (иначе им бы соответствовала дата 30.11.1999, что, согласитесь, было - бы довольно странно). - </simpara> <para> - См. также описание функций <function>date</function> и <function>time</function>. + См. также <function>date</function>, <function>time</function> и + <function>gmmktime</function>. </para> </refsect1> </refentry>