En orígenes de datos FOCUS (no emplean el atributo ACTUAL), USAGE también especifica cómo almacenar el campo. En otros tipos de orígenes de datos, asigne un valor de USAGE correspondiente al valor ACTUAL, para identificar el campo como el mismo tipo de datos usado para almacenarlo en el origen de datos. Si los datos se almacenan en modo alfanumérico, asigne USAGE según cómo vaya a aparecer el campo en sus informes. La conversión se realiza automáticamente. Para instrucciones sobre la correspondencia entre los valores de ACTUAL y los valores de USAGE, consulte la documentación del adaptador de datos específico.En orígenes de datos secuenciales, VSAM e ISAM, consulte Cómo describir un origen de datos secuencial, VSAM o ISAM. Para otros tipos de orígenes de datos, consulte la documentación de su adaptador.

Además de seleccionar el tipo y longitud de los datos, también puede especificar opciones de visualización, como el formato de fechas, símbolos de dólar variable y supresión de ceros. Use estas opciones para personalizar el aspecto del campo en los informes.

USAGE = tl[d]

Puede especificar muchos tipos de formatos:

• Numérica. Hay cuatro tipos de formatos numéricos: número entero, punto flotante de preción simple, punto flotante de precisión doble y decimal empaquetado. Para más información, consulte Opciones de visualización numéricas.
• Alfanumérico. Puede usar el formato alfanumérico para interpretar cualquier valor como una secuencia de caracteres, compuesto por cualquier combinación de dígitos, letras y otros caracteres.
• Fecha. El formato de fecha le permite definir componentes de fecha como el año, trimestre, mes, día o día de la semana, para:
  • Clasificar por fecha.
  • Comparar fechas y hacer cálculos aritméticos.
  • Validar fechas automáticamente en transacciones.

  En algunas aplicaciones, como la asignación de un valor de fecha mediante la función DECODE, puede que desee usar campos alfanuméricos, de número entero o decimal empaquetado, con las opciones de visualización, que ofrecen una funcionalidad de fechas parcial.

• Fecha-Hora. El formato de fecha-hora admite la fecha y la hora, de forma parecida a los tipos de datos de marca de tiempo, disponibles en muchos orígenes de datos relacionales. Los campos de fecha-hora se almacenan en ocho, diez o doce bytes: cuatro bytes para la fecha y cuatro, seis u ocho bytes para la hora, dependiendo de si el formato especifica un microsegundo o un nanosegundo. Los cálculos solo permiten la asignación directa dentro de los tipos de datos. Todas las demás expresiones se logran mediante un conjunto de funciones de fecha y hora.
• Texto. Puede usar los campos de texto para almacenar grandes cantidades de datos y mostrarlos con saltos de líneas.

Puede usar este formato para los números enteros. Un número entero es cualquier valor compuesto de los dígitos 0-9, sin carácter decimal.

Puede usar los campos de número entero con opciones de visualización de fechas, para ofrecer un soporte de fechas limitado. Este uso de los campos de número entero aparece descrito en Formatos numéricos y alfanuméricos con opciones de visualización de fechas.

El tipo de USAGE de número entero es I. Consulte Opciones de visualización numéricas. El formato de la especificación de longitud es:

n

donde:

n

Es el número de dígitos mostrado. La longitud máxima es 11, incluidos los dígitos y, si el campo contiene un valor negativo, un signo de menos al principio. También puede especificar un número de posiciones decimales (hasta n - 1) para que el número aparezca con un carácter decimal antes del número de dígitos especificado.

Por ejemplo:

I6

  4316

I6.2

 43.16

I2

22

I4

 -617

Puede usar el formato de punto flotante de precisión doble con cualquier valor compuesto de los dígitos 0-9 y un carácter decimal opcional.

El tipo de USAGE de punto flotante de precisión doble es D. Consulte Opciones de visualización numéricas, para ver las opciones de visualización compatibles. El formato de la especificación de longitud es:

t[.s]

donde:

t

Es el número de caracteres que se va a mostrar, con un máximo de 33, incluidos los dígitos numéricos, un punto decimal opcional y, si el campo contiene un valor negativo, un signo de menos al principio. El número admitido de dígitos significativos varía según el entorno operativo.

s

Es el número de dígitos posteriores al punto decimal. 31 y debe ser inferior a t.

Por ejemplo:

D8.2

3,187.54

D8

416

