Skip to content

[Sync-En] localtime, parse, parseToCalendar: correct the offset semantics (#4820) #1227

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
lacatoire wants to merge 1 commit into
base: master
Choose a base branch
from
+48 −45
Open

[Sync-En] localtime, parse, parseToCalendar: correct the offset semantics (#4820) #1227

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
53 changes: 28 additions & 25 deletions reference/intl/dateformatter/localtime.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8ddf539e5993e427cb1385c5a01b6d2ce971b418 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<!-- EN-Revision: 8871302d240f124f7e9dabac85862e31bf97b442 Maintainer: PhilDaiguille Status: ready -->
<refentry xml:id="intldateformatter.localtime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>IntlDateFormatter::localtime</refname>
Expand All @@ -26,11 +25,11 @@
<methodparam><type>string</type><parameter>string</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter role="reference">offset</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Convierte la cadena $value en una fecha descompuesta (un &array; de
campos), comenzando en la posición $parse_pos y consumiendo tantos
caracteres como sea posible.
</para>
<simpara>
Convierte <parameter>string</parameter> en una fecha descompuesta (un &array;
de campos), comenzando en <parameter>offset</parameter> y consumiendo tantos
caracteres de la cadena de entrada como sea posible.
</simpara>
</refsect1>

<refsect1 role="parameters">
Expand All @@ -40,30 +39,31 @@
<varlistentry>
<term><parameter>formatter</parameter></term>
<listitem>
<para>
El recurso de formateador <classname>IntlDateFormatter</classname>.
</para>
<simpara>
El objeto <classname>IntlDateFormatter</classname>.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>string</parameter></term>
<listitem>
<para>
La cadena a convertir.
</para>
<simpara>
La cadena a convertir en un tiempo.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>offset</parameter></term>
<listitem>
<para>
La posición desde la cual comenzar el análisis en el valor $value.
Las posiciones comienzan en 0. Si no ocurre ningún error durante el análisis
de $value, $parse_pos contendrá -1, y de lo contrario, contendrá la posición en la cual
terminó el análisis (y ocurrió el error). Esta variable contendrá
la posición de fin si el análisis falla.
Si $parse_pos &gt; strlen($value), el análisis falla inmediatamente.
</para>
<simpara>
La posición desde la cual comenzar el análisis en <parameter>string</parameter>
(base-0).
Al regresar, <parameter>offset</parameter> contiene la posición en la que
terminó el análisis, independientemente de si el análisis tuvo éxito o no.
Si <parameter>offset</parameter> es negativo o mayor que
<literal>strlen($string)</literal>, el análisis falla inmediatamente y
<parameter>offset</parameter> queda sin cambios.
</simpara>
</listitem>
</varlistentry>
</variablelist>
Expand All @@ -72,10 +72,13 @@

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Un array de enteros compatible con localtime: contiene la hora
en formato de 24 horas en el campo tm_hour, &return.falseforfailure;.
</para>
<simpara>
Un array asociativo de enteros cuyas claves son las de
<function>localtime</function>, con la hora en formato de 24 horas en
<literal>tm_hour</literal>&return.falseforfailure;.
Nótese que <literal>tm_yday</literal> es base-1 aquí, mientras que
<function>localtime</function> lo devuelve base-0.
</simpara>
</refsect1>

<refsect1 role="examples">
Expand Down
26 changes: 13 additions & 13 deletions reference/intl/dateformatter/parse.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1976eae0d815797af97a1e16c5cd90ffc2868395 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<!-- EN-Revision: 8871302d240f124f7e9dabac85862e31bf97b442 Maintainer: PhilDaiguille Status: ready -->
<refentry xml:id="intldateformatter.parse" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>IntlDateFormatter::parse</refname>
Expand Down Expand Up @@ -39,9 +38,9 @@
<varlistentry>
<term><parameter>formatter</parameter></term>
<listitem>
<para>
El recurso de formateador <classname>IntlDateFormatter</classname>.
</para>
<simpara>
El objeto <classname>IntlDateFormatter</classname>.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
Expand All @@ -55,14 +54,15 @@
<varlistentry>
<term><parameter>offset</parameter></term>
<listitem>
<para>
La posición desde la cual comenzar el análisis en el valor <parameter>string</parameter>.
Las posiciones comienzan en 0. Si no ocurre ningún error durante el análisis
de <parameter>string</parameter>, <parameter>offset</parameter> contendrá -1, y de lo contrario, contendrá la posición en la cual
el análisis terminó (y el error ocurrió). Esta variable contendrá
la posición de fin si el análisis falla.
Si <parameter>offset</parameter> &gt; <code>strlen($string)</code>, el análisis falla inmediatamente.
</para>
<simpara>
La posición desde la cual comenzar el análisis en <parameter>string</parameter>
(base-0).
Al regresar, <parameter>offset</parameter> contiene la posición en la que
terminó el análisis, independientemente de si el análisis tuvo éxito o no.
Si <parameter>offset</parameter> es negativo o mayor que
<literal>strlen($string)</literal>, el análisis falla inmediatamente y
<parameter>offset</parameter> queda sin cambios.
</simpara>
</listitem>
</varlistentry>
</variablelist>
Expand Down
14 changes: 7 additions & 7 deletions reference/intl/dateformatter/parsetocalendar.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 20687bf9c58232244e41272d118b98ef4af16a69 Maintainer: lacatoire Status: ready -->
<!-- EN-Revision: 8871302d240f124f7e9dabac85862e31bf97b442 Maintainer: lacatoire Status: ready -->
<refentry xml:id="intldateformatter.parsetocalendar" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>IntlDateFormatter::parseToCalendar</refname>
Expand Down Expand Up @@ -38,12 +38,12 @@
<term><parameter>offset</parameter></term>
<listitem>
<simpara>
Posición en la que comenzar el análisis en <parameter>string</parameter> (basada en cero).
Si no ocurre ningún error antes de que <parameter>string</parameter> sea consumida,
<parameter>offset</parameter> contendrá -1; de lo contrario contendrá la posición
en la que el análisis terminó (y se produjo el error).
Esta variable contendrá la posición final si el análisis falla.
Si <parameter>offset</parameter> &gt; <code>strlen($string)</code>, el análisis falla inmediatamente.
Posición en la que comenzar el análisis en <parameter>string</parameter> (base-0).
Al regresar, <parameter>offset</parameter> contiene la posición en la que
terminó el análisis, independientemente de si el análisis tuvo éxito o no.
Si <parameter>offset</parameter> es mayor que
<literal>strlen($string)</literal>, el análisis falla inmediatamente y
<parameter>offset</parameter> queda sin cambios.
</simpara>
</listitem>
</varlistentry>
Expand Down