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

Modified: phpdoc/bg/trunk/reference/datetime/functions/localtime.xml
===================================================================
--- phpdoc/bg/trunk/reference/datetime/functions/localtime.xml	2016-05-21 22:30:22 UTC (rev 339203)
+++ phpdoc/bg/trunk/reference/datetime/functions/localtime.xml	2016-05-21 22:40:57 UTC (rev 339204)
@@ -1,88 +1,191 @@
 <?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.10 -->
-  <refentry xml:id="function.localtime" xmlns="http://docbook.org/ns/docbook">
-   <refnamediv>
-    <refname>localtime</refname>
-    <refpurpose>Взима местното време</refpurpose>
-   </refnamediv>
-   <refsect1>
-    <title>Описание</title>
-     <methodsynopsis>
-      <type>array</type><methodname>localtime</methodname>
-      <methodparam choice="opt"><type>int</type><parameter>
-        timestamp
-       </parameter></methodparam>
-      <methodparam choice="opt"><type>bool</type><parameter>
-        is_associative
-       </parameter></methodparam>
-     </methodsynopsis>
-    <para>
-     Функцията <function>localtime</function> връща масив, идентичен
-     на този от структурата, която се връща от извикването на C функцията.
-     Първият аргумент на <function>localtime</function> е
-     времевия отпечатък, ако не е подаден, се използва текущото време, както
-     се връща от функцията <function>time</function>.
-     Вторият аргумент на <function>localtime</function> е
-     <parameter>is_associative</parameter>, ако е установен в 0 или не е
-     подаден, тогава се връща обикновен, числово-индексиран масив.
-     Ако аргументът е установе в 1, тогава
-     <function>localtime</function> е асоциативен масив, съдържащ всички
-     елементи от структурата, върната от извикването на C функцията
-     localtime. Имената на различните ключове от асоциативния масив са
-     както следва:
-     <itemizedlist>
-      <listitem>
-       <simpara>
-        "tm_sec" - секунди
-       </simpara>
-      </listitem>
-      <listitem>
-       <simpara>
-        "tm_min" - минути
-       </simpara>
-      </listitem>
-      <listitem>
-       <simpara>
-        "tm_hour" - час
-       </simpara>
-      </listitem>
-      <listitem>
-       <simpara>
-        "tm_mday" - ден от месеца
-       </simpara>
-      </listitem>
-      <listitem>
-       <simpara>
-        "tm_mon" - месец от годината, започващ с 0 за януари
-       </simpara>
-      </listitem>
-      <listitem>
-       <simpara>
-        "tm_year" - години от 1900
-       </simpara>
-      </listitem>
-      <listitem>
-       <simpara>
-        "tm_wday" - ден от седмицата
-       </simpara>
-      </listitem>
-      <listitem>
-       <simpara>
-        "tm_yday" - ден от годината
-       </simpara>
-      </listitem>
-      <listitem>
-       <simpara>
-        "tm_isdst" - дали времето е лятно
-       </simpara>
-      </listitem>
-     </itemizedlist>
-    </para>
-   </refsect1>
-  </refentry>
+<!-- EN-Revision: 311354 Maintainer: stanprog Status: ready -->
+<!-- CREDITS: kouber -->
+<refentry xml:id="function.localtime" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>localtime</refname>
+  <refpurpose>Взима местното време</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>array</type><methodname>localtime</methodname>
+   <methodparam choice="opt"><type>int</type><parameter>timestamp</parameter><initializer>time()</initializer></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>is_associative</parameter><initializer>false</initializer></methodparam>
+  </methodsynopsis>
+  <para>
+   Функцията <function>localtime</function> връща масив,
+   идентичен на този от структурата, която се връща от извикването на
+   C функцията.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+
+    &date.timestamp.description;
+
+    <varlistentry>
+     <term><parameter>is_associative</parameter></term>
+     <listitem>
+      <para>
+       Ако е установен в &false; или не е подаден, тогава се връща обикновен,
+       числово-индексиран масив. Ако аргументът е установен в &true;, тогава
+       <function>localtime</function> е асоциативен масив, съдържащ
+       всички елементи от структурата, върната от извикването на C функцията
+       localtime. Имената на различните ключове от асоциативния масив са
+       както следва:
+      </para>
+      <para>
+       <itemizedlist>
+        <listitem>
+         <simpara>
+          "tm_sec" - секунди, от <literal>0</literal> до <literal>59</literal>
+         </simpara>
+        </listitem>
+        <listitem>
+         <simpara>
+          "tm_min" - минути, от <literal>0</literal> до <literal>59</literal>
+         </simpara>
+        </listitem>
+        <listitem>
+         <simpara>
+          "tm_hour" - час, от <literal>0</literal> до <literal>23</literal>
+         </simpara>
+        </listitem>
+        <listitem>
+         <simpara>
+          "tm_mday" - ден от месеца, от <literal>1</literal> до <literal>31</literal>
+         </simpara>
+        </listitem>
+        <listitem>
+         <simpara>
+          "tm_mon" - месец от годината, започващ с 0 за януари, <literal>0</literal> (януари) до <literal>11</literal> (декември)
+         </simpara>
+        </listitem>
+        <listitem>
+         <simpara>
+          "tm_year" - години от 1900
+         </simpara>
+        </listitem>
+        <listitem>
+         <simpara>
+          "tm_wday" - ден от седмицата, от <literal>0</literal> (неделя) до <literal>6</literal> (събота)
+         </simpara>
+        </listitem>
+        <listitem>
+         <simpara>
+          "tm_yday" - ден от годината, от <literal>0</literal> до <literal>365</literal>
+         </simpara>
+        </listitem>
+        <listitem>
+         <simpara>
+          "tm_isdst" - дали времето е лятно
+         </simpara>
+         <simpara>
+          Ако е лятно - положително число, ако не - <literal>0</literal>, а ако е неизвестно е отрицателно.
+         </simpara>
+        </listitem>
+       </itemizedlist>
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="errors">
+  &reftitle.errors;
+
+  &date.timezone.errors.description;
+
+ </refsect1>
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+
+      &date.timezone.errors.changelog;
+
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Пример за <function>localtime</function></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$localtime = localtime();
+$localtime_assoc = localtime(time(), true);
+print_r($localtime);
+print_r($localtime_assoc);
+?>
+]]>
+    </programlisting>
+    &example.outputs.similar;
+    <screen>
+<![CDATA[
+Array
+(
+    [0] => 24
+    [1] => 3
+    [2] => 19
+    [3] => 3
+    [4] => 3
+    [5] => 105
+    [6] => 0
+    [7] => 92
+    [8] => 1
+)

+Array
+(
+    [tm_sec] => 24
+    [tm_min] => 3
+    [tm_hour] => 19
+    [tm_mday] => 3
+    [tm_mon] => 3
+    [tm_year] => 105
+    [tm_wday] => 0
+    [tm_yday] => 92
+    [tm_isdst] => 1
+)
+]]>
+    </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