Puede usar el formato de punto flotante de precisión simple con cualquier número, incluidos los que presenten posiciones decimales. El número está compuesto por los dígitos 0-9, incluyendo un carácter decimal opcional. Este formato se utiliza con número decimales más pequeños. A diferencia del formato de punto flotante de precisión doble, su longitud no puede superar las nueve posiciones.

El tipo de USAGE de punto flotante de precisión simple es F. Las opciones de visualización compatibles están descritas en Opciones de visualización numéricas. El formato de la especificación de longitud es:

t[.s]

donde:

t

Es el número de caracteres que se va a mostrar, con un máximo de 33, incluidos los dígitos numéricos, un punto decimal opcional y, si el campo contiene un valor negativo, un signo de menos al principio. El número admitido de dígitos significativos varía según el entorno operativo.

s

Es el número de dígitos posteriores al punto decimal. Puede tener hasta 31 dígitos y debe ser inferior a t.

Por ejemplo:

F5.1

614.2

F4

318

Puede usar el formato de decimal empaquetado con cualquier número, incluidos los números decimales. Un número decimal es cualquier valor compuesto de los dígitos 0-9, incluido el carácter decimal opcional.

También puede usar los campos de decimal empaquetado con opciones de visualización de fechas, para ofrecer un soporte de fechas limitado. Consulte Formatos numéricos y alfanuméricos con opciones de visualización de fechas.

El tipo de USAGE de decimal empaquetado es P. Las opciones de visualización compatibles están descritas en Opciones de visualización numéricas.

El formato de la especificación de longitud es:

t[.s]

donde:

t

Es el número de caracteres que se va a mostrar (hasta 33), incluido un máximo de 31 dígitos, un punto decimal opcional y, si el campo contiene un valor negativo, un signo de menos al principio.

s

Es el número de dígitos posteriores al punto decimal. Puede tener hasta 31 dígitos y debe ser inferior a t.

Por ejemplo:

P9.3

4168.368

P7

617542

Puede usar las opciones de visualización para editar los formatos numéricos. Estas opciones solo afectan al modo en que se imprimen los datos del campo o aparecen en la pantalla, no a cómo se encuentran almacenados.

-

%

A

B

c

C

DMY

E

L

M

MDY

N

R

S

T

YMD

La tabla siguiente presenta ejemplos de las opciones de visualización disponibles para los campos numéricos.

I2-
D7-
F7.2-

-21
-6148
-8878

21-
6148-
8878.00-

I2%
D7%
F3.2%

21
6148
48

21%
6,148%
48.00%

D6c
D7Mc
D7Nc

41376
6148
6148

41376
$6148
$  6148

I6C

41376

41,376

D6S

0

I6B

-64187

(64187)

I8R

-3167

3167 CR

F4L

31

0031

D7M

6148

$6,148

D7N

5432

$    5,432

D12.5E

1234.5

0.12345D+04

I6YMD
I8YYMD

980421
19980421

98/04/21
1998/04/21

I6MDY
I8MDYY

042198
04211998

04/21/98
04/21/1998

I6DMY
I8DMYY

210498
21041998

21/04/98
21/04/1998

I2MT

07

JUL

I5CB

-61874

(61,874)

Puede especificar las opciones en cualquier orden. Las opciones M y N (símbolo de dólar variable y no variable) y el formato de datos D (punto flotante de precisión doble) invocan automáticamente la opción C (coma). Las opciones L y S no pueden usarse de forma conjunta. La opción T (trasladar) puede colocarse en cualquier lugar de una especificación USAGE alfanumérica o de número entero, que incluya la opción de visualización M (mes). Las opciones de visualización de fechas (D, M, T e Y), que no pueden usarse con campos de punto flotante, aparecen descritas en Formatos numéricos y alfanuméricos con opciones de visualización de fechas.

Puede seleccionar un símbolo de divisa para mostrarlo en la salida de informe, independientemente del símbolo de divisa predeterminado, configurado para el Soporte de lengua nacional (NLS). Use el formato de símbolo de divisa extendido en lugar de la opción de visualización de dólar variable (M) o no variable (N). Al usar la opción de visualización de dólar variable (M) o no variable (N), se muestra el símbolo de divisa asociado a la página de código predeterminada. Por ejemplo, al usar una página de código Inglés americano, se muestra el símbolo de dólar.

