Puede especificar el formato dateTime utilizando una serie de letras del patrón.
El recuento de las letras del patrón determina el formato. La Tabla 1 define las letras que están reservadas como letras del patrón:
| Símbolo | Significado | Presentación | Ejemplo |
|---|---|---|---|
| a | marcador am o pm | Texto | pm |
| d | día del mes | Número | 10 |
| D | día del año | Número | 189 |
| e | día de la semana (1-7) | Número | 2 |
| E | día de la semana | Texto | Martes |
| F | día del mes | Número | 2 (y semana en julio)3 |
| G | era | Texto | DC |
| h | hora en am o pm (1-12) | Número | 12 |
| H | hora del día (0-24) | Número | 0 |
| I | analizar como Fecha/Hora (ISO8601) | Consulte la nota 4. | |
| k | hora del día (1-24) | Número | 24 |
| K | hora en am o pm (0-11) | Número | 0 |
| m | minuto de la hora | Número | 30 |
| M | mes del año | Texto y número | Julio y 07 |
| w | semana del año | Número | 272 |
| W | semana del mes | Número | 2 |
| s | segundo del minuto | Número | 55 |
| S | milisegundo | Número | 978 |
| T | analizar como hora (ISO8601) | Consulte la nota 4. | |
| y | año | Número | 19961 |
| Y | año: utilizar sólo con semana del año | Número | 19962 |
| z | TimeZone | Texto | zzzz = Hora estándar del Pacífico |
| Z | huso horario | Texto | +50:30 |
| ' | escape para texto | 'Texto de usuario' | |
| '' | comilla simple dentro de texto con escape | 'o"clock' | |
|
|||
La presentación del objeto dateTime depende de los símbolos que especifique, tal como se indica a continuación:
Los caracteres del patrón que no estén en los rangos de ['a'..'z'] y ['A'..'Z'] se tratan como texto entrecomillado. Por ejemplo, los caracteres como dos puntos (:), coma (,), punto (.), el signo de número (hash o almohadilla, #), el signo arroba (@) y el espacio aparecen en el texto de tiempo resultante aunque no vayan entre comillas simples.
| Patrón de formato | Resultado |
|---|---|
| "yyyy.MM.dd'at'HH:mm:ss ZZZ" | 1996.07.10 a las 15:08:56 -05:00 |
| EEE, MMM d, "yy" | Mié, Julio 10, '96 |
| "h:mm a" | 8:08 PM |
| "hh 'o''clock' a, ZZZZ" | 09 en punto AM, GMT+09:00 |
| "K:mm a, ZZZ" | 9:34 AM, -05:00 |
| "yyyy.MMMMM.dd hh:mm aaa" | 1996.Julio.10 12:08 PM |
Año
yyyy
Año y mes
yyyy-MM
Fecha completa
yyyy-MM-dd
Fecha completa más horas y minutos
yyyy-MM-ddTHH:mm
Fecha completa más horas, minutos y segundos
yyyy-MM-ddTHH:mm:ss
Fecha completa más horas, minutos, segundos y una fracción decimal de
un segundo
yyyy-MM-ddTHH:mm:ss.S
Puede crear series de formato que generen resultados imprevisibles, por lo que debe tener cuidado al utilizar estos símbolos. Por ejemplo, si especifica dMyyyy, es imposibles distinguir entre día, mes y año. dMyyyy especifica que un mínimo de un carácter representa el día, un mínimo de un carácter representa el mes y cuatro caracteres representan el año. Por tanto 3111999 podría interpretarse como 3/11/1999 y como 31/1/1999.