Propiedades de formato

Las propiedades de formato especifican características relevantes cuando se presentan datos en un formulario o un navegador Web. Las propiedades afectan a los datos en la salida o tanto en la entrada como en la salida.

Las propiedades son las siguientes:

align

La propiedad de alineación, align, especifica la posición de datos en un campo de variable cuando la longitud de los datos es menor que la longitud del campo. Esta propiedad es de utilidad en formularios de texto e impresión.

En la salida, los datos de tipo carácter y numérico resultan afectados por esta propiedad. En la entrada, los datos de tipo carácter resultan afectados por esta propiedad, pero los datos de tipo numérico siempre quedan afectados por esta propiedad, pero los datos de tipo numérico siempre quedan alineados a la derecha.

Los valores válidos son los siguientes:
left
Colocar los datos a la izquierda del campo, que es el valor por omisión para los datos de tipo carácter. Los espacios iniciales se colocan al final del campo.
none
No justificar los datos. Este valor solamente es válido para los datos de tipo carácter.
right
Colocar los datos a la derecha del campo, que es el valor por omisión para los datos de tipo numérico. Los espacios finales se colocan al principio del campo. Este valor es necesario para los datos numéricos que tengan un signo o posición decimal.

currency

La propiedad de moneda, currency, indica si debe incluirse un símbolo de moneda antes del valor en un campo numérico, con la posición exacta del símbolo determinada por la propiedad zeroFormat. El formateo de los campos de tipo MONEY depende del valor de strLib.defaultMoneyFormat y no se ve afectado por la propiedad currency.

Los valores de la propiedad currency son los siguientes:
No (el valor por omisión)
No utilizar un símbolo de moneda.
Yes
Utilice el símbolo especificado en currencySymbol. Si aquí no se especifica ningún valor, utilice el símbolo de la moneda por omisión.

El símbolo de moneda por omisión viene determinado por el entorno local del sistema.En el código Java, el símbolo de moneda por omisión viene determinado por el entorno local del sistema. En código COBOL, el valor por omisión viene determinado por la opción de idioma nacional.

currencySymbol

La propiedad currencySymbol indica qué símbolo de moneda se debe utilizar cuando la propiedad currency está en vigor.

fillCharacter

La propiedad de carácter de relleno, fillCharacter, indica qué carácter rellena posiciones no utilizadas en un formulario de texto o impresión o en datos de manejador de páginas. Además, la propiedad cambia el efecto de set field full, tal como se describe en set. El efecto de esta propiedad solamente se produce en la salida.

El valor por omisión es un espacio para números y un 0 para elementos hex. El valor por omisión para tipos carácter depende del medio:
  • En formularios de texto o impresión, el valor predeterminado es una serie vacía
  • Para los datos de manejador de páginas, el valor por omisión es blanco para los datos de tipo CHAR o MBCHAR

En los manejadores de páginas, el valor de fillCharacter debe ser un espacio (al igual que el valor por omisión) para elementos del tipo DBCHAR o UNICODE.

dateFormat

La propiedad de formato de fecha, dateFormat, identifica el formato para fechas que se visualizan en un formulario o que se mantienen en un manejador de páginas. Esta propiedad afecta a la entrada y a la salida, pero no se utiliza en los siguientes casos:
  • El elemento tiene posiciones decimales, un símbolo de moneda, un separador numérico o un signo; o bien
  • El tipo de datos para el elemento de datos es DBCHAR, MBCHAR o HEX; o bien
  • El elemento no es lo suficientemente grande como para contener la máscara. (Para conocer otros detalles, consulte Consideraciones de longitud para 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.
defaultDateFormat
Un patrón especificado por omisión o por asignación en el programa. Puede asignar cualquiera de las constantes de esta lista o un patrón de su propiedad.

Si se especifica para un elemento de manejador de páginas, el patrón predeterminado es el formato de fecha dado en el entorno local de ejecución de Java. Si se especifica para un elemento de formulario, el patrón predeterminado es equivalente a seleccionar systemGregorianDateFormat.

isoDateFormat
El patrón "aaaa-MM-dd", que es el formato de fecha especificado por International Standards Organization (ISO).
usaDateFormat
El patrón "MM/dd/aaaa", que es el formato de fecha estándar para EE.UU. de IBM.
eurDateFormat
El patrón "dd.MM.aaaa", que es el formato de fecha estándar europeo de IBM.
jisDateFormat
El patrón "aaaa-MM-dd" que es el formato de fecha estándar industrial japonés.
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.

Para programas COBOL, el administrador del sistema para los servicios de ejecución EGL establece el formato durante la instalación.

Para programas Java, elEl 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.

Para programas COBOL, el administrador del sistema para los servicios de ejecución EGL establece el formato durante la instalación.

Para programas Java, elEl 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).

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, como 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 elemento debe ser suficiente para contener el formato interno de la fecha.

