DTADD: Cómo incrementar un componente de fecha o fecha-hora

Para la fecha en formato estándar o fecha-hora, DTADD devuelve una fecha nueva tras añadir el número específico de un componente compatible. El formato de fecha devuelto es el mismo que el de la fecha introducida.

Sintaxis: Cómo Incrementar un componente de fecha o fecha-hora

DTADD(date, component, increment)

donde:

date

Fecha o fecha-hora

Es el valor de fecha o fecha-hora que se va a incrementar.

component

Palabra clave

Es el componente que se va a incrementar. Los componentes válidos (y componentes aceptables) son:

YEAR (1-9999)
QUARTER (1-4)
MONTH (1-12)
WEEK (1-53). Esto está determinado por la propiedad WEEKFIRST.
DAY (del mes, 1-31)
HOUR (0-23)
MINUTE (0-59)
SECOND (0-59)

increment

Número entero

El valor (positivo o negativo) que se va a añadir al componente.

Principio de página

Ejemplo: cómo incrementar el componente DAY de una fecha

La siguiente solicitud, basada en el origen de datos WF_RETAIL_, añade tres días a la fecha de nacimiento del empleado:

DEFINE FILE WF_RETAIL
NEWDATE/YYMD = DTADD(DATE_OF_BIRTH, DAY, 3);
MGR/A3 = DIGITS(ID_MANAGER, 3);
END
TABLE FILE WF_RETAIL
SUM MGR NOPRINT DATE_OF_BIRTH NEWDATE
BY MGR
ON TABLE SET PAGE NOPAGE
END

La salida es:

Referencia: Notas de uso de DTADD

Cada elemento debe ser manipulado por separado. Por tanto, si quiere añadir 1 año y 1 día a una fecha, debe llamar dos veces a la función, una para YEAR (teniendo en cuenta los años bisiestos), y otra para DAY. Puede anidar las funciones simplificadas en una expresión, o crearla y aplicarla por separado en expresiones DEFINE o COMPUTE.
En cuanto a la validación de parámetros, DTADD sólo permite el uso de un valor de fecha estándar o fecha-hora, en el primer parámetro.
Aunque no se verifica el incremento, el usuario debe tener en cuenta que los números decimales no están permitidos y, por tanto, quedarán truncados (si los hay). Cualquier combinación de valores que incremente YEAR más allá de 9999, devolverá la fecha de entrada como un valor, sin mensaje. Si el usuario recibe la fecha de entrada de forma inesperada, lo más seguro es que sea por error.