Update datetime* to En

reference/datetime/book.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 71692b6f4cace8dca72a18ccd80d4cd7305e5d4e Maintainer: aur Status: ready -->
+<!-- EN-Revision: 3a8c3e77df070a046c9d5b56b68926ca2d7e5ee3 Maintainer: aur Status: ready -->
 <!-- Reviewed: no -->
-<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" annotations="interactive">
  <?phpdoc extension-membership="core"?>
  <title>Модуль работы с датой и временем</title>
  <titleabbrev>Дата и время</titleabbrev>

reference/datetime/dateinterval/construct.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 71692b6f4cace8dca72a18ccd80d4cd7305e5d4e Maintainer: aur Status: ready -->
+<!-- EN-Revision: 3a8c3e77df070a046c9d5b56b68926ca2d7e5ee3 Maintainer: aur Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="dateinterval.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -180,13 +180,13 @@ $someDate->add($interval);
 
 // Преобразовываем интервал в строку
 echo $interval->format("%d");
-
-?>
 ]]>
     </programlisting>
     &example.outputs;
     <screen role="php">
-     7
+<![CDATA[
+7
+]]>
     </screen>
    </example>
   </para>
@@ -199,8 +199,6 @@ echo $interval->format("%d");
 
 $interval = new DateInterval('P1W2D');
 var_dump($interval);
-
-?>
 ]]>
     </programlisting>
     &example.outputs.82;

reference/datetime/dateinterval/createfromdatestring.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 34f483426930c25870b4c5455157e7a759e0053c Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 3a8c3e77df070a046c9d5b56b68926ca2d7e5ee3 Maintainer: tmn Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="dateinterval.createfromdatestring" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -109,7 +109,7 @@
   <para>
    <example>
     <title>Пример разбора допустимых интервалов времени</title>
-    <programlisting role="php">
+    <programlisting role="php" annotations="non-interactive">
 <![CDATA[
 <?php
 
@@ -134,8 +134,6 @@ $i = DateInterval::createFromDateString('1 day + 12 hours');
 
 $i = new DateInterval('PT3600S');
 $i = DateInterval::createFromDateString('3600 seconds');
-
-?>
 ]]>
     </programlisting>
    </example>
@@ -153,14 +151,14 @@ echo $i->format('%d %h %i'), "\n";
 
 $i = DateInterval::createFromDateString('1 year - 10 days');
 echo $i->format('%y %d'), "\n";
-
-?>
 ]]>
     </programlisting>
     &example.outputs;
-    <screen role="shell">
-     449 2 70
-     1 -10
+    <screen>
+<![CDATA[
+449 2 70
+1 -10
+]]>
     </screen>
    </example>
   </para>
@@ -177,8 +175,6 @@ var_dump($i);
 
 $i = DateInterval::createFromDateString('last weekday');
 var_dump($i);
-
-?>
 ]]>
     </programlisting>
     &example.outputs.82;

reference/datetime/dateinterval/format.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 02ff7fef5b34cf8f5395180d9d39fb64d9398d00 Maintainer: aur Status: ready -->
+<!-- EN-Revision: 3a8c3e77df070a046c9d5b56b68926ca2d7e5ee3 Maintainer: aur Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="dateinterval.format" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -14,7 +14,7 @@
    <methodparam><type>string</type><parameter>format</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Форматирует интервал.
+   Метод форматирует интервал.
   </para>
  </refsect1>
 
@@ -186,8 +186,6 @@
 
 $interval = new DateInterval('P2Y4DT6H8M');
 echo $interval->format('%d days');
-
-?>
 ]]>
     </programlisting>
     &example.outputs;
@@ -207,8 +205,6 @@ echo $interval->format('%d days');
 
 $interval = new DateInterval('P32D');
 echo $interval->format('%d days');
-
-?>
 ]]>
     </programlisting>
     &example.outputs;
@@ -233,13 +229,11 @@ $january = new DateTime('2010-01-01');
 $february = new DateTime('2010-02-01');
 $interval = $february->diff($january);
 
-// %a выведет общее количество дней.
+// Модификатор %a выведет общее количество дней.
 echo $interval->format('%a total days')."\n";
 
-// В то время как %d выведет только число дней, не покрытых месяцем
+// В то время как модификатор %d выведет только количество дней, не покрытых месяцем
 echo $interval->format('%m month, %d days');
-
-?>
 ]]>
     </programlisting>
     &example.outputs;

reference/datetime/dateperiod.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 576c7c43febb2eec5718d8320f92606423413983 Maintainer: tmn Status: ready -->
+<!-- EN-Revision: 3a8c3e77df070a046c9d5b56b68926ca2d7e5ee3 Maintainer: tmn Status: ready -->
 <!-- Reviewed: no -->
 <reference xml:id="class.dateperiod" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
 
