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

Modified: phpdoc/bg/trunk/reference/datetime/functions/mktime.xml
===================================================================
--- phpdoc/bg/trunk/reference/datetime/functions/mktime.xml	2016-05-21 23:58:48 UTC (rev 339210)
+++ phpdoc/bg/trunk/reference/datetime/functions/mktime.xml	2016-05-22 12:50:58 UTC (rev 339211)
@@ -1,37 +1,49 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: kouber Status: ready -->
-<!-- CREDITS: stanprog -->
-<!-- splitted from ./en/functions/datetime.xml, last change in rev 1.2 -->
+<!-- EN-Revision: 336807 Maintainer: stanprog Status: ready -->
+<!-- CREDITS: kouber -->
 <refentry xml:id="function.mktime" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>mktime</refname>
   <refpurpose>Взима Unix времеви отпечатък за дата</refpurpose>
  </refnamediv>
-
+
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
    <type>int</type><methodname>mktime</methodname>
-   <methodparam choice="opt"><type>int</type><parameter>hour</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>minute</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>second</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>month</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>day</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>year</parameter></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>is_dst</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>hour</parameter><initializer>date("H")</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>minute</parameter><initializer>date("i")</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>second</parameter><initializer>date("s")</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>month</parameter><initializer>date("n")</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>day</parameter><initializer>date("j")</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>year</parameter><initializer>date("Y")</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>is_dst</parameter><initializer>-1</initializer></methodparam>
   </methodsynopsis>
   <para>
-   Връща Unix времеви отпечатък (timestamp), който отговаря на подадените аргументи.
-   Този timestamp е голямо цяло число (long integer), съдържащ броя секунди между Unix
-   Епохата (1 януари 1970 00:00:00 GMT) и указаното време.
+   Връща Unix времеви отпечатък (timestamp), който отговаря на подадените
+   аргументи. Този timestamp е голямо цяло число (long integer), съдържащ броя
+   секунди между Unix Епохата (1 януари 1970 00:00:00 GMT) и
+   указаното време.
   </para>
   <para>
-   Аргументите могат да бъдат пропускани от дясно на ляво; така на всеки пропуснат аргумент
-   ще бъде присвоена текущата стойност, съгласно локалното време и дата.
+   Аргументите могат да бъдат пропускани от дясно на ляво; така на
+   всеки пропуснат аргумент ще бъде присвоена текущата стойност, съгласно
+   локалното време и дата.
   </para>
  </refsect1>
-
+
+ <refsect1 role="notes">
+  &reftitle.notes;
+  <note>
+   <para>
+    От PHP 5.1, при извикването на функция <function>mktime</function> без аргументи
+    се генерира съобщение то ниво <constant>E_STRICT</constant>: вместо нея
+    можете да използвате функция <function>time</function>.
+   </para>
+  </note>
+ </refsect1>
+
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
@@ -40,7 +52,10 @@
      <term><parameter>hour</parameter></term>
      <listitem>
       <para>
-       Стойността за часа.
+       Количеството часове, изминали от началото на деня, указан от параметрите
+       <parameter>month</parameter>, <parameter>day</parameter> и <parameter>year</parameter>.
+       Отрицателните стойности определят часовете до полунощ на указаният ден.
+       Стойности по-големи от 23 определят съответстващият час на следващия ден (или дни).
       </para>
      </listitem>
     </varlistentry>
@@ -48,7 +63,9 @@
      <term><parameter>minute</parameter></term>
      <listitem>
       <para>
-       Стойността за минутата.
+       Количеството минути, изминали от началото на часа, указан от параметъра <parameter>hour</parameter>.
+       Отрицателните стойности определят минутата от предишния час.
+       Стойности по-големи от 59 определят съответстващите минути на следващия час (или часове).
       </para>
      </listitem>
     </varlistentry>
@@ -56,7 +73,9 @@
      <term><parameter>second</parameter></term>
      <listitem>
       <para>
-       Стойността за секундите.
+       Количеството секунди, изминали от началото на минутата, указана от параметъра <parameter>minute</parameter>.
+       Отрицателните стойности определят секундата от предишната минута.
+       Стойности по-големи от 59 определят съответстващите секунди на следващата минута (или минути).
       </para>
      </listitem>
     </varlistentry>
@@ -64,7 +83,10 @@
      <term><parameter>month</parameter></term>
      <listitem>
       <para>
