Especificadores de fecha, hora e indicación de la hora

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.

Texto
Para el formato, si el número de letras es menor que 4, se utiliza la forma completa. De lo contrario, se utiliza una abreviatura, si la hay. Al analizar, se aceptan ambas formas, independientemente del número de letras de patrón.
Número
Para el formato, el número de letras del patrón representa el número mínimo de dígitos. Se se añaden ceros a los números mas cortos para que alcancen la longitud designada. Para el análisis, el número de letras del patrón se ignora a menos que sea necesario separar dos campos adyacentes.
Año
Para el formato, si el número de letras del patrón es 2, el año se trunca a 2 dígitos. De lo contrario, se interpreta como el tipo de número.

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.

Mes
Si el número de letras de patrón es 3 o más, el mes se interpreta como tipo de texto. De lo contrario, se interpreta como el tipo de número.
Huso horario general
Los husos horarios generales se interpretan como el tipo de texto si tienen nombres. Para los husos horarias que representan un valor de desplazamiento GMT, se utiliza la sintaxis siguiente:

GMTOffsetTimeZone = GMT Signo Horas : Minutos

Signo
O bien +, o bien -
Horas
Un número de uno o dos dígitos entre 0 y 23. El formato es independiente del entorno local y debe tomarse del bloque Basic Latin del estándar Unicode.
Minutos
Un número de dos dígitos entre 00 y 59. El formato es independiente del entorno local y debe tomarse del bloque Basic Latin del estándar Unicode.

Para el análisis, también se aceptan los husos horarios RFC 822.

Huso horario RFC 822
Se utiliza el formato de huso horario de 4 dígitos de 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.

Siglo
Si visualiza como un tipo de número que toma la modalidad de año completo por 100.

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
Condiciones de uso | Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.