DateTime como datos STRING

Puede especificar el formato dateTime utilizando una serie de letras del patrón.

Si el objeto dateTime es un decimal empaquetado CWF, sólo se pueden utilizar los símbolos que se presentan como números. Para todas las demás opciones de Tipo físico, puede utilizar todos los símbolos.

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:

Tabla 1. Símbolos de formato DateTime
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'
  1. El año se trata como un caso especial:
    • En la salida, si el recuento de y es 2, el año se trunca a 2 dígitos. Por ejemplo, si yyyy genera 1997, yy genera 97.
    • En la entrada, para los años de 2 dígitos, la propiedad del conjunto de mensajes CWF de Ventana de siglo se utiliza para determinar el siglo. Por ejemplo, si Ventana de siglo se establece en 53, el año 97 es 1997, el año 52 es 2052 y el año 53 es 1953.
  2. El primer día de un año no suele caer al principio de la semana y, por tanto, las fechas expresadas utilizando la semana del año pueden hacer referencia a fechas de años adyacentes. Por ejemplo, el día 1 de la semana 1 de 2002 (2002 01 Lunes) utilizando la serie de formato YYYY ww EEEE es, de hecho, el 31 de diciembre de 2001. Si utiliza Y, el día de la semana (E) y la semana del año (w) se ajustan, si es necesario, para indicar que la fecha cae en el año anterior. Si utiliza el símbolo y, el ajuste no se realiza y pueden producirse resultados imprevisibles para las fechas cercanas al final del año.

    Por ejemplo, si se formatea la serie 2002 01 Lunes:

    • el día 1 de la semana 1 de 2002 utilizando la serie de formato YYYY ww EEEE se interpreta correctamente como el día 31 de diciembre de 2001
    • el día 1 de la semana 1 de 2002 utilizando la serie de formato yyyy ww EEEE se interpreta incorrectamente como el día 30 de diciembre de 2002

    Y sólo debe utilizarse conjuntamente con w. Si especifica Y sin w, el año se ignora. Por ejemplo, si especifica YYYY-mm-dd para formatear la fecha 1996-03-01, el resultado es 2002-03-01 ya que la entrada de año se ignora y se asume el año actual.

  3. El día 11 de julio de 2001 es el segundo miércoles del mes de julio y puede expresarse como 2001 Julio Miércoles 2 utilizando la serie de formato yyyy MMMM EEEE F. Esta fecha no es la misma que el miércoles de la semana 2 de julio de 2001, que es el día 4 de julio de 2001.
    Nota: La primera y la última semana de un mes pueden incluir días de los meses adyacentes. Por ejemplo, el martes 31 de julio de 2001 puede expresarse como el martes de la semana uno de agosto de 2001, que es 2001 08 1 Martes utilizando la serie de formato yyyy MM W EEEE.
    Nota: Sólo puede expresar un huso horario como una diferencia en horas y minutos de la hora media de Greenwich (GMT) ( +/-hh:mm ). El número de símbolos de formato Z afecta a la salida:
    • -Z (forma corta) produce -5
    • -ZZ (forma media) produce -05
    • -ZZZ (forma larga) produce -05:00
    • -ZZZZ (forma larga) produce GMT-05:00
  4. Puede utilizar el símbolo de formato I (letra "i" en mayúscula) para emparejar las series dateTime ISO8601. Más abajo se muestran ejemplos de formatos dateTime ISO8601. Una I sólo debe utilizarse sola.

    En la entrada a un flujo de mensaje, una serie de formato de I permite analizar cualquier formato dateTime que se ajuste a ISO8601. En la salida de un flujo de mensaje, el formato dateTime siempre se expresa en su forma más completa, yyyy-MM-dd'T'HH:mm:ss.SSS.

    Si utiliza el símbolo de formato T, pueden construirse series de formato para que coincidan con los formatos dateTime ISO8601, donde T precede a la parte de la hora de una entidad dateTime.

La presentación del objeto dateTime depende de los símbolos que especifique, tal como se indica a continuación:

  • Texto. Si especifica cuatro o más símbolos, se presenta la forma completa. Si especifica menos de cuatro, se presenta la forma corta o abreviada, si existe. Por ejemplo, EEEE genera Lunes y EEE genera Lun.
  • Número. Repita el símbolo para especificar el número mínimo de dígitos que desea. Los números más cortos se rellenan con ceros hasta esta longitud. Por ejemplo, si especifica m, se presenta el número 6. Si especifica mm, se presenta el número 06. Un año es un caso especial; vea la nota 1 de la tabla.
  • Texto y número. Si especifica tres o más símbolos, se visualiza el texto. Si especifica menos, se presenta el número. Por ejemplo, si especifica M, se genera 1. Si especifica MM, se genera 01. Si especifica MMM, se genera Ene. Si especifica MMMM, se genera Enero.

    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.

Ejemplo

La tabla siguiente muestra ejemplos de formatos dateTime:
Tabla 2. Ejemplos de formatos dateTime
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.