Descripción General #
La función AGREGAR del comando DateFx es una herramienta de cálculo temporal que permite proyectar fechas hacia el futuro o el pasado. Su objetivo es sumar o restar una cantidad específica de unidades de tiempo a una fecha base, esta función genera una nueva fecha como resultado.
Parámetros #
- Parámetro 1: Es la fecha inicial o fecha de partida. Este campo admite valor estático, variables definidas en el proceso o datos dinámicos obtenidos de la lectura de un archivo.
- Parámetro 2: Es la unidad de tiempoque se requieres sumar o restar (Días, Meses o Años). Este campo admite un número estático, variables definidas en el proceso o datos dinámicos obtenidos de la lectura de un archivo.
- Tipo de Dato: se debe indicar este parámetro, seleccionado la opción: DIAS, SEMANAS, MESES, AÑOS para configurar la unidad de tiempo.
- Guardar resultado: Variable donde se guarda la fecha resultante.
Usos más comunes #
- Cálculo de Fechas de Vencimiento: Es el uso más frecuente en procesos de facturación o legales. Ejemplo: Si una factura se emite hoy y tiene un plazo de pago de 15 días, el Bot usa la función Agregar + 15 Días para determinar la fecha límite exacta y registrarla en el sistema.
- Gestión de Contratos y Renovaciones: Para procesos de Recursos Humanos o Compras. Ejemplo: Si un contrato tiene una duración de un año, el bot toma la fecha de firma y Agrega + 1 Año para conocer la fecha exacta de expiración y enviar una alerta de renovación 30 días antes.
- Descargas de reportes: En estos procesos, es común requerir la información del día anterior. Mediante la función Agregar del comando DateFx, se puede restar un día a la fecha actual (-1) para calcular la fecha exacta y utilizarla como selector dinámico dentro del listado de una aplicación web.
Ejemplo de uso #
Supongamos que quieres calcular cuándo vence una suscripción que dura exactamente 3 meses a partir de ho. Resultado: Si hoy es 15/03/2026, la variable fecha_vencimiento almacenará 15/09/2026.
Pasos:
- Buscar el comando DateFx en la sección Utilitarios
- Seleccionar la función “HOY”
- Seleccionar la función “AGREGAR”
- Escribir en el archivo la fecha resultante
- Ejecutar y Revisar la evidencia
Tip: #
Si necesitas restar tiempo (por ejemplo, para obtener la fecha de hace una semana), simplemente coloca el valor en negativo en el parámetro de cantidad:
- Unidad: Días
- Cantidad: -7
- Resultado: Fecha de hace exactamente una semana.