dateFormat

La propiedad dateFormat identifica el formato de las fechas.

Los valores válidos son los siguientes:
"patrón"
El valor de patrón consiste en un conjunto de caracteres, tal como se describe en la sección Especificadores de formato de fecha, hora e indicación de la hora.

Los caracteres pueden eliminarse desde el inicio o el final de una especificación de fecha completa, pero no desde el medio.

defaultDateFormat
Si se especifica para un campo de página, el valor de defaultDateFormat es el formato de fecha dado en el entorno local de ejecución de Java. Si se especifica para un campo de formulario, el patrón predeterminado es equivalente a seleccionar systemGregorianDateFormat.
eurDateFormat
El patrón "dd.MM.aaaa", que es el formato de fecha estándar europeo de IBM.
isoDateFormat
El patrón "aaaa-MM-dd", que es el formato de fecha especificado por International Standards Organization (ISO).
jisDateFormat
El patrón "aaaa-MM-dd" que es el formato de fecha estándar industrial japonés.
usaDateFormat
El patrón "MM/dd/aaaa", que es el formato de fecha estándar para EE.UU. de IBM.
systemGregorianDateFormat
Un patrón de 8 ó 10 caracteres que incluye dd (para día numérico), MM (para mes numérico) y aa o aaaa (para año numérico), con caracteres que no sean d, M, a ni dígitos utilizados como separadores.
El formato está en la siguiente propiedad de entorno de ejecución Java:
  vgj.datemask.gregorian.long.NLS
NLS
El código NLS (soporte de idioma nacional) especificado en la propiedad de entorno de ejecución Java vgj.nls.code. El código es uno de los que se listan en targetNLS. Inglés en mayúsculas (código ENP) no está soportado.

Para obtener más detalles acerca de vgj.nls.code, consulte el apartado Propiedades de entorno de ejecución Java (detalles).

systemJulianDateFormat
Un patrón de 6 u 8 caracteres que incluye DDD (para día numérico) y aa o aaaa (para año numérico), con caracteres que no sean D, y ni dígitos como separadores.
El formato está en la siguiente propiedad de entorno de ejecución Java:
  vgj.datemask.julian.long.NLS
NLS
El código NLS (soporte de idioma nacional) especificado en la propiedad de entorno de ejecución Java vgj.nls.code. El código es uno de los que se listan en targetNLS. Inglés en mayúsculas (código ENP) no está soportado.

Para obtener más detalles acerca de vgj.nls.code, consulte el apartado Propiedades de entorno de ejecución Java (detalles).

La propiedad está disponible en los componentes DataItem y es relevante para los campos que aparecen en los siguientes contextos:
Esta propiedad se utiliza para la entrada y la salida, pero no en los siguientes casos:

Formatos de fecha internos

Cuando el usuario entra datos válidos, la fecha se convierte del formato especificado para el campo a un formato interno que se utiliza para la validación subsiguiente.

El formato interno para una fecha de caracteres es el mismo que el formato por omisión del sistema e incluye caracteres separadores.

Para una fecha numérica, los formatos internos son los siguientes:
  • Para una fecha abreviada Gregoriana, 00aaMMdd
  • Para una fecha larga Gregoriana, 00aaaaMMdd
  • Para una fecha abreviada Juliana, 0aaDDD
  • Para una fecha larga Juliana, 0aaaaDDD

Consideraciones sobre longitud para fechas

En un formulario, la longitud de campo del formulario debe ser mayor o igual a la longitud de la máscara de campo que especifique. La longitud del campo debe ser suficiente para contener el formato interno de la fecha.

En un campo de página, las reglas son las siguientes:
  • La longitud del campo debe ser suficiente para la máscara de fecha que especifique, pero puede ser más larga
  • En el caso de un campo numérico, los caracteres separadores se excluyen del cálculo de la longitud.

En la siguiente tabla encontrará ejemplos.

Tipo de formato Ejemplo Longitud del campo de formulario Longitud mínima del campo de página (tipo carácter) Longitud válida del campo de página (tipo numérico)
Gregoriano abreviado aa/MM/dd 8 8 6
Gregoriano largo aaaa/MM/dd 10 10 8
Juliano abreviado DDD-aa 6 6 5
Juliano largo DDD-aaaa 8 8 7

Consideraciones de E/S para fechas

Los datos entrados en un campo de variable se comprueban para asegurarse de que la fecha se ha entrado en el formato especificado. El usuario no tiene que entrar los ceros iniciales para días y meses, sino que puede especificar (por ejemplo) 8/5/1996 en lugar de 08/05/1996. El usuario que omite los caracteres separadores, no obstante, debe entrar todos los ceros iniciales.

Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.