svn: /phpdoc/ru/trunk/reference/datetime/functions/ microtime.xml

From: Date: Fri, 18 Feb 2011 10:04:16 +0000
Subject: svn: /phpdoc/ru/trunk/reference/datetime/functions/ microtime.xml
Groups: php.doc.ru 
Request: Send a blank email to doc-ru+get-1408@lists.php.net to get a copy of this message
shein Fri, 18 Feb 2011 10:04:16 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=308458 Log: Updated translation. Changed paths: U phpdoc/ru/trunk/reference/datetime/functions/microtime.xml Modified: phpdoc/ru/trunk/reference/datetime/functions/microtime.xml =================================================================== --- phpdoc/ru/trunk/reference/datetime/functions/microtime.xml 2011-02-18 09:51:18 UTC (rev 308457) +++ phpdoc/ru/trunk/reference/datetime/functions/microtime.xml 2011-02-18 10:04:16 UTC (rev 308458) @@ -1,86 +1,146 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: n/a Maintainer: blindman Status: ready --> +<!-- EN-Revision: 308125 Maintainer: shein Status: ready --> +<!-- Reviewed: no --> <!-- $Revision$ --> -<!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 --> - <refentry xml:id="function.microtime" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>microtime</refname> - <refpurpose>Возвращает метку времени с микросекундами</refpurpose> - </refnamediv> - <refsect1> - <title>Описание</title> - <methodsynopsis> - <type>mixed</type><methodname>microtime</methodname> - <methodparam choice="opt"><type>bool</type><parameter>get_as_float</parameter></methodparam> - </methodsynopsis> - <para> - Функция <function>microtime</function> возвращает текущую метку - времени с микросекундами. Эта функция доступна только на операционных - системах, в которых есть системная функция gettimeofday(). - </para> - <para> - При вызове без необязательного параметра, возвращается строка в - формате "msec sec", где sec - это количество секунд, прошедших с - начала Эпохи Unix (The Unix Epoch, 1 января 1970, 00:00:00 GMT), а msec - это дробная часть. - </para> - <para> - Если передан аргумент <parameter>get_as_float</parameter>, равный - &true;, функция <function>microtime</function> возвращает действительное число. - </para> - <note> - <simpara> - Аргумент <parameter>get_as_float</parameter> появился в - <literal>PHP 5.0.0</literal>. - </simpara> - </note> - <para> - <example> - <title>Пример использования функции <function>microtime</function></title> - <programlisting role="php"> +<refentry xml:id="function.microtime" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>microtime</refname> + <refpurpose>Возвращает текущую метку времени Unix с микросекундами</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>microtime</methodname> + <methodparam choice="opt"><type>bool</type><parameter>get_as_float</parameter></methodparam> + </methodsynopsis> + <para> + Функция <function>microtime</function> возвращает текущую метку + времени Unix с микросекундами. Эта функция доступна только на + операционных системах, в которых есть системный вызов gettimeofday(). + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>get_as_float</parameter></term> + <listitem> + <para> + Если указано и установлено в &true;, <function>microtime</function> + возвратит <type>float</type> вместо <type>string</type>, + как описано в разделе возвращаемых значений ниже. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + По умолчанию <function>microtime</function> возвращает <type>string</type> + в формате "msec sec", где <literal>sec</literal> представляет собой + текущее время, прошедшее с начала Эпохи Unix + (1 января 1970 0:00:00 GMT) в секундах, а <literal>msec</literal> + - это количество микросекунд, прошедших после <literal>sec</literal>. + </para> + <para> + Если параметр <parameter>get_as_float</parameter> установлен в &true;, + то <function>microtime</function> возвратит результат в виде + <type>float</type>, представляющий собой текущее время в секундах, + прошедших с начала Эпохи Unix с точностью до микросекунд. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.0.0</entry> + <entry> + Добавлен параметр <parameter>get_as_float</parameter>. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Замер времени выполнения скрипта с помощью функции <function>microtime</function></title> + <programlisting role="php"> <![CDATA[ <?php +/** + * Простая функция для реализации поведения из PHP 5 + */ +function microtime_float() +{ + list($usec, $sec) = explode(" ", microtime()); + return ((float)$usec + (float)$sec); +} -function getmicrotime() -{ - list($usec, $sec) = explode(" ", microtime()); - return ((float)$usec + (float)$sec); -} +$time_start = microtime_float(); -$time_start = getmicrotime(); - -for ($i=0; $i < 1000; $i++) { - // Ничего не делать. Повторить 1000 раз -} +// Спим некоторое время +usleep(100); -$time_end = getmicrotime(); +$time_end = microtime_float(); $time = $time_end - $time_start; echo "Ничего не делал $time секунд\n"; +?> +]]> + </programlisting> + </example> + <example> + <title>Замер времени выполнения скрипта в PHP 5</title> + <programlisting role="php"> +<![CDATA[ +<?php +$time_start = microtime(true); -// в PHP 5 то же самое можно сделать вот так: +// Спим некоторое время +usleep(100); -$time_start = microtime(1); - -for ($i=0; $i < 1000; $i++) { - // Ничего не делать. Повторить 1000 раз -} - -$time_end = microtime(1); +$time_end = microtime(true); $time = $time_end - $time_start; echo "Ничего не делал $time секунд\n"; - ?> ]]> - </programlisting> - </example> - </para> - <para> - См. также описание функции <function>time</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>time</function></member> + </simplelist> + </para> + </refsect1> +</refentry> + <!-- Keep this comment at the end of the file Local variables: mode: sgml @@ -92,7 +152,7 @@ sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil -sgml-default-dtd-file:"../~/.phpdoc/manual.ced" +sgml-default-dtd-file:"~/.phpdoc/manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil

« previous php.doc.ru (#1408) next »