@@ -12,11 +12,12 @@
   <section xml:id="dateperiod.intro">
    &reftitle.intro;
    <para>
-    Представляет временной период.
+    Объекты класса представляют временной период.
    </para>
    <para>
-    Позволяет перемещаться в заданном временном интервале
-    на равные промежутки времени.
+    На основе объектов класса перебирают набор дат и времени
+    с повторением через равные временные интервалы
+    заданное количество раз или до заданной конечной даты.
    </para>
   </section>
   <!-- }}} -->
@@ -115,7 +116,10 @@
       <type>int</type>
      </term>
      <listitem>
-      <para>Исключает начальную дату, используется в <function>DatePeriod::__construct</function>.</para>
+      <para>
+       Константа исключает начальную дату из набора дат и времени для перебора,
+       передаётся в параметр опций метода <function>DatePeriod::__construct</function>.
+      </para>
      </listitem>
     </varlistentry>
 
@@ -125,7 +129,10 @@
       <type>int</type>
      </term>
      <listitem>
-      <para>Включает дату окончания, используется в <function>DatePeriod::__construct</function>.</para>
+      <para>
+       Константа включает конечную дату в набор дат и времени для перебора,
+       передаётся в параметр опций метода <function>DatePeriod::__construct</function>.
+      </para>
      </listitem>
     </varlistentry>
 
@@ -140,24 +147,24 @@
      <term><varname>recurrences</varname></term>
      <listitem>
       <para>
-       Минимальное количество экземпляров, возвращаемое итератором.
+       Минимальное количество экземпляров, которое верёт итератор.
       </para>
       <para>
-       Если количество повторений было явно передано с помощью параметра
-       <varname>recurrences</varname> в конструктор экземпляра <classname>DatePeriod</classname>,
-       то это свойство содержит это значение, <emphasis>плюс</emphasis> один,
-       если дата начала не была отключена
-       с помощью константы <constant>DatePeriod::EXCLUDE_START_DATE</constant>,
-       <emphasis>плюс</emphasis> один, если дата окончания была включена
-       с помощью константы <constant>DatePeriod::INCLUDE_END_DATE</constant>.
+       При передаче количества повторений через параметр
+       <varname>recurrences</varname> в конструктор экземпляра <classname>DatePeriod</classname>
+       свойство объекта содержит это значение, <emphasis>плюс</emphasis> один,
+       если начальную дату не отключили
+       константой <constant>DatePeriod::EXCLUDE_START_DATE</constant>,
+       <emphasis>плюс</emphasis> один, если конечную дату исключили
+       константой <constant>DatePeriod::INCLUDE_END_DATE</constant>.
       </para>
       <para>
-       Если количество повторений не было передано явно, то это свойство содержит
-       минимальное количество возвращённых экземпляров.
-       Это будет <literal>0</literal>, <emphasis>плюс</emphasis> один, если дата начала не отключена
-       с помощью константы <constant>DatePeriod::EXCLUDE_START_DATE</constant>,
-       <emphasis>плюс</emphasis> один, если дата окончания была включена
-       с помощью константы <constant>DatePeriod::INCLUDE_END_DATE</constant>.
+       При пропуске количества повторений свойство объекта содержит
+       минимальное количество возвращаемых экземпляров —
+       <literal>0</literal>, <emphasis>плюс</emphasis> один, если начальную дату не включили
+       константой <constant>DatePeriod::EXCLUDE_START_DATE</constant>,
+       <emphasis>плюс</emphasis> один, если конечную дату исключили
+       константой <constant>DatePeriod::INCLUDE_END_DATE</constant>.
       </para>
       <para>
        <informalexample>
@@ -170,7 +177,7 @@ $end   = new DateTime('2021-12-31 00:00:00');
 $interval = new DateInterval('P1M');
 $recurrences = 5;
 
-// Повторения явно задаются в конструкторе
+// Повторения устанавливаются через конструктор
 $period = new DatePeriod($start, $interval, $recurrences, DatePeriod::EXCLUDE_START_DATE);
 echo $period->recurrences, "\n";
 
@@ -186,17 +193,17 @@ echo $period->recurrences, "\n";
 
 $period = new DatePeriod($start, $interval, $end, DatePeriod::EXCLUDE_START_DATE);
 echo $period->recurrences, "\n";
-
-?>
 ]]>
         </programlisting>
         &example.outputs;
         <screen role="php">
