From bed81762e6e307122ceeae88930f0a2b4208713a Mon Sep 17 00:00:00 2001
From: Sergey Panteleev <sergey@php.net>
Date: Mon, 6 Nov 2023 13:29:01 +0300
Subject: [PATCH] [PHP 8.3] IntlCalendar setDate / setDateTime

---
 reference/intl/intlcalendar/setdate.xml     |  99 +++++++++++++++
 reference/intl/intlcalendar/setdatetime.xml | 126 ++++++++++++++++++++
 2 files changed, 225 insertions(+)
 create mode 100644 reference/intl/intlcalendar/setdate.xml
 create mode 100644 reference/intl/intlcalendar/setdatetime.xml

diff --git a/reference/intl/intlcalendar/setdate.xml b/reference/intl/intlcalendar/setdate.xml
new file mode 100644
index 000000000000..e5b54370809d
--- /dev/null
+++ b/reference/intl/intlcalendar/setdate.xml
@@ -0,0 +1,99 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="intlcalendar.setdate" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>IntlCalendar::setDate</refname>
+  <refpurpose>Set a date fields</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis role="IntlCalendar">
+   <modifier>public</modifier> <type>void</type><methodname>IntlCalendar::setDate</methodname>
+   <methodparam><type>int</type><parameter>year</parameter></methodparam>
+   <methodparam><type>int</type><parameter>month</parameter></methodparam>
+   <methodparam><type>int</type><parameter>dayOfMonth</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Sets a date fields to the given value.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>year</parameter></term>
+    <listitem>
+     <para>
+      The new value for <constant>IntlCalendar::FIELD_YEAR</constant>.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>month</parameter></term>
+    <listitem>
+     <para>
+      The new value for <constant>IntlCalendar::FIELD_MONTH</constant>.
+      The month sequence is zero-based, i.e., January is represented by 0,
+      February by 1, …, December is 11 and Undecember (if the calendar has
+      it) is 12.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>dayOfMonth</parameter></term>
+    <listitem>
+     <para>
+      The new value for <constant>IntlCalendar::FIELD_DAY_OF_MONTH</constant>.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.void;
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+   <title><function>IntlCalendar::setDate</function> example</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$intlCal = IntlCalendar::createInstance('UTC');
+
+$intlCal->setDate(2012, 1, 29);
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/intl/intlcalendar/setdatetime.xml b/reference/intl/intlcalendar/setdatetime.xml
new file mode 100644
index 000000000000..9599e741362e
--- /dev/null
+++ b/reference/intl/intlcalendar/setdatetime.xml
@@ -0,0 +1,126 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="intlcalendar.setdatetime" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>IntlCalendar::setDateTime</refname>
+  <refpurpose>Set a date and time fields</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis role="IntlCalendar">
+   <modifier>public</modifier> <type>void</type><methodname>IntlCalendar::setDateTime</methodname>
+   <methodparam><type>int</type><parameter>year</parameter></methodparam>
+   <methodparam><type>int</type><parameter>month</parameter></methodparam>
+   <methodparam><type>int</type><parameter>dayOfMonth</parameter></methodparam>
+   <methodparam><type>int</type><parameter>hour</parameter></methodparam>
+   <methodparam><type>int</type><parameter>minute</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>second</parameter><initializer>&null;</initializer></methodparam>
+  </methodsynopsis>
+  <para>
+   Sets a date and time fields to the given value.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>year</parameter></term>
+    <listitem>
+     <para>
+      The new value for <constant>IntlCalendar::FIELD_YEAR</constant>.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>month</parameter></term>
+    <listitem>
+     <para>
+      The new value for <constant>IntlCalendar::FIELD_MONTH</constant>.
+      The month sequence is zero-based, i.e., January is represented by 0,
+      February by 1, …, December is 11 and Undecember (if the calendar has
+      it) is 12.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>dayOfMonth</parameter></term>
+    <listitem>
+     <para>
+      The new value for <constant>IntlCalendar::FIELD_DAY_OF_MONTH</constant>.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>hour</parameter></term>
+    <listitem>
+     <para>
+      The new value for <constant>IntlCalendar::FIELD_HOUR_OF_DAY</constant>.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>minute</parameter></term>
+    <listitem>
+     <para>
+      The new value for <constant>IntlCalendar::FIELD_MINUTE</constant>.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>second</parameter></term>
+    <listitem>
+     <para>
+      The new value for <constant>IntlCalendar::FIELD_SECOND</constant>.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.void;
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+   <title><function>IntlCalendar::setDateTime</function> example</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$intlCal = IntlCalendar::createInstance('UTC');
+
+$intlCal->setDateTime(2012, 1, 29, 23, 58);
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->