El formato de símbolo de divisa extendido le permite mostrar un símbolo diferente al de dólar. Por ejemplo, puede mostrar el símbolo de dólar estadounidense, libra esterlina, yen japonés, yuan chino o euro. El soporte de símbolo de divisa extendido está disponible para formatos numéricos (I, D, F y P). En Developer Studio, estos formatos se seleccionan desde el cuadro de diálogo Formatos.

Los formatos de símbolo de divisa extendida están especificados como combinaciones de dos caracteres en las últimas posiciones de cualquier formato de visualización numérico. El primer carácter de la combinación puede ser un signo de exclamación (!) o dos puntos (:). Se recomienda usar el carácter de dos puntos debido a que funciona en todas las páginas de código ASCII y EBCDIC. El signo de exclamación no es consistente en todas las páginas de código EBCDIC y puede dar lugar a comportamientos inesperados si su página de código lo traduce de una manera diferente. La tabla siguiente lista las opciones admitidas de visualización de divisas extendidas:

numeric_format {:|!}option

SET PAGE-NUM = OFF
TABLE FILE CENTORD
PRINT PRODNAME QUANTITY PRICE/D10.2!E
BY ORDER_DATE
WHERE QUANTITY GT 700;
ON TABLE SET STYLE *
TYPE = REPORT, GRID = OFF,$
ENDSTYLE
END

Cuando se asigna un valor con posiciones decimales a un campo numérico, si hay más posiciones decimales en el valor que lo especificado en la descripción de longitud del campo, el valor queda redondeado a un tamaño aceptable, antes de ser mostrado o almacenado. El valor se redondea hacia abajo cuando el primer dígito decimal extra es inferior a cinco, o hacia arriba, cuando es igual o mayor que cinco (aunque se introduce una consideración adicional para los valores de punto flotante).

Por ejemplo, considere un campo de decimal empaquetado con dos posiciones decimales

FIELDNAME = PRESSURE, FORMAT = P8.2, $

al que se le asigna un valor con cuatro posiciones decimales:

PRESSURE = 746.1289

El primer dígito extra (es decir, el primero después de la longitud especificada de dos posiciones decimales) es 8. Puesto que el 8 es mayor o igual a cinco, el valor se redondea hacia arriba y PRESSURE se convierte en:

746.13

Los detalles del redondeo se manejan del siguiente modo para estos formatos numéricos:

• Formato de número entero. Cuando se asigna un valor con dos posiciones decimales a un campo de número entero, el valor se redondea antes de quedar almacenado. Si el valor se asigna mediante un comando DEFINE o COMPUTE, la porción decimal del valor queda truncada antes de que este sea almacenado.
• Formato de decimal empaquetado. Cuando se asigna un valor a un campo de decimal empaquetado, con más posiciones decimales que lo especificado por el formato del campo, el valor se redondea antes de quedar almacenado.
• Formatos de punto flotante de precisión simple o doble. Cuando se asigna un valor a uno de estos campos, con más posiciones decimales de lo especificado por el formato de los campos, se almacena el valor completo en el campo (con el límite de precisión determinado por el tipo de almacenamiento interno de campos). Sin embargo, cuando aparece más adelante, el valor se ha redondeado.

  Tenga en cuenta que, si la porción decimal de un valor de punto flotante, de acorde a la representación interna con la notación de punto flotante hexadecimal, está repetida (no es de terminación), el número hexadecimal repetido se resuelve como un número no repetido, ligeramente más bajo, y queda almacenado como el valor del campo. En estos casos, si hubiese habido un cinco (se hubiese redondeado) en el valor original del dígito que se va a redondear, este se hubiese convertido en un cuatro (redondeado hacia abajo) en el valor inferior almacenado.

  Por ejemplo, considere un campo de punto flotante de precisión doble con una posición decimal

  FIELDNAME = VELOCITY, FORMAT = D5.1, $

  al que se le asigna un valor con dos posiciones decimales:

  VELOCITY = 1.15

  Este valor queda almacenado como un número ligeramente inferior, debido a circunstancias especiales de la aritmética de puntos flotantes, como se ha descrito anteriormente:

  1.149999

  Mientras que el número original, 1.15, hubiese quedado redondeado hacia arriba hasta 1.2 (el primer dígito extra era igual o mayor que 5), el número almacenado es ligeramente inferior a 1.15 (1.149999) y, como ahora el primer dígito extra es inferior a cinco (4, en este caso), se redondea hacia abajo hasta llegar a 1.1. En resumen:

  format:    D5.1 
  entered:   1.15 
  stored:    1.149999 
  rounded:   1.1 
  displayed: 1.1

Puede usar el formato alfanumérico para interpretar cualquier valor como una secuencia de caracteres, compuesto por cualquier combinación de dígitos, letras y otros caracteres.

También puede usar los campos alfanuméricos con opciones de visualización de fechas, para ofrecer un soporte de fechas limitado. Este uso de los campos alfanuméricos aparece descrito en Formatos numéricos y alfanuméricos con opciones de visualización de fechas.

El tipo de USAGE alfanumérico es A. El formato de la especificación de longitud es n, donde n es el número máximo de caracteres del campo. Puede tener hasta 3968 bytes en un campo alfanumérico perteneciente a un segmento de archivo FOCUS, y hasta 4096 en un segmento de archivo XFOCUS. Puede tener hasta 4095 bytes en un origen de datos secuencial de formato fijo. Puede definir la longitud en el archivo máster, o en un comando DEFINE FILE o COMPUTE.

Por ejemplo:

A522

The minutes of today's meeting were submitted...

A2

B3

A24

127-A429-BYQ-49

PRODCODE/A11 = EDIT (fieldname,'999-999-999') ;

Si el valor es 716431014, PRODCODE aparece como 716-431-014. Consulte el manual Cómo crear informes con el lenguaje WebFOCUS , para más información.

El formato de fecha le permite definir un campo como fecha, manipular su valor y mostrarlo de un modo apropiado a la fecha. Mediante el formato de fecha, puede:

• Definir componentes de fecha como el año, trimestre, mes, día o día de la semanana, y extraerlos fácilmente desde los campos de fecha.
• Clasificar informes en un secuencias de datos, independientemente de cómo aparece la fecha.
• Realizar operaciones aritméticas con las fechas y compararlas, sin necesidad de usar funciones especiales de manipulación de fechas.
• Referirse a las fechas de una forma natural, por ejemplo ENE 1 1995, sin prestar atención a los formatos de visualización y edición.
• Validar las fechas automáticamente en transacciones.

El formato de la fecha no especifica un tipo o una longitud. En cambio, especifica opciones de componente de fecha (D, W, M, Q, Y e YY) y opciones de visualización. Estas opciones aparecen en el diagrama siguiente.

D

M

Y

YY

T

t

TR

tr

Q

W

w

WR

wr

J[UL]or JULIAN

YYJ[UL]

I2M, A2M, I2MD, A2MD

YYMD

     *

     *

CC00/0m/dd

CC00/mm/dd

MDYY

     *

     *

     *

     *

DMYY

     *

     *

     *

     *

YMD

     *

     *

CC00/0m/dd

CC00/mm/dd

MDY

     *

     *

     *

     *

DMY

     *

     *

     *

     *

YYM

CC00/0m

 CC00/mm

CC0y/mm

CCyy/mm

MYY

     *

     *

     *

     *

YM

CC00/0m

 CC00/mm

CC0y/mm

CCyy/mm

MY

     *

     *

0m/CCyy

mm/CCyy

M

0m

mm

     *

     *

YYQ

CC00/q

CC0y/q

CCyy/q

0yyy/q

QYY

     *

     *

q/CCyy

     *

YQ

CC00/q

CC0y/q

CCyy/q

0yyy/q

QY

     *

     *

q/CCyy

     *

Q 

q

     *

     *

     *

JUL

00/00d

00/0dd

00/ddd

0y/ddd

YYJUL

CC00/00d

CC00/0dd

CC00/ddd

CC0y/ddd

YY 

000y

00yy

0yyy

yyyy

Y

0y

yy

     *

     *

D

0d

dd

     *

     *

W

w

      *

     *

     *

YYMD

CC0y/mm/dd

CCyy/mm/dd

0yyy/mm/dd

yyyy/mm/dd

MDYY

0m/dd/CCyy

mm/dd/CCyy

0m/dd/yyyy

mm/dd/yyyy

DMYY

0d/mm/CCyy

dd/mm/CCyy

0d/mm/yyyy

dd/mm/yyyy

YMD

CC0y/mm/dd

CCyy/mm/dd

0yyy/mm/dd

yyyy/mm/dd

MDY

0m/dd/CCyy

mm/dd/CCyy

0m/dd/yyyy

mm/dd/yyyy

DMY

0d/mm/CCyy

dd/mm/CCyy