+<![CDATA[
 5
 6
 7
 1
 0
+]]>
         </screen>
        </informalexample>
       </para>
@@ -233,7 +240,7 @@ echo $period->recurrences, "\n";
      <term><varname>current</varname></term>
      <listitem>
       <para>
-       В процессе итерации будет содержать текущую дату периода.
+       В процессе итерации содержит текущую дату периода.
       </para>
      </listitem>
     </varlistentry>
@@ -270,13 +277,13 @@ echo $period->recurrences, "\n";
       <row>
        <entry>8.4.0</entry>
        <entry>
-        Константы класса теперь типизированы.
+        Типизировали константы класса.
        </entry>
       </row>
       <row>
        <entry>8.2.0</entry>
        <entry>
-        Были добавлены константа <constant>DatePeriod::INCLUDE_END_DATE</constant>
+        Добавили константу <constant>DatePeriod::INCLUDE_END_DATE</constant>
         и свойство <property>include_end_date</property>.
        </entry>
       </row>
@@ -285,7 +292,7 @@ echo $period->recurrences, "\n";
        <entry>
         Класс <classname>DatePeriod</classname> теперь реализует
         интерфейс <interfacename>IteratorAggregate</interfacename>.
-        Ранее вместо этого был реализован интерфейс <interfacename>Traversable</interfacename>.
+        Раньше вместо этого класс реализовывал интерфейс <interfacename>Traversable</interfacename>.
        </entry>
       </row>
      </tbody>

reference/datetime/dateperiod/createfromiso8601string.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 0070ddc45d60b6eda095053847dba544aa4339bf Maintainer: sergey Status: ready -->
+<!-- EN-Revision: 3a8c3e77df070a046c9d5b56b68926ca2d7e5ee3 Maintainer: sergey Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="dateperiod.createfromiso8601string" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -15,8 +15,8 @@
    <methodparam choice="opt"><type>int</type><parameter>options</parameter><initializer>0</initializer></methodparam>
   </methodsynopsis>
   <para>
-   Создаёт новый объект DatePeriod из строки в формате стандарта ISO8601, как указано
-   в параметре <parameter>specification</parameter>.
+   Метод создаёт новый объект DatePeriod из строки в формате стандарта ISO8601,
+   как указывает описание параметра <parameter>specification</parameter>.
   </para>
  </refsect1>
 
@@ -31,7 +31,7 @@
       стандарта ISO 8601</link>.
      </para>
      <para>
-      Пример принимаемой спецификации интервала стандарта ISO 8601 — это строка
+      Пример принимаемой спецификации интервала стандарта ISO 8601 — строка
       <literal>R5/2008-03-01T13:00:00Z/P1Y2M10DT2H30M</literal>, которая
       указывает:
      </para>
@@ -97,20 +97,20 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Возвращает созданный объект DatePeriod.
+   Метод возвращает созданный объект DatePeriod.
   </para>
   <para>
-   С объектом, созданным этим методом <classname>DatePeriod</classname>, можно
-   работать как с итератором, чтобы создавать объекты
+   С объектом <classname>DatePeriod</classname>, который создаётся методом,
+   работают как с итератором для генерации объектов
    <classname>DateTimeImmutable</classname>.
   </para>
  </refsect1>
 
  <refsect1 role="errors">
   &reftitle.errors;
   <para>
-   Выбрасывает исключение <classname>DateMalformedPeriodStringException</classname>,
-   если значение параметра <parameter>specification</parameter> не может быть разобрано как допустимое значение периода
+   Метод выбрасывает исключение <classname>DateMalformedPeriodStringException</classname>,
+   если значение параметра <parameter>specification</parameter> невозможно разобрать как допустимое значение периода
    в формате стандарта ISO 8601.
   </para>
  </refsect1>
@@ -119,20 +119,19 @@
   &reftitle.examples;
   <para>
    <example>
-    <title>Пример использования метода DatePeriod::createFromISO8601String</title>
+    <title>Пример создания из строки в формате ISO8601 объекта периода времени методом DatePeriod::createFromISO8601String</title>
     <programlisting role="php">
 <![CDATA[
 <?php
-$iso = 'R4/2023-07-01T00:00:00Z/P7D';
 
+$iso = 'R4/2023-07-01T00:00:00Z/P7D';
 $period = DatePeriod::createFromISO8601String($iso);
 
-// При переборе объекта DatePeriod будут напечатаны
+// При переборе объекта DatePeriod выведутся
 // повторяющиеся в пределах периода даты.
 foreach ($period as $date) {
     echo $date->format('Y-m-d'), "\n";
 }
-?>
 ]]>
     </programlisting>
     &example.outputs;