En un elemento de manejador de páginas, las reglas son las siguientes:
  • La longitud del elemento debe ser suficiente para la máscara de fecha que especifique, pero puede ser más larga
  • En el caso de un elemento 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 elemento manejador de páginas (tipo carácter) Longitud válida del elemento manejador de páginas (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.

isBoolean

La propiedad isBoolean (antes la propiedad boolean) indica que el campo representa un valor booleano. La propiedad restringe los valores de campo válidos y es útil para los formularios de texto e impresión y en manejadores de páginas, para entrada o salida.

En una página Web asociada con un manejador de páginas de EGL, un elemento booleano está representado por un recuadro de selección. En un formulario, la situación es la siguiente:
  • El valor de un campo numérico es 0 (falso) o 1 (verdadero).
  • El valor de un campo de caracteres está representado por una palabra o un subconjunto de una palabra que depende del idioma nacional. En Inglés, por ejemplo, un campo booleano de tres o más caracteres tiene el valor yes (verdadero) o no (falso) y el valor de un campo booleano de un carácter tiene el valor truncado y o n.

    En programas Java, losLos valores específicos de programa para yes y no quedan determinados por el entorno local.

linewrap

La propiedad linewrap indica si el texto puede acomodarse en una línea nueva, si ello es necesario para no truncar el texto. Los valores son los siguientes:
character (el valor por omisión)
El texto de un campo no se dividirá en un espacio en blanco.
compressed
El texto de un campo de tipo ConsoleField se dividirá en un espacio en blanco, pero cuando el usuario abandone el campo (navegando a otro campo o pulsando Esc), se eliminarán los espacios extraordinarios utilizados para acomodar texto.
word
Si es posible, el texto de un campo se dividirá en un espacio en blanco.

lowerCase

La propiedad de minúsculas, lowerCase, indica si deben establecerse caracteres alfabéticos en minúsculas en la entrada de caracteres de un solo byte del usuario. Los valores son los siguientes:
no (el valor por omisión)
No establecer la entrada del usuario en minúsculas.
yes
Establecer la entrada del usuario en minúsculas.

masked

La propiedad masked indica si un carácter especificado por el usuario se visualizará o no. Esta propiedad se utiliza para especificar contraseñas. Los valores son los siguientes:
no (el valor por omisión)
Se visualizará el carácter entrado por el usuario.
yes
No se visualizará el carácter entrado por el usuario.

numericSeparator

La propiedad numericSeparator indica si debe colocarse un carácter en un número que tenga un componente entero de más de 3 dígitos. Si el separador numérico es una coma, por ejemplo, mil se muestra como 1,000 y un millón se muestra como 1,000,000. Los valores son los siguientes:
no (el valor por omisión)
No utilizar un separador numérico.
yes
Utilizar un separador numérico.

En el código Java, elEl valor por omisión queda determinado por el entorno local de la máquina. En código COBOL, el valor por omisión está determinado por la opción de idioma nacional.

sign

La propiedad de signo, sign, indica la posición en la que se visualiza un signo positivo (+) o negativo (-) cuando se coloca un número en el campo, ya sea desde entrada de usuario o desde el programa. Los valores son los siguientes:
none
No se visualiza un signo.
leading
El valor por omisión: se visualiza un signo a la izquierda del primer dígito en el número, con la posición exacta del signo determinada por la propiedad zeroFormat (descrita más adelante).
trailing
Se visualiza un signo justo a la derecha del último dígito del número.

timeFormat

La propiedad de formato de hora, timeFormat, identifica el formato para horas que se visualizan en un formulario o que se mantienen en un manejador de páginas. Esta propiedad afecta a la entrada y a la salida, pero no se utiliza en los siguientes casos:
  • El elemento tiene posiciones decimales, un símbolo de moneda, un separador numérico o un signo; o bien
  • El tipo de datos para el elemento de datos es DBCHAR, MBCHAR o HEX; o bien
  • El elemento no es lo suficientemente grande como para contener la máscara. (Para conocer otros detalles, consulte Consideraciones de longitud para 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.
defaultTimeFormat
Un patrón especificado por omisión o por asignación en el programa. Puede asignar cualquiera de las constantes de esta lista o un patrón de su propiedad.

El valor predeterminado en un entorno Java lo establece el entorno local Java.

isoTimeFormat
El patrón "HH.mm.ss", que es el formato de hora especificado por International Standards Organization (ISO).
usaTimeFormat
El patrón "hh:mm AM", que es el formato de hora estándar de EE.UU. de IBM.
eurTimeFormat
El patrón "HH.mm.ss", que es el formato de hora estándar europeo de IBM.
jisTimeFormat
El patrón "HH:mm:ss", que es el formato de hora estándar industrial japonés.

Consideraciones sobre longitud para horas

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

Consideraciones de E/S para horas

Los datos entrados en un campo de variable se comprueban para asegurarse de que la hora se ha entrado en el formato especificado. El usuario no tiene que entrar los ceros iniciales para horas, minutos y segundos, sino que puede especificar (por ejemplo) 8:15 en lugar de 08:15. El usuario que omite los caracteres separadores, no obstante, debe entrar todos los ceros iniciales.

Una hora almacenada en formato interno no se reconoce como hora, sino simplemente como datos. Si se mueve un campo de hora de 6 caracteres a un elemento de caracteres de longitud 10, por ejemplo, EGL rellena el campo de destino con blancos. No obstante, cuando el valor de 6 caracteres se presenta en un formulario, la hora se convierte desde su formato interno, como corresponda.

timeStampFormat

La propiedad de formato de fecha, timeStampFormat, identifica el formato para indicaciones de la hora que se visualizan en un formulario o que se mantienen en un manejador de páginas.

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.
defaultTimeStampFormat
Un patrón especificado por omisión o por asignación en el programa. Puede asignar cualquiera de las constantes de esta lista o un patrón de su propiedad.

En un entorno Java el valor predeterminado lo establece el entorno local Java.

db2TimeStampFormat
El patrón "aaaa-MM-dd-HH.mm.ss.ffffff", que es el formato de indicación de la hora predeterminado de IBM DB2.
odbcTimeStampFormat
El patrón "yyyy-MM-dd HH:mm:ss.ffffff", que es el formato de indicación de la hora de ODBC.

Los patrones que representan unidades de tiempo (años, días, etc.) deben especificarse por el orden en el que aparecen en la indicación de la hora. Los patrones pueden eliminarse desde el inicio o el final de la indicación de la hora, pero no desde el medio.

upperCase

La propiedad de mayúsculas, upperCase, indica si deben establecerse caracteres alfabéticos en mayúsculas en la entrada de caracteres de un solo byte del usuario.

Esta propiedad es de utilidad en formularios y en manejadores de páginas.

Si está generando salida para CICS, la propiedad upperCase no resulta útil si la definición de terminal CICS incluye UCTRAN, que provoca que CICS convierta toda la entrada de terminal a mayúsculas.

Los valores de upperCase son los siguientes:
No (valor por omisión)
No establecer la entrada del usuario en mayúsculas.
Yes
Establecer la entrada del usuario en mayúsculas.

zeroFormat

La propiedad de formato de ceros, zeroFormat, especifica cómo se visualizan los valores cero en los campos numéricos pero no en campos de tipo MONEY. Esta propiedad resulta afectada por las propiedades numeric separator, currency y fillCharacter. Los valores de zeroFormat son los siguientes:
Yes
Se visualiza un valor cero como el número cero, que puede expresarse en comas decimales (0.00 es un ejemplo, si se define el elemento con dos posiciones decimales) y con símbolos de moneda y separadores de caracteres ($000,000.00 es un ejemplo, dependiendo de los valores de las propiedades currency y numericSeparator). Las siguientes reglas son aplicables cuando el valor de la propiedad zeroFormat es yes:
  • Si el carácter de relleno (el valor de la propiedad fillCharacter) es 0, se da formato a los datos con el carácter 0
  • Si el carácter de relleno es un nulo, los datos se alinean a la izquierda
  • Si el carácter de relleno es un blanco, los datos alinean a la derecha
  • Si el carácter de relleno es un asterisco (*), los asteriscos se utilizan como relleno de la izquierda en lugar de blancos
No
Se visualiza un valor cero como una serie del carácter de relleno.
Condiciones de uso | Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.