diff --git a/reference/datetime/formats.xml b/reference/datetime/formats.xml index 3ffa49992..d419791fd 100644 --- a/reference/datetime/formats.xml +++ b/reference/datetime/formats.xml @@ -1,10 +1,10 @@ - + Formatos soportados de tiempo y fechas - + Esta sección describe, en un formato de tipo BNF, todos los formatos diferentes que el analizador de DateTimeImmutable, DateTime, date_create_immutable, @@ -14,16 +14,16 @@ En la mayoría de los casos, los formatos de secciones diferentes, separados por caracteres de espacio en blanco, comas o puntos, pueden ser utilizados en la misma cadena fecha/hora. Para cada formato soportado, se dan uno o varios ejemplos así como una descripción del formato correspondiente. Los caracteres entre comillas simples para los formatos son insensibles a la mayúscula/minúscula ('t' podría escribirse t o T), los caracteres escritos entre comillas dobles, ellos, son sensibles a la mayúscula/minúscula ("T" y solo T). - - + + Para formatear objetos DateTimeImmutable y DateTime, por favor refiérase a la documentación del método DateTimeInterface::format. - + - + Un conjunto de reglas generales debería ser tenido en cuenta. - + @@ -87,7 +87,7 @@ var_dump($res["warnings"]); + [11]=> string(27) "The parsed date was invalid" } ]]> @@ -130,18 +130,18 @@ object(DateTimeImmutable)#1 (3) { Formatos para los tiempos (Time) - + Esta página describe los diferentes formatos en una sintaxis de tipo BNF que los analizadores de DateTimeImmutable, DateTime, date_create, date_create_immutable, y strtotime comprenden. - - + + Para formatear objetos DateTimeImmutable y DateTime, por favor refiérase a la documentación del método DateTimeInterface::format. - + Símbolos utilizados @@ -288,24 +288,22 @@ object(DateTimeImmutable)#1 (3) {
- - Formatos de fechas - + Esta página describe los diferentes formatos en una sintaxis de tipo BNF que los analizadores de DateTimeImmutable, DateTime, date_create, date_create_immutable, y strtotime comprenden. - - + + Para formatear objetos DateTimeImmutable y DateTime, por favor refiérase a la documentación del método DateTimeInterface::format. - + Símbolos utilizados @@ -382,72 +380,6 @@ object(DateTimeImmutable)#1 (3) {
- - Formatos estándar - - - - &Description; - Ejemplos - - - - - ATOM - "2022-06-02T16:58:35+00:00" - - - COOKIE - "Thursday, 02-Jun-2022 16:58:35 UTC" - - - ISO8601 - "2022-06-02T16:58:35+0000" - - - RFC 822 - "Thu, 02 Jun 22 16:58:35 +0000" - - - RFC 850 - "Thursday, 02-Jun-22 16:58:35 UTC" - - - RFC 1036 - "Thu, 02 Jun 22 16:58:35 +0000" - - - RFC 1123 - "Thu, 02 Jun 2022 16:58:35 +0000" - - - RFC 2822 - "Thu, 02 Jun 2022 16:58:35 +0000" - - - RFC 3339 - "2022-06-02T16:58:35+00:00" - - - RFC 3339 Extended - "2022-06-02T16:58:35.698+00:00" - - - RFC 7231 - "Thu, 02 Jun 2022 16:58:35 GMT" - - - RSS - "Thu, 02 Jun 2022 16:58:35 +0000" - - - W3C - "2022-06-02T16:58:35+00:00" - - - -
- Notaciones localizadas @@ -594,7 +526,7 @@ object(DateTimeImmutable)#1 (3) {
- + Para los formatos y y yy, los años antes de 100 son considerados de una manera especial cuando los símbolos y o yy son utilizados. @@ -602,79 +534,77 @@ object(DateTimeImmutable)#1 (3) { 2000 será añadido. Si el año está entre 70 (inclusivo) y 99 (inclusivo) entonces 1900 será añadido. Esto significa que "00-01-01" es interpretado como "2000-01-01". - + - + El formato "Día, mes y año de dos dígitos con tabulaciones o puntos" (dd [.\t] mm "." yy) solo funciona para valores de año de 61 (inclusivo) a 99 (inclusivo) - fuera de estos límites, el formato de tiempo "HH [.:] MM [.:] SS" tiene una precedencia más fuerte y prima. - + - + El formato "Año (y solo el año)" solo funciona de manera fiable si una cadena de tiempo ya ha sido encontrada. De lo contrario, si el año de cuatro dígitos coincide con HH MM, estos dos elementos de fecha son definidos en su lugar. - - + + Para analizar de manera coherente solo un año, utilice DateTimeImmutable::createFromFormat con el especificador Y. - + - + Es posible añadir o restar un préstamo para los formatos dd y DD. El día 0 significa el último día del mes anterior, los préstamos positivos contarán el mes siguiente. Así, "2008-08-00" es equivalente a "2008-07-31" y "2008-06-31" es equivalente a "2008-07-01" (junio solo tiene 30 días). - - + + Es de notar que el rango de día está limitado a 0-31 como indicado por la expresión regular anterior. Así, "2008-06-32" no es una cadena de fecha válida, por ejemplo. - - + + También es posible jugar con los préstamos de los formatos mm y MM gracias al valor 0. Un valor de mes de 0 significa Diciembre del año anterior. Por ejemplo "2008-00-22" es equivalente a "2007-12-22". - - + + Si combina las dos nociones anteriores y utiliza un préstamo negativo en el día y el mes, entonces ocurre esto: "2008-00-00" es convertido primero hacia "2007-12-00" luego hacia "2007-11-30". Esto también ocurre con la cadena "0000-00-00" que es entonces transformada hacia "-0001-11-30" (el año -1 en el calendario ISO 8601, que es 2 BC en el calendario Gregoriano). - +
- - Formatos compuestos - + Esta página describe los diferentes formatos en una sintaxis de tipo BNF que los analizadores de DateTimeImmutable, DateTime, date_create, date_create_immutable, y strtotime comprenden. - - + + Para formatear objetos DateTimeImmutable y DateTime, por favor refiérase a la documentación del método DateTimeInterface::format. - + Símbolos utilizados @@ -687,6 +617,16 @@ object(DateTimeImmutable)#1 (3) { + + daysuf + "st" | "nd" | "rd" | "th" + + + + dd + ([0-2]?[0-9] | "3"[01]) daysuf? + "7th", "22nd", "31" + DD "0" [0-9] | [1-2][0-9] | "3" [01] @@ -704,8 +644,8 @@ object(DateTimeImmutable)#1 (3) { hh - "0"?[1-9] | "1"[0-2] - "04", "7", "12" + [01]?[0-9] | "2"[0-4] + "04", "9", "19" HH @@ -732,6 +672,11 @@ object(DateTimeImmutable)#1 (3) { 'jan' | 'feb' | 'mar' | 'apr' | 'may' | 'jun' | 'jul' | 'aug' | 'sep' | 'sept' | 'oct' | 'nov' | 'dec' + + mm + "0"? [0-9] | "1"[0-2] + "0", "04", "7", "12" + MM [0-1][0-9] @@ -771,6 +716,72 @@ object(DateTimeImmutable)#1 (3) {
+ + Formatos estándar + + + + &Description; + Ejemplos + + + + + ATOM + "2022-06-02T16:58:35+00:00" + + + COOKIE + "Thursday, 02-Jun-2022 16:58:35 UTC" + + + ISO8601 + "2022-06-02T16:58:35+0000" + + + RFC 822 + "Thu, 02 Jun 22 16:58:35 +0000" + + + RFC 850 + "Thursday, 02-Jun-22 16:58:35 UTC" + + + RFC 1036 + "Thu, 02 Jun 22 16:58:35 +0000" + + + RFC 1123 + "Thu, 02 Jun 2022 16:58:35 +0000" + + + RFC 2822 + "Thu, 02 Jun 2022 16:58:35 +0000" + + + RFC 3339 + "2022-06-02T16:58:35+00:00" + + + RFC 3339 Extended + "2022-06-02T16:58:35.698+00:00" + + + RFC 7231 + "Thu, 02 Jun 2022 16:58:35 GMT" + + + RSS + "Thu, 02 Jun 2022 16:58:35 +0000" + + + W3C + "2022-06-02T16:58:35+00:00" + + + +
+ Notaciones localizadas @@ -784,7 +795,7 @@ object(DateTimeImmutable)#1 (3) { Formato de log común - dd "/" M "/" YY : HH ":" II ":" SS espacio tzcorrection + dd "/" M "/" YY ":" HH ":" II ":" SS espacio tzcorrection "10/Oct/2000:13:55:36 -0700" @@ -847,37 +858,35 @@ object(DateTimeImmutable)#1 (3) {
- + El "W" en los formatos "Año ISO con semana ISO" y "Año ISO con semana ISO y día" es sensible a la mayúscula/minúscula; solo puede utilizarse la mayúscula "W". - - + + El "T" en los formatos SOAP, XMRPC y WDDX es sensible a la mayúscula/minúscula; utilice siempre la mayúscula "T". - - + + El formato timestamp Unix define la zona horaria a UTC. - +
- - Formatos relativos - + Esta página describe los diferentes formatos en una sintaxis de tipo BNF que los analizadores de DateTimeImmutable, DateTime, date_create, date_create_immutable, y strtotime comprenden. - - + + Para formatear objetos DateTimeImmutable y DateTime, por favor refiérase a la documentación del método DateTimeInterface::format. - + Símbolos utilizados @@ -1036,26 +1045,26 @@ object(DateTimeImmutable)#1 (3) {
- + Las expresiones relativas son siempre tratadas después de las expresiones no relativas. Esto hace que "+1 week july 2008" y "july 2008 +1 week" sean equivalentes. - - + + "yesterday", "midnight", "today", "noon" y "tomorrow" son excepciones a esta regla. Note que "tomorrow 11:00" y "11:00 tomorrow" son diferentes. Si la fecha de hoy es "July 23rd, 2008", la primera expresión da "2008-07-24 11:00" mientras que la segunda dará "2008-07-24 00:00". La razón es que estas cinco expresiones influyen directamente en la fecha actual. - - + + Las palabras clave como "first day of" dependen del contexto en el cual la cadena de formato relativo es utilizada. Si se utiliza con un método estático o una función, el referente es el timestamp actual del sistema. Sin embargo, si se utiliza en DateTime::modify o DateTimeImmutable::modify, el referente es el objeto sobre el cual el método modify() es llamado. - + @@ -1114,12 +1123,12 @@ object(DateTimeImmutable)#1 (3) {
- + Note también que el "of" en "ordinal espacio dayname espacio 'of' " y "'last' espacio dayname espacio 'of' " hace algo especial. - + @@ -1160,21 +1169,21 @@ object(DateTimeImmutable)#1 (3) { - + Los valores relativos de los meses calculados se basan en el número de días de los meses que se utilizan. Por ejemplo, "+2 month 2011-11-30", dará como resultado la fecha "2012-01-30". Esto se debe a que el mes de noviembre tiene 30 días, y que el mes de diciembre tiene 31, lo que suma un total de 61 días. - + - + number es un número entero; si un número decimal es dado, el punto (o la coma) será probablemente interpretado como un delimitador. Por ejemplo, '+1.5 hours' será analizado como '+1 5 hours', y no como '+1 hour +30 minutes'. - + @@ -1217,7 +1226,6 @@ object(DateTimeImmutable)#1 (3) { -