-       Стойността за месеца.
+       Поредността на месеца, отнесен към края на предишната година.
+       Стойности от 1 до 12 указват нормалните месеци от календара за въпросната година.
+       Стойности по-малки от 1 (в това число и отрицателни стойности) указват месеца от предишната година в обратен ред, -1 е ноември, и т.н.
+       Стойности по-големи от 12 определят съответстващият месец на следващата година (или години).
       </para>
      </listitem>
     </varlistentry>
@@ -72,7 +94,10 @@
      <term><parameter>day</parameter></term>
      <listitem>
       <para>
-       Стойността за деня.
+       Поредността на деня, отнесен към края на предишния месец.
+       Стойности от 1 до 28, 29, 30 или 31 (в зависимост от месеца) указват нормалните дни от календара за въпросния месец.
+       Стойности по-малки от 1 (в това число и отрицателни стойности) указват деня от предишният месец, по този начин 0 е последният ден от предишния месец, -1 е денят преди него, и т.н.
+       Стойности по-големи от броя на дните в дадения месец определят съответстващият ден от следващият месец (или месеци).
       </para>
      </listitem>
     </varlistentry>
@@ -81,12 +106,11 @@
      <listitem>
       <para>
        Стойността за годината може да бъде число с две или четири цифри,
-       като стойностите между 0 и 69 се приемат за години между
-       2000 и 2069, а стойности между 70 и 100 за години между
-       1970 и 2000. На системи при които time_t е 32 битово цяло число
-       със знак, каквито са повечето съвременни системи, валидните
-       стойности за <parameter>year</parameter> са между 1901 и 2038,
-       въпреки че, това ограничение е преодоляно от PHP 5.1.0.
+       като стойностите между 0 и 69 се приемат за години между 2000 и 2069, а стойности между 70 и 100 за години между
+       1970 и 2000. На системи при които time_t е 32 битово цяло число със знак, каквито са
+       повечето съвременни системи, валидните  стойности за <parameter>year</parameter>
+       са между 1901 и 2038. Този обхват преди PHP 5.1.0
+       беше ограничен между 1970 и 2038 на същите системи (напри. Windows).
       </para>
      </listitem>
     </varlistentry>
@@ -94,20 +118,16 @@
      <term><parameter>is_dst</parameter></term>
      <listitem>
       <para>
-       Този параметър може да бъде установен в 1, ако времето е през лятното
-       часово време (DST), 0 ако не е или -1 (по подразбиране) ако не е известно дали
-       времето е през лятното часово време или не. Ако не е известно, PHP
-       ще направи опит да го открие. Това може да предизвика неочаквани
-       (но не и неправилни) резултати.
-       Някои времена се считат за невалидни ако лятното часово време е включено
-       на системата на която е стартирано PHP или ако параметъра
-       <parameter>is_dst</parameter> е установен в 1. Ако лятното часово време е включено,
-       като например в 2:00, всички времена между 2:00 и 3:00 ще са невалидни и
-       функция <function>mktime</function> ще върне недефинирана (обикновено отрицателна)
-       стойност.
+       Този параметър може да бъде установен в 1, ако времето е през лятното часово време (DST),
+       0 ако не е или -1 (по подразбиране) ако не е известно дали  времето е през
+       лятното часово време или не. Ако не е известно, PHP  ще направи опит да го открие.
+       Това може да предизвика неочаквани (но не и неправилни) резултати.
+       Някои времена се считат за невалидни ако лятното часово време е включено  на системата на която е стартирано PHP или ако параметъра
+       <parameter>is_dst</parameter> е установен в 1. Ако лятното часово време е включено, като например в 2:00, всички времена
+       между 2:00 и 3:00 ще са невалидни и функция <function>mktime</function> ще върне недефинирана
+       (обикновено отрицателна) стойност.
        Някои системи (като Solaris 8) включват лятното часово време в полунощ, така че
-       часът 0:30 от денят при включено лятно часово време ще се изчислява като 23:30
-       от предишния ден.
+       часът 0:30 от денят при включено лятно часово време ще се изчислява като 23:30 от предишния ден.
       </para>
       <note>
        <para>
@@ -115,28 +135,33 @@
         трябва да се използват новите възможности за манипулиране на часовите зони.
        </para>
       </note>