0d/mm/yyyy

dd/mm/yyyy

YYM

0yyy/mm

yyyy/mm

      *

      *

MYY

0m/yyyy

mm/yyyy

      *

      *

YM

0yyy/mm

yyyy/mm

      *

      *

MY

0m/yyyy

mm/yyyy

      *

      *

M

      *

      *

      *

      *

YYQ

yyyy/q

      *

      *

      *

QYY

q/yyyy

      *

      *

      *

YQ

yyyy/q

      *

      *

      *

QY

q/yyyy

      *

      *

      *

Q

      *

      *

      *

      *

JUL

yy/ddd

      *

      *

      *

YYJUL

CCyy/ddd

0yyy/ddd

yyyy/ddd

      *

YY

      *

      *

      *

      *

Y

      *

      *

      *

      *

D

      *

      *

      *

      *

W

      *

      *

      *

      *

Puede controlar los separadores cuando aparece la fecha. En formatos de fecha básicos, como YMD o MDYY, los componentes de fecha están separados por una barra diagonal (/). Lo mismo sucede con el formato año-mes, que aparece con el año y el trimestre separados por un espacio (por ejemplo, 94 Q3 o Q3 1994). Los formatos de componente único solo muestran el número o nombre individual.

El carácter de separación también puede ser un punto, un guión o un espacio, o no aparecer. La tabla siguiente muestra las especificaciones de USAGE para cambiar el carácter de separación.

YMD

93/12/24

Y.M.D

93.12.24

Y-M

93-12

YBMBD

93 12 24

Y|M|D

931224

Los meses y días númericos pueden reemplazarse por una traslación, como ENE, Enero, Mié o Miércoles. El mes o día trasladado puede abreviarse en tres caracteres o estar completamente deletreado. Puede estar en mayúsculas o minúsculas. Además, el día de la semana (lunes, por ejemplo) puede añadirse al principio o al final de la fecha. Todas estas opciones son independientes entre sí.

MT

JAN

Mt

Jan

MTR

JANUARY

Mtr

January

WR

MONDAY

wr

Monday

El diagrama siguiente muestra los formatos de ejemplo USAGE y ACTUAL para datos almacenados en un origen de datos que no es FOCUS. La columna Valor muestra el valor de datos real, mientras que la columna Visualización indica cómo aparecen los datos.

wrMtrDYY

A6YMD

990315

Monday, March 15 1999

YQ

A6YMD

990315

99 Q1

QYY

A6YMD

990315

Q1 1999

YMD

A6

990315

99/03/15

MDYY

A6YMD

990315

03/15/1999

Los campos con formato de fecha se validan automáticamente al introducirse. Pueden introducirse como un literal de fecha natural (por ejemplo, ENE 12 1999) o numérico (por ejemplo, 011299).

Los literales de fechas naturales le permiten especificar la fecha de un modo natural e inteligible, basado en la inclusión de espacios entre los componentes de fecha y el uso de abreviaciones de los nombres del mes. Por ejemplo, Abril 25, 1999 puede especificarse como cualquiera de estps literales de fecha natural:

APR 25 1999
25 APR 1999
1999 APR 25

Los literales de fecha natural pueden usarse en cualquier cálculo de fecha o método de actualización de orígenes de datos. El código siguiente presenta ejemplos:

In WHERE screening                   WHERE MYDATE IS 'APR 25 1999'
In arithmetic expressions            MYDATE - '1999 APR 25'
In computational date comparisons    IF MYDATE GT '25 APR 1999'In comma-delimited data              ...,MYDATE = APR 25 1999, ...

El diagrama siguiente describe el formato de los literales de fechas naturales.

Los literales de fechas numéricas son diferentes de los literales de fechas naturales, ya que se tratan de simples cadenas de dígitos. El orden de los componentes de fecha en un literal de fecha numérica debe coincidir con el orden de los componentes de fecha de la especificación USAGE correspondiente. Además, el literal de fecha numérica debe incluir todos los componentes de fecha pertenecientes a la especificación USAGE. Por ejemplo, si la especificación de USAGE es DMY, Abril 25 1999 debe aparecer como:

250499

Los literales de fecha numérica pueden usarse en cualquier cálculo de fecha o método de actualización de orígenes de datos.

La norma general para manipular campos de fecha en expresiones aritméticas es que los campos de fecha que estén en la misma expresión deben especificar los mismos componentes de fecha. Los componentes de fecha pueden aparecer en cualquier orden; se ignoran las opciones de visualización. Y o YY, Q, M, W y D son componentes válidos.

