Comando AGE

Información de concepto

Agrupa registros en períodos de antigüedad sobre la base de los valores de un campo de fecha o fechahora. Cuenta la cantidad de registros en cada período y también calcula el subtotal de campos numéricos especificados para cada período.

Sintaxis

AGE <ON> campo_fecha <CUTOFF fecha_de_corte> <INTERVAL días <;...n>> <SUPPRESS> <SUBTOTAL campo_numérico <...n>|SUBTOTAL ALL <EXCLUDE campo_numérico <...n>>> <IF prueba> <WHILE prueba> <FIRST rango|NEXT rango> <TO {SCREEN|nombre_de_archivo|GRAPH|PRINT}> <KEY salto_campo> <HEADER texto_encabezado> <FOOTER texto_pie_de_página> <APPEND> <STATISTICS>

Parámetros

Nombre	Descripción
ON campo_fecha	El nombre del campo de fecha o de fechahora, o la expresión cuya antigüedad se determinará. A pesar de que puede determinar la expiración de un campo de fechahora, solo se considerará la porción fecha de los valores de fechahora. La porción de hora se ignora. No se puede establecer la expiración sobre los datos de la hora solamente.
CUTOFF fecha_de_corte opcional	La fecha con la que se comparan los valores de campo_fecha. Debe especificar la fecha_de_corte como una cadena sin comillas con el formato AAMMDD o AAAAMMDD, independientemente del formato del campo de fecha. Por ejemplo: CUTOFF 20141231 Si omite CUTOFF, se usará la fecha del sistema actual como la fecha de corte.
INTERVAL días <;...n> opcional	Los intervalos de fechas (es decir, la cantidad de días) que se deben utilizar para calcular los períodos de antigüedad. días representa el inicio de cada período de antigüedad que se mide hacia atrás a partir de la fecha_de_corte: el primer valor de días identifica el inicio del primer período de antigüedad un primer valor de días de '0' especifica que el primer período de antigüedad comienza en la fecha_de_corte especificada. el último valor de días identifica el final del último período de antigüedad Debe especificar los intervalos como una cadena sin comillas con valores separados por punto y coma: INTERVAL 0;90;180;270;365 Los períodos predeterminados de expiración son 0; 30; 60; 90; 120 y 10.000 días. Para aislar registros con fechas que probablemente no sean válidas, se usa un intervalo de 10.000 días. Si es necesario, los intervalos de fechas se pueden personalizar para que coincidan con otros reportes internos de antigüedad.
SUPPRESS opcional	Suprime las fechas que caen fuera del período de antigüedad de la salida del comando.
SUBTOTAL campo_numérico <...n> \| SUBTOTAL ALL opcional	Uno o más campos numéricos o expresiones que se subtotalizarán para cada grupo. Múltiples campos se deben separar con espacios. Especifique ALL para calcular subtotales de todos los campos numéricos de la tabla.
EXCLUDE campo_numérico opcional	Solo tiene validez al usar SUBTOTAL ALL. El o los campos que se deben excluir del comando. EXCLUDE le permite ajustar SUBTOTAL ALL, excluyendo campos específicos. EXCLUDE debe ir inmediatamente a continuación de SUBTOTAL ALL. Por ejemplo: SUBTOTAL ALL EXCLUDE campo_1 campo_2
IF prueba opcional	Una expresión condicional que debe ser verdadera para procesar cada registro. El comando se ejecuta únicamente en los registros que cumplen la condición. Nota El parámetro IF se evalúa únicamente con los registros que quedan en la tabla después de aplicar los parámetros de alcance (WHILE, FIRST, NEXT).
WHILE prueba opcional	Una expresión condicional que debe ser verdadera para procesar cada registro. El comando se ejecuta hasta que la condición se evalúa como falsa o hasta que se llega al final de la tabla. Nota Si usa WHILE junto con FIRST o NEXT, el procesamiento de registros se detiene al llegar a un límite.
FIRST rango \| NEXT rango opcional	La cantidad de registros que se procesarán: FIRST comienza a procesar desde el primer registro hasta que se llega al número de registros especificado NEXT comienza a procesar desde el registro seleccionado actualmente hasta que se llega al número de registros especificado Utilice intervalo para especificar la cantidad de registros que se deben procesar. Si omite FIRST y NEXT, se procesan todos los registros de forma predeterminada.
TO SCREEN \| nombre_archivo \| GRAPH \| PRINT	El lugar al que se deben enviar los resultados del comando: SCREEN muestra los resultados en el área de visualización de Analytics Consejo Puede hacer clic en cualquier valor de resultado enlazado en el área de visualización para ver con mayor detalle el o los registros asociados de la tabla de origen. nombre_de_archivo guarda los resultados en un archivo Especifique el nombre_de_archivo como una cadena entre comillas con la extensión de archivo adecuada. Por ejemplo: TO "Salida.TXT" Por valor predeterminado, el archivo se guarda en la carpeta que contiene el proyecto de Analytics. Utilice una ruta de archivo absoluta o relativa para guardar el archivo en una carpeta existente o una diferente: TO "C:\Salida.TXT" TO "Resultados\Salida.TXT" GRAPH muestra los resultados en un gráfico en el área de visualización de Analytics PRINT envía los resultados a la impresora predeterminada
KEY salto_campo opcional	El campo o la expresión que agrupa los cálculos de subtotal de grupos. Se calcula un subtotal cada vez que cambia el valor de salto_campo. salto_campo debe ser un campo de caracteres o una expresión. Puede especificar un solo campo, pero puede usar una expresión que contenga más de un campo.
HEADER texto_encabezado opcional	El texto que se debe insertar en la parte superior de cada página de un reporte. texto_encabezado_de_página se debe especificar como una cadena entre comillas. El valor anula la variable de sistema HEADER de Analytics.
FOOTER texto_pie_de_página opcional	El texto que se debe insertar en la parte inferior de cada página de un reporte. texto_pie_de_página se debe especificar como una cadena entre comillas. El valor anula la variable de sistema FOOTER de Analytics.
APPEND opcional	Anexa la salida del comando al final de un archivo existente en lugar de sobrescribir el archivo. Nota Debe asegurarse de que la estructura de la salida del comando y del archivo existente sean idénticas: los mismos campos el mismo orden de campos los campos coincidentes son de la misma longitud los campos coincidentes tienen el mismo tipo de datos Analytics anexa la salida a un archivo existente sin importar cuál sea su estructura. Si la estructura de la salida y la del archivo existente no coinciden, es posible que los datos que se obtengan estén incompletos, mezclados o sean imprecisos.
STATISTICS opcional	Nota No se puede usar, a menos que también se especifique SUBTOTAL. Calcula los valores promedio, mínimo y máximo para todos los campos SUBTOTAL.