+      <note>
+       <para>
+        Този параметър е премахнат в PHP 7.0.0.
+       </para>
+      </note>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
  </refsect1>
-
-
+
+
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   <function>mktime</function> връща Unix timestamp на подадените аргументи.
-   Ако аргументите са невалидни, функцията ще върне &false; (до PHP 5.1 връщаше <literal>-1</literal>).
+   <function>mktime</function> връща Unix timestamp на
+   подадените аргументи.
+   Ако аргументите са невалидни, функцията ще върне &false; (до PHP 5.1
+   връщаше <literal>-1</literal>).
   </para>
  </refsect1>
-
+
  <refsect1 role="errors">
   &reftitle.errors;
-
-   &date.timezone.errors.description;
+  &date.timezone.errors.description;
+ </refsect1>

- </refsect1>
-
  <refsect1 role="changelog">
   &reftitle.changelog;
   <para>
@@ -150,35 +175,74 @@
      </thead>
      <tbody>
       <row>
-       <entry>3.0.10</entry>
-       <entry>Беше добавен параметърът <parameter>is_dst</parameter></entry>
+       <entry>7.0.0</entry>
+       <entry>
+        Премахнат е параметърът <parameter>is_dst</parameter>.
+       </entry>
       </row>
       <row>
+       <entry>5.3.0</entry>
+       <entry>
+        <function>mktime</function> вече генерира съобщение от тип <constant>E_DEPRECATED</constant>,
+        ако бъде използван параметър <parameter>is_dst</parameter>.
+       </entry>
+      </row>
+      <row>
        <entry>5.1.0</entry>
        <entry>
         Параметърът <parameter>is_dst</parameter> стана непрепоръчителен.
-        Функцията връща &false; при грешка, вместо <literal>-1</literal>.
-        Функцията приема година, месец и ден предадени като нули.
+        Функцията връща &false; при грешка, вместо
+        <literal>-1</literal>.
+        Функцията приема година, месец и ден предадени като
+        нули.
        </entry>
       </row>
+      <row>
+       <entry>5.1.0</entry>
+       <entry>
+        Ако бъде извикана без аргументи, функция <function>mktime</function> генерира
+        съобщение от тип <constant>E_STRICT</constant>. Вместо нея използвайте
+        функция <function>time</function>.
+       </entry>
+      </row>

       &date.timezone.errors.changelog;
-
+
      </tbody>
     </tgroup>
    </informaltable>
   </para>
  </refsect1>
-
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
    <example>
+    <title>Прост пример за <function>mktime</function></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// Установяване на времевата зона по подразбиране. Налично от PHP 5.1
+date_default_timezone_set('UTC');
+
+// Извежда: July 1, 2000 is on a Saturday
+echo "July 1, 2000 is on a " . date("l", mktime(0, 0, 0, 7, 1, 2000));
+
+// Извежда нещо то вида: 2006-04-05T01:02:03+00:00
+echo date('c', mktime(1, 2, 3, 4, 5, 2006));
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+  <para>
+   <example>
     <title>Пример за <function>mktime</function></title>
     <para>
      <function>mktime</function> е добра за аритметика и валидиране на дати,
      защото автоматично изчислява коректната стойност за входящи данни, които
-     са извън обхвата. Например, всеки от следните редове връща низа: "Jan-01-1998".
+     са извън обхвата. Например, всеки от следните
+     редове връща низа: "Jan-01-1998".
     </para>
     <programlisting role="php">
 <![CDATA[
@@ -205,7 +269,6 @@
 <?php
 $lastday = mktime(0, 0, 0, 3, 0, 2000);
 echo strftime("Last day in Feb 2000 is: %d", $lastday);
-
 $lastday = mktime(0, 0, 0, 4, -31, 2000);
 echo strftime("Last day in Feb 2000 is: %d", $lastday);
 ?>
@@ -214,7 +277,7 @@
    </example>
   </para>
  </refsect1>
-
+
  <refsect1 role="notes">
   &reftitle.notes;
   <caution>
@@ -225,11 +288,12 @@
    </para>
   </caution>
  </refsect1>
-
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
+    <member><function>checkdate</function></member>
     <member><function>gmmktime</function></member>
     <member><function>date</function></member>
     <member><function>time</function></member>
@@ -238,6 +302,7 @@
  </refsect1>
 </refentry>

+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml