VladPolskiy/php-doc-ru
1
0
Fork 0
mirror of https://github.com/php/doc-ru.git synced 2025-08-20 16:51:35 +00:00
Code Issues Packages Projects Releases Wiki Activity

Date/Time: improvements

Browse Source 
git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@344291 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Alexey Pyltsyn
2018-02-19 09:59:53 +00:00
parent 0949d64f0f
commit 3931b11f2e
7 changed files with 30 additions and 31 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
reference/datetime/book.xml
View File

@ -5,8 +5,8 @@
<book xml:id="book.datetime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <book xml:id="book.datetime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="core"?> <?phpdoc extension-membership="core"?>
<title>Дата и Время</title> <title>Дата и время</title>
<titleabbrev>Дата/Время</titleabbrev> <titleabbrev>Дата/время</titleabbrev>
<!-- {{{ preface --> <!-- {{{ preface -->
<preface xml:id="intro.datetime"> <preface xml:id="intro.datetime">

21
reference/datetime/functions/date.xml
View File

@ -78,7 +78,7 @@
<row> <row>
<entry><literal>N</literal></entry> <entry><literal>N</literal></entry>
<entry>Порядковый номер дня недели в соответствии со <entry>Порядковый номер дня недели в соответствии со
стандартом ISO-8601 (добавлен в версии PHP 5.1.0)</entry> стандартом ISO-8601 (добавлено в PHP 5.1.0)</entry>
<entry>от <literal>1</literal> (понедельник) до <literal>7</literal> (воскресенье)</entry> <entry>от <literal>1</literal> (понедельник) до <literal>7</literal> (воскресенье)</entry>
</row> </row>
<row> <row>
@ -117,7 +117,7 @@
</row> </row>
<row> <row>
<entry><literal>F</literal></entry> <entry><literal>F</literal></entry>
<entry>Полное наименование месяца, например January или March</entry> <entry>Полное наименование месяца, например, January или March</entry>
<entry>от <literal>January</literal> до <literal>December</literal></entry> <entry>от <literal>January</literal> до <literal>December</literal></entry>
</row> </row>
<row> <row>
@ -155,7 +155,7 @@
<entry>Номер года в соответствии со стандартом ISO-8601. Имеет то же значение, что и <entry>Номер года в соответствии со стандартом ISO-8601. Имеет то же значение, что и
<literal>Y</literal>, кроме случая, когда номер недели ISO <literal>Y</literal>, кроме случая, когда номер недели ISO
(<literal>W</literal>) принадлежит предыдущему или следующему году; тогда (<literal>W</literal>) принадлежит предыдущему или следующему году; тогда
будет использован год этой недели. (добавлен в версии PHP 5.1.0)</entry> будет использован год этой недели. (добавлено в PHP 5.1.0)</entry>
<entry>Примеры: <literal>1999</literal> или <literal>2003</literal></entry> <entry>Примеры: <literal>1999</literal> или <literal>2003</literal></entry>
</row> </row>
<row> <row>
@ -175,7 +175,7 @@
</row> </row>
<row> <row>
<entry><literal>a</literal></entry> <entry><literal>a</literal></entry>
<entry>Ante meridiem (англ. "до полудня") или Post meridiem (англ. "после полудня") <entry>Ante meridiem (лат. "до полудня") или Post meridiem (лат. "после полудня")
в нижнем регистре</entry> в нижнем регистре</entry>
<entry><literal>am</literal> или <literal>pm</literal></entry> <entry><literal>am</literal> или <literal>pm</literal></entry>
</row> </row>
@ -222,7 +222,7 @@
<row> <row>
<entry><literal>u</literal></entry> <entry><literal>u</literal></entry>
<entry> <entry>
Микросекунды (добавлено в версии PHP 5.2.2). Учтите, что <function>date</function> Микросекунды (добавлено в PHP 5.2.2). Учтите, что <function>date</function>
всегда будет возвращать <literal>000000</literal>, т.к. она принимает целочисленный всегда будет возвращать <literal>000000</literal>, т.к. она принимает целочисленный
параметр, тогда как <methodname>DateTime::format</methodname> поддерживает параметр, тогда как <methodname>DateTime::format</methodname> поддерживает
микросекунды, если <classname>DateTime</classname> создан с ними. микросекунды, если <classname>DateTime</classname> создан с ними.
@ -244,7 +244,7 @@
</row> </row>
<row> <row>
<entry><literal>e</literal></entry> <entry><literal>e</literal></entry>
<entry>Идентификатор временной зоны (добавлен в версии PHP 5.1.0)</entry> <entry>Идентификатор временной зоны (добавлено в PHP 5.1.0)</entry>
<entry>Примеры: <literal>UTC</literal>, <literal>GMT</literal>, <literal>Atlantic/Azores</literal></entry> <entry>Примеры: <literal>UTC</literal>, <literal>GMT</literal>, <literal>Atlantic/Azores</literal></entry>
</row> </row>
<row> <row>
@ -259,7 +259,7 @@
</row> </row>
<row> <row>
<entry><literal>P</literal></entry> <entry><literal>P</literal></entry>
<entry>Разница с временем по Гринвичу с двоеточием между часами и минутами (добавлено в версии PHP 5.1.3)</entry> <entry>Разница с временем по Гринвичу с двоеточием между часами и минутами (добавлено в PHP 5.1.3)</entry>
<entry>Например: <literal>+02:00</literal></entry> <entry>Например: <literal>+02:00</literal></entry>
</row> </row>
<row> <row>
@ -291,8 +291,7 @@
</row> </row>
<row> <row>
<entry><literal>U</literal></entry> <entry><literal>U</literal></entry>
<entry>Количество секунд, прошедших с начала Эпохи Unix (The Unix <entry>Количество секунд, прошедших с начала Эпохи Unix (1 января 1970 00:00:00 GMT)</entry>
Epoch, 1 января 1970 00:00:00 GMT)</entry>
<entry>См. также <function>time</function></entry> <entry>См. также <function>time</function></entry>
</row> </row>
</tbody> </tbody>
@ -384,7 +383,7 @@
<programlisting role="php"> <programlisting role="php">
<![CDATA[ <![CDATA[
<?php <?php
// установка временной зоны по умолчанию. Доступно начиная с версии PHP 5.1 // установка временной зоны по умолчанию. Доступно с PHP 5.1
date_default_timezone_set('UTC'); date_default_timezone_set('UTC');
@ -494,7 +493,7 @@ $today = date("Y-m-d H:i:s"); // 2001-03-10 17:16:18 (форм
</note> </note>
<tip> <tip>
<para> <para>
Начиная с версии PHP 5.1, временную метку начала запроса Начиная с PHP 5.1, временную метку начала запроса
можно получить из поля <varname>$_SERVER['REQUEST_TIME']</varname>. можно получить из поля <varname>$_SERVER['REQUEST_TIME']</varname>.
</para> </para>
</tip> </tip>

4
reference/datetime/functions/idate.xml
View File

@ -43,7 +43,7 @@
<tgroup cols="2"> <tgroup cols="2">
<thead> <thead>
<row> <row>
<entry><parameter>format</parameter> символ</entry> <entry>символ в <parameter>format</parameter></entry>
<entry>Описание</entry> <entry>Описание</entry>
</row> </row>
</thead> </thead>
@ -70,7 +70,7 @@
</row> </row>
<row> <row>
<entry><literal>I</literal> (i в верхнем регистре)</entry> <entry><literal>I</literal> (i в верхнем регистре)</entry>
<entry>возвращает <literal>1</literal> если активировано DST, или <entry>возвращает <literal>1</literal>, если активировано DST, или
<literal>0</literal> в противном случае</entry> <literal>0</literal> в противном случае</entry>
</row> </row>
<row> <row>

8
reference/datetime/functions/mktime.xml
View File

@ -23,7 +23,7 @@
<para> <para>
Функция возвращает метку времени Unix, соответствующую дате и времени, переданных в Функция возвращает метку времени Unix, соответствующую дате и времени, переданных в
качестве аргументов. Метка времени - это целое число, равное разнице в секундах между заданной качестве аргументов. Метка времени - это целое число, равное разнице в секундах между заданной
датой/временем и началом эпохи Unix (The Unix Epoch, 1 января 1970 00:00:00 GMT). датой/временем и началом эпохи Unix (1 января 1970 00:00:00 GMT).
</para> </para>
<para> <para>
Аргументы могут быть опущены в порядке справа налево. В этом случае их значения по Аргументы могут быть опущены в порядке справа налево. В этом случае их значения по
@ -87,7 +87,7 @@
Количество месяцев, прошедших с конца предыдущего года. Количество месяцев, прошедших с конца предыдущего года.
Значения от 1 до 12 определяют нормальные обычные календарные месяцы года. Значения от 1 до 12 определяют нормальные обычные календарные месяцы года.
Значения меньше 1 (включая отрицательные значения) определяют месяца предыдущего Значения меньше 1 (включая отрицательные значения) определяют месяца предыдущего
года в обратном порядке, т.е. 0 будет декабрем, -1 - ноябрем и т.д. года в обратном порядке, то есть 0 будет декабрем, -1 - ноябрем и т.д.
Значения больше 12 определяют соответствующий месяц в следующем году (или годах). Значения больше 12 определяют соответствующий месяц в следующем году (или годах).
</para> </para>
</listitem> </listitem>
@ -159,7 +159,7 @@
<para> <para>
<function>mktime</function> возвращает временную метку Unix в <function>mktime</function> возвращает временную метку Unix в
соответствии с переданными аргументами. соответствии с переданными аргументами.
Если были переданы некорректными аргументы, функция вернет &false; (до версии PHP 5.1 Если были переданы некорректными аргументы, функция вернет &false; (до PHP 5.1
возвращалась <literal>-1</literal>). возвращалась <literal>-1</literal>).
</para> </para>
</refsect1> </refsect1>
@ -231,7 +231,7 @@
<programlisting role="php"> <programlisting role="php">
<![CDATA[ <![CDATA[
<?php <?php
// Устанавливаем используемую по умолчанию временную зону. Доступно, начиная с версии PHP 5.1 // Устанавливаем используемую по умолчанию временную зону. Доступно с PHP 5.1
date_default_timezone_set('UTC'); date_default_timezone_set('UTC');
// Выводит: July 1, 2000 is on a Saturday // Выводит: July 1, 2000 is on a Saturday

12
reference/datetime/functions/strftime.xml
View File

@ -218,12 +218,12 @@
</row> </row>
<row> <row>
<entry><literal>%r</literal></entry> <entry><literal>%r</literal></entry>
<entry>Тоже что и "%I:%M:%S %p"</entry> <entry>То же что и "%I:%M:%S %p"</entry>
<entry>Пример: <literal>09:34:17 PM</literal> для 21:34:17</entry> <entry>Пример: <literal>09:34:17 PM</literal> для 21:34:17</entry>
</row> </row>
<row> <row>
<entry><literal>%R</literal></entry> <entry><literal>%R</literal></entry>
<entry>Тоже что и "%H:%M"</entry> <entry>То же что и "%H:%M"</entry>
<entry>Пример: <literal>00:35</literal> для 12:35 AM, <literal>16:44</literal> для 4:44 PM</entry> <entry>Пример: <literal>00:35</literal> для 12:35 AM, <literal>16:44</literal> для 4:44 PM</entry>
</row> </row>
<row> <row>
@ -233,7 +233,7 @@
</row> </row>
<row> <row>
<entry><literal>%T</literal></entry> <entry><literal>%T</literal></entry>
<entry>Тоже что и "%H:%M:%S"</entry> <entry>То же что и "%H:%M:%S"</entry>
<entry>Пример: <literal>21:34:17</literal> для 09:34:17 PM</entry> <entry>Пример: <literal>21:34:17</literal> для 09:34:17 PM</entry>
</row> </row>
<row> <row>
@ -264,17 +264,17 @@
</row> </row>
<row> <row>
<entry><literal>%D</literal></entry> <entry><literal>%D</literal></entry>
<entry>Тоже что и "%m/%d/%y"</entry> <entry>То же что и "%m/%d/%y"</entry>
<entry>Пример: <literal>02/05/09</literal> для 5 февраля 2009</entry> <entry>Пример: <literal>02/05/09</literal> для 5 февраля 2009</entry>
</row> </row>
<row> <row>
<entry><literal>%F</literal></entry> <entry><literal>%F</literal></entry>
<entry>Тоже что и "%Y-%m-%d" (обычно используется в метках времени баз данных)</entry> <entry>То же что и "%Y-%m-%d" (обычно используется в метках времени баз данных)</entry>
<entry>Пример: <literal>2009-02-05</literal> для 5 февраля 2009</entry> <entry>Пример: <literal>2009-02-05</literal> для 5 февраля 2009</entry>
</row> </row>
<row> <row>
<entry><literal>%s</literal></entry> <entry><literal>%s</literal></entry>
<entry>Метка времени Эпохи Unix (тоже что и функция <function>time</function>)</entry> <entry>Метка времени Эпохи Unix (то же что и функция <function>time</function>)</entry>
<entry>Пример: <literal>305815200</literal> для 10 сентября 1979 08:40:00</entry> <entry>Пример: <literal>305815200</literal> для 10 сентября 1979 08:40:00</entry>
</row> </row>
<row> <row>

8
reference/datetime/functions/strtotime.xml
View File

@ -84,7 +84,7 @@
<row> <row>
<entry>5.3.0</entry> <entry>5.3.0</entry>
<entry> <entry>
До PHP 5.3.0, относительные форматы времени, заданные в аргументе До PHP 5.3.0 относительные форматы времени, заданные в аргументе
<parameter>time</parameter> функции <function>strtotime</function>, <parameter>time</parameter> функции <function>strtotime</function>,
такие как <literal>this week</literal>, <literal>previous week</literal>, такие как <literal>this week</literal>, <literal>previous week</literal>,
<literal>last week</literal> и <literal>next week</literal>, интерпретировались как <literal>last week</literal> и <literal>next week</literal>, интерпретировались как
@ -95,7 +95,7 @@
<row> <row>
<entry>5.3.0</entry> <entry>5.3.0</entry>
<entry> <entry>
До версии PHP 5.3.0 <literal>24:00</literal> не являлся корректным До PHP 5.3.0 <literal>24:00</literal> не являлся корректным
форматом, и при его использовании <function>strtotime</function> возвращала &false;. форматом, и при его использовании <function>strtotime</function> возвращала &false;.
</entry> </entry>
</row> </row>
@ -120,7 +120,7 @@
<row> <row>
<entry>5.0.2</entry> <entry>5.0.2</entry>
<entry> <entry>
В PHP 5 до версии 5.0.2 <literal>"now"</literal> и другие В PHP до версии 5.0.2 <literal>"now"</literal> и другие
относительные времена вычислялись неверно относительно относительные времена вычислялись неверно относительно
полуночи текущего дня. Это отличается от поведения текущих полуночи текущего дня. Это отличается от поведения текущих
версий, где вычисление производится корректно относительно версий, где вычисление производится корректно относительно
@ -168,7 +168,7 @@ echo strtotime("last Monday"), "\n";
<?php <?php
$str = 'Not Good'; $str = 'Not Good';
// до версии PHP 5.1.0 вместо false необходимо было сравнивать со значением -1 // до PHP 5.1.0 вместо false необходимо было сравнивать со значением -1
if (($timestamp = strtotime($str)) === false) { if (($timestamp = strtotime($str)) === false) {
echo "Строка ($str) недопустима"; echo "Строка ($str) недопустима";
} else { } else {

4
reference/datetime/functions/time.xml
View File

@ -15,8 +15,8 @@
<void/> <void/>
</methodsynopsis> </methodsynopsis>
<para> <para>
Возвращает количество секунд, прошедших с начала эпохи Unix (The Unix Возвращает количество секунд, прошедших с начала эпохи Unix
Epoch, 1 января 1970 00:00:00 GMT) до текущего времени. (1 января 1970 00:00:00 GMT) до текущего времени.
</para> </para>
</refsect1> </refsect1>