¿Dónde lo encuentro?
Configuración > Canales de ventas > Tienda en línea (Escritorio) > Integración
¿Qué significa?
Existen diferentes formatos de fecha y hora que puede usar en su tienda web. Algunos de ellos son bien conocidos como dd-MM-yyyy, donde dd es el día, MM el mes y yyyy el año, pero hay algunas otras posibilidades permitidas. Aquí mostramos todos ellos.
¿Qué debo hacer?
Patrones
Los siguientes patrones pueden usarse en estas configuraciones detalladas de la tienda web:
Además de d, M y y, hay más símbolos permitidos para usar como parte de una fecha o hora. Aquí puede encontrar todos ellos y algunos ejemplos en la siguiente tabla:
| Símbolo | Significado | Presentación | Ejemplo |
|---|---|---|---|
G | designador de era | Texto | AD |
y | año | Número | 1996 |
L | mes independiente en el año | Texto o Número | July (or) 07 |
M | mes en el año | Texto o Número | July (or) 07 |
d | día en el mes | Número | 10 |
h | hora en am/pm (1-12) | Número | 12 |
H | hora en el día (0-23) | Número | 0 |
m | minuto en la hora | Número | 30 |
s | segundo en el minuto | Número | 55 |
S | segundo fraccional | Número | 978 |
E | día de la semana | Texto | Tuesday |
c | día independiente de la semana | Texto | Tuesday |
a | marcador am/pm | Texto | PM |
k | hora en el día (1-24) | Número | 24 |
K | hora en am/pm (0-11) | Número | 0 |
z | zona horaria | Texto | Pacific Standard Time(see comment) |
Z | zona horaria (RFC 822) | Texto | -0800(See comment) |
v | id de zona horaria | Texto | America/Los_Angeles(See comment) |
' | escape para texto | Delimitador | 'Date=' |
'' | comilla simple | Literal | 'o''clock' |
El número de letras del patrón también influye en el formato, de la siguiente manera:
- Texto
- Si usa 4 o más letras, entonces la fecha u hora se muestra en forma completa; si usa menos de 4 letras, entonces la fecha u hora se muestra en forma corta o abreviada si existe (por ejemplo,
"EEEE"produce"Monday","EEE"produce"Mon"). - Número
- El número mínimo de dígitos. Los números más cortos se rellenan con ceros hasta esta cantidad (por ejemplo, si
"m"produce"6","mm"produce"06"). El año se maneja de forma especial; es decir, si el conteo de 'y' es 2, el año se truncará a 2 dígitos. (por ejemplo, si"yyyy"produce"20,"yy"produce"97"). A diferencia de otros campos, los segundos fraccionales se rellenan a la derecha con ceros. - Texto o Número
- Si usa 3 o más letras, entonces produce un texto, de lo contrario, produce el número correspondiente. (por ejemplo,
"M"produce"1","MM"produce"01","MMM"produce"Jan", y"MMMM"produce"January". Algunas letras de patrón también tratan un conteo de 5 de forma especial, significando una abreviatura de una sola letra:L,M,E, yc.
Cualquier carácter en el patrón que no esté en los rangos de ['a '..'z'] y ['A'..'Z'] será tratado como texto citado. Por ejemplo, caracteres como ':', ' .', ' ' (espacio), '#' y ' @' aparecerán en el texto resultante de la hora aunque no estén entre comillas simples.
En la fecha, puede usar "/", "-", o un espacio entre el día, mes y año. Por ejemplo:
dd/MM/yyyyodd/MM/yydd-MM-yyyyodd-MM-yydd MM yyyyodd MM yy
Manejo de zona horaria
Cuando muestra una cadena de tiempo, por ejemplo, sus horarios de salida, también es posible incluir información sobre la zona horaria. Para fines de formato, la siguiente tabla muestra el comportamiento de GWT DateTimeFormat.
| Patrón | Zona horaria común | Zona horaria simple |
|---|---|---|
| z, zz, zzz | PDT | UTC-7 |
| zzzz | Pacific Daylight Time | UTC-7 |
| Z, ZZ | -0700 | -0700 |
| ZZZ | -07:00 | -07:00 |
| ZZZZ | GMT-07:00 | GMT-07:00 |
| v, vv, vvv, vvvv | America/Los_Angeles | Etc/GMT+7 |
Ejemplos
| Patrón | Texto formateado |
|---|---|
"yyyy.MM.dd G 'at' HH:mm:ss vvvv" | 2019.07.10 AD at 15:08:56 America/Los_Angeles |
"EEE, MMM d, ''yy" | Wed, July 10, '19 |
"h:mm a" | 12:08 PM |
"hh 'o''clock' a, zzzz" | 12 o'clock PM, Pacific Daylight Time |
"K:mm a, vvvv" | 0:00 PM, America/Los_Angeles |
"yyyyy.MMMMM.dd GGG hh:mm aaa" | 02019.July.10 AD 12:08 PM |
Consideraciones para el análisis
Al analizar una cadena de fecha usando el patrón de año abreviado ("yy"), el analizador debe interpretar el año abreviado relativo a algún siglo. Lo hace ajustando las fechas para que estén dentro de 80 años antes y 20 años después del momento en que se crea la instancia del analizador. Por ejemplo, usando un patrón de "MM/dd/yy" y una fecha creada el 1 de enero de 2019, la cadena "01/11/21" se interpretaría como 11 de enero de 2021, mientras que la cadena "05/04/64" se interpretaría como 4 de mayo de 1964. Durante el análisis, solo las cadenas que consisten exactamente en dos dígitos se analizarán como pertenecientes al siglo predeterminado. Si el patrón de año no tiene exactamente dos caracteres 'y', el año se interpreta literalmente, independientemente del número de dígitos. Por ejemplo, usando el patrón "MM/dd/yyyy", "01/11/19" se analiza como 11 de enero del año 19 d.C.
Cuando los campos numéricos están uno junto a otro directamente, sin caracteres delimitadores intermedios, constituyen una serie de campos numéricos adyacentes. Tales series se analizan de forma especial. Por ejemplo, el formato "HHmmss" analiza el texto de entrada "123456" como 12:34:56, analiza el texto de entrada "12345" como 1:23:45, y no logra analizar "1234". En otras palabras, el campo más a la izquierda de la serie es flexible, mientras que los otros mantienen un ancho fijo. Si el análisis falla en cualquier parte de la serie, entonces el campo más a la izquierda se acorta en un carácter, y se vuelve a analizar toda la serie. Esto se repite hasta que el análisis tenga éxito o el campo más a la izquierda tenga un carácter de longitud. Si el análisis aún falla en ese punto, el análisis de la serie falla.