---
title: DateFx – Agregar
description: "##### **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…"
url: "https://www.stela.ai/wiki/datefx-agregar/"
updated: "2026-03-17"
category: Comandos Utilitarios
---

# DateFx – Agregar

##### **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**:

1. Buscar el comando **DateFx** en la sección Utilitarios
2. Seleccionar la función “**HOY**”
3. Seleccionar la función “**AGREGAR**”

![DateFx - Agregar](https://www.stela.ai/wp-content/uploads/2026/03/image-68.jpg)

- Escribir en el archivo la fecha resultante

![DateFx - Agregar](https://www.stela.ai/wp-content/uploads/2026/03/image-69.jpg)

- Ejecutar y Revisar la evidencia

![DateFx - Agregar](https://www.stela.ai/wp-content/uploads/2026/03/image-40-1024x435.png)

![Log STELA](https://www.stela.ai/wp-content/uploads/2026/03/image-41.png)

##### **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.