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

stanprog                                 Sat, 21 May 2016 22:51:43 +0000

Revision: http://svn.php.net/viewvc?view=revision&revision=339205

Log:
sync with EN

Changed paths:
    U   phpdoc/bg/trunk/reference/datetime/functions/microtime.xml

Modified: phpdoc/bg/trunk/reference/datetime/functions/microtime.xml
===================================================================
--- phpdoc/bg/trunk/reference/datetime/functions/microtime.xml	2016-05-21 22:40:57 UTC (rev 339204)
+++ phpdoc/bg/trunk/reference/datetime/functions/microtime.xml	2016-05-21 22:51:43 UTC (rev 339205)
@@ -1,44 +1,67 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: kouber Status: ready -->
-<!-- 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>
-     Връща текущия Unix времеви отпечатък с микросекунди
-    </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> връща текущия Unix времеви отпечатък с микросекунди.
-     Тази функция е налична само на операционни системи, които поддържат системното извикване
-     gettimeofday().
-    </para>
-    <para>
-     Когато се извика без незадължителния аргумент, тази функция връща низа
-     "msec sec", където sec е текущото време измерено в броя секунди от Unix
-     епохата (0:00:00 1 януари 1970 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">
+<!-- EN-Revision: 334621 Maintainer: stanprog Status: ready -->
+<!-- CREDITS: kouber -->
+<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><initializer>false</initializer></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>
+       If used and set to &true;, <function>microtime</function> will return a
+       <type>float</type> instead of a <type>string</type>, as described in
+       the return values section below.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   По подразбиране функция <function>microtime</function> връща низ
+   във вид "msec sec", където <literal>sec</literal> е броят секунди
+   след Unix епохата (0:00:00 1 януари 1970 GMT), а <literal>msec</literal>
+   указва микросекундите, които са изминали от <literal>sec</literal>
+   и също се е в секунди.
+  </para>
+  <para>
+   Ако <parameter>get_as_float</parameter> е установен в &true;,
+   <function>microtime</function> връща число с плаваща запетая, което
+   представлява текущото време в секунди след Unix епохата с точност до
+   най-близката микросекунда.
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Скрипт за измерване на времето на изпълнение с <function>microtime</function></title>
+    <programlisting role="php">
 <![CDATA[
 <?php
 /**
@@ -61,11 +84,11 @@
 echo "Не направих нищо за $time секунди\n";
 ?>
 ]]>
-      </programlisting>
-     </example>
-     <example>
-      <title>Скрипт за измерване на времето на изпълнение в PHP5</title>
-      <programlisting role="php">
+    </programlisting>
+   </example>
+   <example>
+    <title>Скрипт за измерване на времето на изпълнение в PHP5</title>
+    <programlisting role="php">
 <![CDATA[
 <?php
 $time_start = microtime(true);
@@ -80,14 +103,37 @@
 ?>
 ]]>
       </programlisting>
-     </example>
-    </para>
-    <para>
-     Вж. също <function>time</function>.
-    </para>
-   </refsect1>
-  </refentry>
+   </example>
+   <example>
+    <title>Пример за <function>microtime</function> с <literal>REQUEST_TIME_FLOAT</literal> (от PHP 5.4.0)</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// Randomize sleeping time
+usleep(mt_rand(100, 10000));

+// От 5.4.0, REQUEST_TIME_FLOAT е налична в суперглобалния масив $_SERVER.
+// Съдържа времевия отпечатък на началото на заявката с точност до микросекундата.
+$time = microtime(true) - $_SERVER["REQUEST_TIME_FLOAT"];
+
+echo "Did nothing in $time seconds\n";
+?>
+]]>
+    </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