Ejemplos

Clasificar las facturas por antigüedad con subtotales de importes

Desea clasificar por antigüedad una tabla de cuentas por cobrar a partir del campo Importe_factura y calcular el subtotal del campo Importe_factura.

Las facturas se agrupan en períodos de 30 días:

desde la fecha de corte hasta los 29 días anteriores
desde los 30 días anteriores a los 59 días anteriores
y así sucesivamente

Los resultados incluyen el importe de factura total pendiente para cada período:

OPEN Cuentas_por_cobrar
AGE ON Fecha_de_factura CUTOFF 20141231 INTERVAL 0;30;60;90;120;10000 SUBTOTAL Importe_factura TO SCREEN

Observaciones

Si desea obtener más información sobre la forma en la que funciona este comando, consulte Datos de antigüedad.

Períodos de expiración

El comando AGE agrupa los registros en períodos de antigüedad sobre la base de los valores de un campo de fecha o fechahora. Los resultados de la salida contienen un registro único para cada período, con un recuento de la cantidad de registros en la tabla de origen que caen dentro de cada período.

Medición del intervalo

Los periodos de expiración se basan en intervalos de fechas (es decir, cantidad de días) que se miden hacia atrás en el tiempo desde la fecha actual del sistema o desde una fecha tope especificada por usted, tal como la fecha límite de un periodo fiscal.

Períodos futuros

Puede crear períodos de antigüedad más recientes que la fecha de corte si introduce valores negativos para los intervalos de fechas. Por ejemplo, la siguiente sintaxis crea períodos de antigüedad que van hacia delante y hacia atrás de la fecha de corte:

INTERVAL -60;-30;0;30;60;90

Este enfoque crea un perfil de datos para todos los registros de la tabla utilizando diferentes puntos en el tiempo.

Casos de uso común

Algunos usos comunes de la expiración incluyen la evaluación de tendencias de ventas, la revisión de volúmenes de transacción y la agrupación de facturas por número de días pendientes.

Analytics crea automáticamente uno o dos períodos de antigüedad adicionales para cualquier fecha que caiga fuera de los períodos de antigüedad especificados, suponiendo que no se esté utilizando SUPPRESS.