Tenga en cuenta que las expresiones aritméticas asignadas a los trimestres, meses y días de la semana se calculan como módulo 4, 12 y 17, respectivamente, evitando así la presencia de anomalías como el quinto trimestre o el decimotercer mes.

Por ejemplo, si NEWQUARTER y THISQUARTER incluyen especificaciones USAGE para Q, y el valor de THISQUARTER es 2, la declaración siguiente establece un valor de 1 para NEWQUARTER (es decir, el resto de 5 dividido por 4):

NEWQUARTER = THISQUARTER + 3

Hay dos tipos de conversión: la conversión de formato y la conversión de componente de fecha. En el primer caso, el valor de un campo de formato de fecha puede asignarse a un campo alfanumérico o de número entero, que emplee opciones de visualización de fechas (consulte la próxima sección). También es posible realizar la conversión inversa.

En el segundo caso, puede asignar un campo, cuyo USAGE especifique un conjunto de componentes de fecha, a otro campo que especifique componentes de fecha distintos.

Por ejemplo, el valor de REPORTDATE (DMY) puede asignarse a ORDERDATE (Y). En este caso, se está extrayendo el año de REPORTDATE. Si REPORTDATE es Abr 27 99, ORDERDATE es 99.

También se puede asignar el valor de ORDERDATE a REPORTDATE. Si el valor de ORDERDATE es 99, el valor de REPORTDATE es Ene 1 99. En este caso, REPORTDATE recibe valores de los componente de fecha no disponibles.

field1/format = field2;

Los campos de fechas están representados internamente por números enteros binarios de cuatro bytes, que indican el tiempo transcurrido desde la fecha base del formato de fecha. En cada campo, la unidad de tiempo transcurrido es el componente de fecha más pequeño de ese campo.

Por ejemplo, si la especificación USAGE de REPORTDATE es MDY, el tiempo transcurrido se mide en días y, de modo interno, contendrá el número de días transcurridos entre la fecha introducida y la fecha base. Si introduce un literal numérico para Febrero 12, 1964 (es decir, 021364) y, a continuación, imprime el campo en un informe, aparecerá 02/13/64. Si lo emplea en la ecuación:

NEWDATE = 'FEB 28 1964' - REPORTDATE ;
DAYS/D = NEWDATE ;

el valor de DAYS es 15. Sin embargo, la representación interna de REPORTDATE es un número entero binario de cuatro dígitos, que representa el número de días entre Diciembre 31, 1900 y Febrero 13, 1964.

Al igual que la unidad de tiempo transcurrido, la fecha base también está basada en el componente de fecha más pequeño de un campo. Por ejemplo, en un campo YQ, el tiempo transcurrido se mide en trimestres y la fecha base es el primer trimestre de 1901. En un campo YM, el tiempo transcurrido se mide en meses y la fecha base es el primer mes de 1901.

Para mostrar espacios en blanco o la fecha base real en un informe, use el comando SET DATEDISPLAY, descrito en Cómo desarrollar aplicaciones de informes el manual . El valor predeterminado, OFF, muestra espacios en blanco cuando una fecha coincide con la fecha base. ON muestra el valor de la fecha base real.

No debe preocuparse por la representación interna del formato de la fecha, solo tenga en cuenta el hecho de que todas las fechas establecidas en la fecha base aparecen en blanco. Además, se aceptan e interpretan como la fecha base todos los campos de fechas introducidos en blanco o como ceros, durante la validación. Aunque aparecen como espacios en blanco, se interpretan como la fecha base en cálculos y expresiones de fechas.

Por defecto, si el campo de fecha de un origen de datos que no es FOCUS contiene una fecha no válida, se muestra un mensaje y el registro no aparece en el informe. Por ejemplo, si un campo de fecha contiene '980450', su ACTUAL especifica A6 y USAGE, YMD, el registro que contiene el campo no aparece. El comando SET ALLOWCVTERR le permite mostrar el resto del registro que contiene la fecha incorrecta.

SET ALLOWCVTERR = {ON|OFF}

DATEDISPLAY=ON

DATEDISPLAY=OFF

Los campos de formato de fecha se usan de un modo especial en los recursos siguientes:

• Dialogue Manager. Las variables ampersand pueden actuar como campos de fecha, si se han establecido en literales de fecha natural. Por ejemplo:

  -SET &NOW = 'APR 25 1960' ;
  -SET &LATER = '1990 25 APR' ;
  -SET &DELAY = &LATER - &NOW ;

  En este caso, el valor de &DELAY es la diferencia entre ambas fechas, medidas en días: 10,957.

• Archivos de extracción. Los campos de fecha en archivos SAVB y archivos HOLD sin formato, se almacenan como números enteros binarios de cuatro bytes, que representan la diferencia entre el valor nominal del campo y la fecha base estándar. Los campos de fecha en archivos SAVE y archivos HOLD sin formato (por ejemplo, USAGE WP), se almacenan sin ninguna opción de visualización.
• GRAPH. Las frases ACROSS y BY no admiten campos de fecha utilizados como campos de clasificación.
• FML. La declaración RECAP no admite campos de fecha.

Además de con el formato de fecha estándar, también puede representar una fecha utilizando un campo alfanumérico, de número entero o de decimal empaquetado, con opciones de visualización de fechas (D, M, Y, y T). Sin embargo, tenga en cuenta que no ofrece la misma capacidad que el formato de fecha estándar.

Los campos alfanuméricos y de número entero utilizados con opciones de visualización de fechas, ofrecen cierta funcionalidad a la hora de utilizarlos con las funciones de fecha especiales, como se explica en el manual Cómo crear informes con el lenguaje WebFOCUS .

Se puede especificar el año, mes y día, a la hora de representar fechas como campos alfanuméricos o de número entero, con opciones de visualización de fechas. Si se encuentran presentes estos tres elementos, la fecha tendrá seis dígitos (u ocho, si el año es de cuatro dígitos) y USAGE podría ser:

I6MDY

04/21/98

I6YMD

98/04/21

P6DMY

21/04/98

I8DMYY

21/04/1998

I6MTDY

05/21/98

MAY 21 98

I4MTY

0698

JUN 98

I2MT

07

JUL

Los datos de tipo fecha-hora admiten la fecha y la hora, de forma parecida a los tipos de datos de marca de tiempo, disponibles en muchos orígenes de datos relacionales.

Los campos de fecha-hora se almacenan en ocho, diez o doce bytes: cuatro bytes para la fecha y cuatro, seis u ocho bytes para la hora, dependiendo de si el formato especifica un microsegundo o un nanosegundo.

Los cálculos sólo permiten asignaciones directas en los tipos de datos: alfa con alfa, numéricos con numéricos, fecha con fecha y fecha y hora con fecha y hora. Todas las demás expresiones se logran mediante un conjunto de funciones de fecha y hora. Consulte el manual Cómo usar funciones , para más información sobre las subrutinas de manipulación de campos fecha-hora.

Los formatos de fecha-hora pueden producir valores de salida y aceptar valores de entrada compatibles con el estándar de notación de fecha-hora ISO 8601:2000. Esta notación está permitida gracias a un parámetro SET y opciones de formato específicas.

SET DTSTANDARD = {OFF|ON|STANDARD|STANDARDU}

SET DTSTANDARD = &STAND
DEFINE FILE EMPLOYEE
-* The following input is format YYYY-MM-DDThh:mm:ss.sTZD
DT1/HYYMDs  =     DT(2004-06-01T19:20:30.45+01:00);
-* The following input has comma as the decimal separator
DT2/HYYMDs  =     DT(2004-06-01T19:20:30,45+01:00);
DT3/HYYMDs  =     DT(20040601T19:20:30,45);
DT4/HYYMDUs =     DT(2004-06-01T19:20:30,45+01:00);
END
TABLE FILE EMPLOYEE
HEADING CENTER
"DTSANDARD = &STAND "
" "
SUM CURR_SAL NOPRINT DT1 AS 'DT1: INPUT = 2004-06-01T19:20:30.45+01:00'
OVER DT2 AS 'DT2: INPUT = 2004-06-01T19:20:30,45+01:00'
OVER DT3 AS 'DT3: INPUT = 20040601T19:20:30,45'
OVER DT4 AS 'DT4: OUTPUT  FORMAT HYYMDUs'
END

                      DTSANDARD = STANDARD
DT1: INPUT = 2004-06-01T19:20:30.45+01:00  2004-06-01 19:20:30.450
DT2: INPUT = 2004-06-01T19:20:30,45+01:00  2004-06-01 19:20:30.450
DT3: INPUT = 20040601T19:20:30,45          2004-06-01 19:20:30.450
DT4: OUTPUT  FORMAT HYYMDUs                2004-06-01T19:20:30.450

                      DTSANDARD = STANDARDU
DT1: INPUT = 2004-06-01T19:20:30.45+01:00  2004-06-01 18:20:30.450
DT2: INPUT = 2004-06-01T19:20:30,45+01:00  2004-06-01 18:20:30.450
DT3: INPUT = 20040601T19:20:30,45          2004-06-01 19:20:30.450
DT4: OUTPUT  FORMAT HYYMDUs                2004-06-01T18:20:30.450

En un archivo máster, el atributo USAGE (o FORMAT) determina cómo aparecen los valores de campos fecha-hora en la salida y formularios de informe, y su comportamiento en expresiones y funciones. En orígenes de datos FOCUS, también determina el modo en que se almacenan.

El formato de tipo H describe los campos de fecha-hora. El atributo USAGE de un campo fecha-hora, contiene el código de formato H e identifica la longitud del campo o las opciones relevantes de visualización de fecha-hora.

El atributo MISSING de los campos de fecha-hora puede estar activado o desactivado. Si está desactivado y el campo de fecha-hora no presenta un valor, se reestablece en un espacio en blanco, el valor predefinido.

USAGE = Hn

USAGE = Htimefmt1

H

h

I

i

S[x]

s

m

n

A

a

B

b

Z

USAGE = Hdatefmt [separator] [timefmt2]

Y

99

YY

1999

M

02

MT

February

Mt

Feb

D

05

d

5

k

USAGE = HMtDkYY

prints Feb 05, 1999

H

I

S[x]

s

m

n

A

a

B

b

Z

El formato de caracteres AnV se admite en archivos máster, para los orígenes de datos FOCUS, XFOCUS y relacionales. Este formato se usa para representar los datos de tipo VARCHAR (carácter de longitud variable), admitidos por los sistemas de administración de bases de datos relacionales.

En orígenes de datos relacionales, AnV realiza un seguimiento de la longitud real de una columna VARCHAR. Esta información resulta importante cuando el valor se utiliza para rellenar una columna VARCHAR en una RDBMS diferente. Determina si los espacios en blanco finales se retienen en la concatenación y comparación (en Oracle) de cadenas (el resto de motores relacionales ignora los espacios en blanco finales en comparaciones de cadenas).

En un orígenes de datos FOCUS o XFOCUS, AnV no admite caracteres de longitud verdaderamente variable. Es un campo de de caracteres, con una longitud fija y dos bytes iniciales adicionales, que contienen la longitud real de los datos almacenados en el campo. Esta longitud se almacena como un valor corto de número entero, que ocupa dos bytes. Los espacios en blanco finales, introducidos como parte de un campo AnV, están incluidos en su longitud.

Nota: Debido a los dos bytes de sobrecarga y el procesamiento adicional requerido para eliminarlos, no es recomendable usar el formato AnV en orígenes de datos no relacionales.

FIELD=name, ALIAS=alias, USAGE=AnV [,ACTUAL=AnV] , $

$ VARCHAR FIELD USING AnV
  FIELD=VARCHAR200, ALIAS=VC200, USAGE=A200V, ACTUAL=A200V, MISSING=ON ,$

FIELD=ALPHAV, ALIAS=AV200, USAGE=A200V, MISSING=ON ,$

FIELD=ALPHA, USAGE=A25, ACTUAL=A25V, $

DEFINE ...
  ALPHA/A25 = VARCHAR ;
END

COMPUTE ALPHA/A25 = VARCHAR ;

FIELD=VARCHAR, ,USAGE=A25V, ACTUAL=A25, $

DEFINE ...
  VARCHAR/A25V = ALPHA ;
END

COMPUTE VARCHAR/A25V = ALPHA ;

... USAGE=AnV, ACTUAL=AnW

FIELDNAME = TITLEV ,E03 ,A39V ,A39W ,$

FIELDNAME = 'TITLEV', 'TITLEV', A39V, A39V ,$

Puede almacenar cualquier combinación de caracteres como un archivo de texto.

FIELD = fieldname, ALIAS = aliasname, USAGE = TXn[F],$

TX50

This course provides the DP professional with the skills
needed to create, maintain, and report from FOCUS data
sources.

TX35

This course provides the DP professional with the skills needed to create, maintain, and report from FOCUS data sources.