Update to En set-calendar.xml

This commit is contained in:
Mikhail Alferov
2024-09-26 11:30:10 +03:00
committed by GitHub
parent 26ad279ebc
commit 2679b28d1f

View File

@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1976eae0d815797af97a1e16c5cd90ffc2868395 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 0545e305cf06937b14b3f0694d6e716c9881ffd7 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="intldateformatter.setcalendar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>IntlDateFormatter::setCalendar</refname>
<refname>datefmt_set_calendar</refname>
<refpurpose>Устанавливает тип календаря, используемый средством форматирования</refpurpose>
<refpurpose>Устанавливает тип календаря для средства форматирования</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
@ -25,7 +25,7 @@
<methodparam><type class="union"><type>IntlCalendar</type><type>int</type><type>null</type></type><parameter>calendar</parameter></methodparam>
</methodsynopsis>
<para>
Устанавливает тип календаря, используемый средством форматирования.
Метод устанавливает тип календаря с которым будет работать средство форматирования.
</para>
</refsect1>
@ -45,18 +45,20 @@
<term><parameter>calendar</parameter></term>
<listitem>
<para>
Может быть: <link linkend="intl.intldateformatter-constants.calendartypes">тип календаря</link> для использования
(по умолчанию <constant>IntlDateFormatter::GREGORIAN</constant>, который также используется, если указано значение &null;)
Параметр принимает константы
<link linkend="intl.intldateformatter-constants.calendartypes">типа календаря</link>
или объект <classname>IntlCalendar</classname>.
Метод использует календарь по умолчанию — <constant>IntlDateFormatter::GREGORIAN</constant>,
если указали значение &null;.
</para>
<para>
Любой переданный объект <classname>IntlCalendar</classname> будет клонирован;
в объект аргумента не будет внесено никаких изменений.
Метод клонирует объект <classname>IntlCalendar</classname>, который получит в аргументе;
сам объект аргумента не изменится.
</para>
<para>
Часовой пояс средства форматирования будет сохранён только в том случае,
если объект <classname>IntlCalendar</classname> не передан,
в противном случае новый часовой пояс будет таким же, как у переданного объекта.
Часовой пояс средства форматирования сохранится, только если
объект <classname>IntlCalendar</classname> не передали,
иначе новый часовой пояс будет таким же, как у объекта, который передали.
</para>
</listitem>
</varlistentry>
@ -85,9 +87,9 @@
</thead>
<tbody>
<row>
<entry>5.5.0/PECL 3.0.0</entry>
<entry>PECL-модуль intl 3.0.0</entry>
<entry>
Добавлена возможность передать объект <classname>IntlCalendar</classname>.
Теперь метод принимает объект <classname>IntlCalendar</classname>.
</entry>
</row>
</tbody>
@ -99,10 +101,11 @@
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Пример использования <function>datefmt_set_calendar</function></title>
<title>Пример установки типа календаря функцией <function>datefmt_set_calendar</function></title>
<programlisting role="php">
<![CDATA[
<?php
$fmt = datefmt_create(
'en_US',
IntlDateFormatter::FULL,
@ -110,18 +113,22 @@ $fmt = datefmt_create(
'America/Los_Angeles',
IntlDateFormatter::GREGORIAN
);
echo 'Тип календаря средства форматирования : ' . datefmt_get_calendar($fmt);
echo 'Тип календаря средства форматирования: ' . datefmt_get_calendar($fmt);
datefmt_set_calendar($fmt, IntlDateFormatter::TRADITIONAL);
echo 'Теперь тип календаря : ' . datefmt_get_calendar($fmt);
echo 'Теперь тип календаря: ' . datefmt_get_calendar($fmt);
?>
]]>
</programlisting>
</example>
<example>
<title>Пример использования в объектно-ориентированном стиле</title>
<title>Пример установки типа календаря в объектно-ориентированном стиле</title>
<programlisting role="php">
<![CDATA[
<?php
$fmt = new IntlDateFormatter(
'en_US',
IntlDateFormatter::FULL,
@ -129,9 +136,12 @@ $fmt = new IntlDateFormatter(
'America/Los_Angeles',
IntlDateFormatter::GREGORIAN
);
echo 'Тип календаря средства форматирования : ' . $fmt->getCalendar();
echo 'Тип календаря средства форматирования: ' . $fmt->getCalendar();
$fmt->setCalendar(IntlDateFormatter::TRADITIONAL);
echo 'Теперь тип календаря : ' . $fmt->getCalendar();
echo 'Теперь тип календаря: ' . $fmt->getCalendar();
?>
]]>
</programlisting>
@ -139,34 +149,40 @@ echo 'Теперь тип календаря : ' . $fmt->getCalendar();
&example.outputs;
<screen>
<![CDATA[
Тип календаря средства форматирования : 1
Теперь тип календаря : 0
Тип календаря средства форматирования: 1
Теперь тип календаря: 0
]]>
</screen>
<example>
<title>Пример использования <classname>IntlCalendar</classname> с параметром</title>
<title>Пример установки типа календаря через объект <classname>IntlCalendar</classname> в аргументе</title>
<programlisting role="php">
<![CDATA[
<?php
$time = strtotime("2013-03-03 00:00:00 UTC");
$formatter = IntlDateFormatter::create("en_US", NULL, NULL, "Europe/Amsterdam");
echo "До: ", $formatter->format($time), "\n";
/* обратите внимание, что языковой стандарт календаря не используется! */
$formatter->setCalendar(IntlCalendar::createInstance(
"America/New_York", "pt_PT@calendar=islamic"));
/* Обратите внимание: метод не учитывает языковой стандарт календаря! */
$formatter->setCalendar(
IntlCalendar::createInstance(
"America/New_York",
"pt_PT@calendar=islamic"
)
);
echo "После: ", $formatter->format($time), "\n";
echo "После: ", $formatter->format($time), "\n";
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
До: Sunday, March 3, 2013 at 1:00:00 AM Central European Standard Time
После: Saturday, Rabiʻ II 20, 1434 at 7:00:00 PM Eastern Standard Time
После: Saturday, Rabiʻ II 20, 1434 at 7:00:00 PM Eastern Standard Time
]]>
</screen>