From dac6ae9f90b0a0a6b6959b99b4274931ecc3be5f Mon Sep 17 00:00:00 2001 From: lacatoire Date: Wed, 2 Sep 2026 10:03:20 +0200 Subject: [PATCH] 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.