From dac6ae9f90b0a0a6b6959b99b4274931ecc3be5f Mon Sep 17 00:00:00 2001 From: lacatoire Date: Wed, 2 Sep 2026 10:03:20 +0200 Subject: [PATCH 1/2] sync: correct offset semantics in localtime, parse, parseToCalendar --- reference/intl/dateformatter/localtime.xml | 53 ++++++++++--------- reference/intl/dateformatter/parse.xml | 26 ++++----- .../intl/dateformatter/parsetocalendar.xml | 14 ++--- 3 files changed, 48 insertions(+), 45 deletions(-) diff --git a/reference/intl/dateformatter/localtime.xml b/reference/intl/dateformatter/localtime.xml index 163d6ad075..6068e18da5 100644 --- a/reference/intl/dateformatter/localtime.xml +++ b/reference/intl/dateformatter/localtime.xml @@ -1,6 +1,5 @@ - - + IntlDateFormatter::localtime @@ -26,11 +25,11 @@ stringstring intoffset&null; - - 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. - + + Convierte string en una fecha descompuesta (un &array; + de campos), comenzando en offset y consumiendo tantos + caracteres de la cadena de entrada como sea posible. + @@ -40,30 +39,31 @@ formatter - - El recurso de formateador IntlDateFormatter. - + + El objeto IntlDateFormatter. + string - - La cadena a convertir. - + + La cadena a convertir en un tiempo. + offset - - 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 > strlen($value), el análisis falla inmediatamente. - + + La posición desde la cual comenzar el análisis en string + (base-0). + Al regresar, offset contiene la posición en la que + terminó el análisis, independientemente de si el análisis tuvo éxito o no. + Si offset es negativo o mayor que + strlen($string), el análisis falla inmediatamente y + offset queda sin cambios. + @@ -72,10 +72,13 @@ &reftitle.returnvalues; - - Un array de enteros compatible con localtime: contiene la hora - en formato de 24 horas en el campo tm_hour, &return.falseforfailure;. - + + Un array asociativo de enteros cuyas claves son las de + localtime, con la hora en formato de 24 horas en + tm_hour&return.falseforfailure;. + Nótese que tm_yday es base-1 aquí, mientras que + localtime lo devuelve base-0. + diff --git a/reference/intl/dateformatter/parse.xml b/reference/intl/dateformatter/parse.xml index 0ddccc9a3d..3ac0fb7d95 100644 --- a/reference/intl/dateformatter/parse.xml +++ b/reference/intl/dateformatter/parse.xml @@ -1,6 +1,5 @@ - - + IntlDateFormatter::parse @@ -39,9 +38,9 @@ formatter - - El recurso de formateador IntlDateFormatter. - + + El objeto IntlDateFormatter. + @@ -55,14 +54,15 @@ offset - - La posición desde la cual comenzar el análisis en el valor string. - Las posiciones comienzan en 0. Si no ocurre ningún error durante el análisis - de string, offset 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 offset > strlen($string), el análisis falla inmediatamente. - + + La posición desde la cual comenzar el análisis en string + (base-0). + Al regresar, offset contiene la posición en la que + terminó el análisis, independientemente de si el análisis tuvo éxito o no. + Si offset es negativo o mayor que + strlen($string), el análisis falla inmediatamente y + offset queda sin cambios. + diff --git a/reference/intl/dateformatter/parsetocalendar.xml b/reference/intl/dateformatter/parsetocalendar.xml index 8dfa377c06..e48dd70d65 100644 --- a/reference/intl/dateformatter/parsetocalendar.xml +++ b/reference/intl/dateformatter/parsetocalendar.xml @@ -1,5 +1,5 @@ - + IntlDateFormatter::parseToCalendar @@ -38,12 +38,12 @@ offset - Posición en la que comenzar el análisis en string (basada en cero). - Si no ocurre ningún error antes de que string sea consumida, - offset 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 offset > strlen($string), el análisis falla inmediatamente. + Posición en la que comenzar el análisis en string (base-0). + Al regresar, offset contiene la posición en la que + terminó el análisis, independientemente de si el análisis tuvo éxito o no. + Si offset es mayor que + strlen($string), el análisis falla inmediatamente y + offset queda sin cambios. From 23b8733da0917b0f1e073b1a04a9d511b0a2a044 Mon Sep 17 00:00:00 2001 From: Louis-Arnaud Date: Thu, 3 Sep 2026 14:24:24 +0200 Subject: [PATCH 2/2] intl: apply the doc-es glossary to the offset semantics wording --- reference/intl/dateformatter/localtime.xml | 10 +++++----- reference/intl/dateformatter/parse.xml | 2 +- reference/intl/dateformatter/parsetocalendar.xml | 2 +- 3 files changed, 7 insertions(+), 7 deletions(-) diff --git a/reference/intl/dateformatter/localtime.xml b/reference/intl/dateformatter/localtime.xml index 6068e18da5..e2be5cb1e3 100644 --- a/reference/intl/dateformatter/localtime.xml +++ b/reference/intl/dateformatter/localtime.xml @@ -28,7 +28,7 @@ Convierte string en una fecha descompuesta (un &array; de campos), comenzando en offset y consumiendo tantos - caracteres de la cadena de entrada como sea posible. + caracteres del string de entrada como sea posible. @@ -48,7 +48,7 @@ string - La cadena a convertir en un tiempo. + El string a convertir en un tiempo. @@ -57,7 +57,7 @@ La posición desde la cual comenzar el análisis en string - (base-0). + (basada en cero). Al regresar, offset contiene la posición en la que terminó el análisis, independientemente de si el análisis tuvo éxito o no. Si offset es negativo o mayor que @@ -76,8 +76,8 @@ Un array asociativo de enteros cuyas claves son las de localtime, con la hora en formato de 24 horas en tm_hour&return.falseforfailure;. - Nótese que tm_yday es base-1 aquí, mientras que - localtime lo devuelve base-0. + Nótese que tm_yday empieza en 1 aquí, mientras que + localtime lo devuelve empezando en 0. diff --git a/reference/intl/dateformatter/parse.xml b/reference/intl/dateformatter/parse.xml index 3ac0fb7d95..deb546dd0e 100644 --- a/reference/intl/dateformatter/parse.xml +++ b/reference/intl/dateformatter/parse.xml @@ -56,7 +56,7 @@ La posición desde la cual comenzar el análisis en string - (base-0). + (basada en cero). Al regresar, offset contiene la posición en la que terminó el análisis, independientemente de si el análisis tuvo éxito o no. Si offset es negativo o mayor que diff --git a/reference/intl/dateformatter/parsetocalendar.xml b/reference/intl/dateformatter/parsetocalendar.xml index e48dd70d65..dc33b65b4e 100644 --- a/reference/intl/dateformatter/parsetocalendar.xml +++ b/reference/intl/dateformatter/parsetocalendar.xml @@ -38,7 +38,7 @@ offset - Posición en la que comenzar el análisis en string (base-0). + Posición en la que comenzar el análisis en string (basada en cero). Al regresar, offset contiene la posición en la que terminó el análisis, independientemente de si el análisis tuvo éxito o no. Si offset es mayor que