Los formatos de fechas, horas e indicaciones de la hora se especifican mediante un patrón de letras, representando cada letra un componente de la fecha o la hora. Estos caracteres son sensibles a las mayúsculas y minúsculas y todas las letras desde la a hasta la z y desde la A hasta la Z se analizan como componentes de la fecha o la hora.
Para visualizar letras en la fecha, la hora o en la indicación de la hora sin que el texto se analice como un componente de fecha u hora, incluya esa letra o letras entre apóstrofes. Para visualizar un apóstrofe en la fecha, la hora o la indicación de la hora, utilice dos apóstrofes.
En la tabla siguiente se listan las letras y sus valores en un patrón de fecha, hora o indicación de la hora.
Letra | Componente de fecha u hora | Tipo | Ejemplos |
---|---|---|---|
G | Designador de era | Texto | AD |
a | Año | Año | 1996; 96 |
M | Mes del año | Mes | Julio; Jul; 07 |
w | Semana del año | Número | 27 |
W | Semana del mes | Número | 2 |
D | Día del año | Número | 189 |
d | Día del mes | Número | 10 |
F | Día de la semana en el mes | Número | 2 |
E | Día de la semana | Texto | Martes; Mar |
p | Marcador AM/PM | Texto | PM |
H | Hora del día (0-23) | Número | 0 |
k | Hora del día (1-24) | Número | 24 |
K | Hora en AM/PM (0-11) | Número | 0 |
h | Hora en AM/PM (1-12) | Número | 12 |
m | Minuto de la hora | Número | 30 |
s | Segundo del minuto | Número | 55 |
S | Milisegundo | Número | 978 |
z | Huso horario | Huso horario general | Hora estándar del pacífico; PST; GMT-08:00 |
Z | Huso horario | Huso horario RFC 822 | -800 |
C | Siglo | Siglo | 20; 21 |
El número de cada letra utilizado consecutivamente en el patrón determina cómo se interpreta y analiza ese grupo de letras. La interpretación depende del tipo de letra. Además, la interpretación depende de si el patrón se utiliza para formatear o analizar. La lista siguiente describe los tipos de letras y cómo afecta a la interpretación la diferencia en el número de esas letras.
Para el análisis, si el número de letras del patrón no es 2, el año se interpreta literalmente, independientemente del número de dígitos. Por ejemplo, el patrón MM/dd/aaaa asignado al valor 01/11/12 se analiza como Enero 11, 12 A.D. El mismo patrón asignado al valor 01/02/3 o 01/02/0003 se analiza como Enero 2, 3 A.D. De la misma forma, el mismo patrón asignado al valor 01/02/-3 se analiza como Enero 2, 4 A.C.
Para el análisis, si el patrón es aa, el analizador determina el año completo relativo al año actual. El analizador presupone que el año de dos dígitos está dentro de los 80 años anteriores o de los 20 posteriores al momento del proceso. Por ejemplo, si el año actual es 2004, el patrón MM/dd/aa asignado al valor 01/11/12 se analiza como Enero 11, 2012, mientras que el mismo patrón asignado al valor 05/04/64 se analiza como Mayo 4, 1964.
GMTOffsetTimeZone = GMT Signo Horas : Minutos
Para el análisis, también se aceptan los husos horarios RFC 822.
RFC822TimeZone = Signo horasDosDígitos : Minutos
HorasDosDígitos debe ser un número de dos dígitos entre 00 y 23. Las otras definiciones son iguales que el tipo de huso horario General.
Para el análisis, también se aceptan los husos horarios General.
La tabla siguiente muestra algunos ejemplos de patrones de fecha y hora interpretados en el entorno local de EE.UU.
Patrón de fecha y hora | Resultado |
---|---|
aaaa.MM.dd G 'a las' HH:mm:ss z | 2001.07.04 AD a las 12:08:56 PDT |
EEE, MMM d, ''aa | Mie, Jul 4, '01 |
h:mm p | 12:08 PM |
hh 'horas' a, zzzz | 12 horas PM, Hora del pacífico |
K:mm p, z | 0:08 PM, PDT |
aaaaa.MMMMM.dd GGG hh:mm ppp | 02001.July.04 AD 12:08 PM |
EEE, d MMM aaaa HH:mm:ss Z | Mie, 4 Jul 2001 12:08:56 -0700 |
aaMMddHHmmssZ | 010704120856-0700 |