Descripción General #
«DateFx» es una funcionalidad de STELA que te permite trabajar fácilmente con fechas. Imagina que necesitas obtener la fecha de hoy, calcular la diferencia entre dos fechas, o agregar días a una fecha específica. «DateFx» hace todo esto posible. Puedes aplicar diferentes funciones a las fechas y guardar los resultados para usarlos en tus flujos de trabajo de automatización.
Ejemplo de Uso Rápido #
Imagina que estás creando un flujo de trabajo en STELA para organizar eventos. Necesitas saber la fecha exacta de hoy para enviar recordatorios. Con «DateFx», puedes seleccionar la función «Hoy» y guardarla en una variable. Luego, puedes usar esa variable en otro paso de tu flujo de trabajo para enviar automáticamente un mensaje a los participantes del evento con la fecha correcta.
Parámetros y Opciones #
- Función: Este es un menú desplegable donde eliges la operación que quieres realizar con la fecha. Las opciones disponibles son:
- Día de la semana
- Hoy
- Año
- Mes
- Día
- Diferencia entre fechas
- Agregar
- Diferencia entre horas
- Parámetro 1: Aquí introduces la primera información que la función necesita. Por ejemplo, si eliges la función «Día de la semana», aquí pondrías la fecha de la que quieres saber el día.
- Parámetro 2: Algunas funciones necesitan una segunda información. Por ejemplo, «Diferencia entre fechas» necesita dos fechas, y aquí pondrías la segunda.
- Tipo de dato: Esta opción se usa con la función «Agregar» para especificar si quieres sumar días, semanas, meses o años.
- Variable: Aquí defines el nombre de la variable donde se guardará el resultado de la función.
Formatos de fechas soportados por STELA:
DateFx entiende las fechas en estos formatos:
- d/m/yy
- d/m/yyyy
- d/mm/yy
- d/mm/yyyy
- dd/m/yy
- dd/m/yyyy
- dd/mm/yy
- dd/mm/yyyy
A continuación se explicará qué datos colocar en cada parámetro dependiendo de la función seleccionada.
- Función mes: Esta función retorna el mes actual y lo guarda en la variable resultado. Esta función no utiliza información de los parámetros (en caso de que venga algo en ellos, se ignora)
- Función año: Esta función retorna el año actual y lo guarda en la variable resultado. Esta función no utiliza información de los parámetros (en caso de que venga algo en ellos, se ignora). El año se devuelve en formato yyyy (ej 2025)
- Función día: Esta función retorna el día actual y lo guarda en la variable resultado. Esta función no utiliza información de los parámetros (en caso de que venga algo en ellos, se ignora). El día se devuelve en formato dd (ej 07)
- Función día de la semana: Esta función retorna para una fecha dada a qué día de la semana corresponde y lo guarda en la variable “resultado”. Lo devuelve en formato Lunes, Martes, etc. Esta función toma del parámetro 1 la fecha a procesar (de la cual se va a obtener el día de la semana). El día de la semana se retorna por su nombre y en el idioma en que se está realizando la ejecución.
- Función hoy: Esta función retorna la fecha del día actual y la guarda en la variable “resultado”. Esta función no utiliza información de los parámetros (en caso de que venga algo en ellos, se ignora). La fecha se devuelve en formato dd/mm/yyyy (ej 17/04/2025)
- Función diferencia entre fechas: Esta función retorna la cantidad de días que hay entre dos fechas (número entero) y lo guardará en la variable de retorno. Esta función tomará dos fechas que vienen dadas en Parámetro 1 y Parámetro 2 (Fecha1 y Fecha2 respectivamente) y calculará la cantidad de días que hay entre Fecha1 y Fecha2.
En caso de que Fecha1 sea mayor que Fecha2 se retornará un valor negativo en la cantidad de días (resultado de hacer Fecha2 – Fecha1 para calcular la cantidad de días). Esto también servirá para poder usar esta función para determinar cuál es la más grande entre dos fechas.
Ejemplos:
Fecha1 = 17/04/2023, Fecha2 = 18/04/2023 = 1
Fecha1 = 17/04/2023, Fecha2 = 17/4/23 = 0
Fecha1 = 17/04/2023, Fecha2 = 7/4/2022 = -375
- Función agregar: Esta función toma una fecha como base y le sumará una X cantidad de días/semanas/meses/años. El resultado será una nueva fecha que será retornada en la variable resultado con el formato dd/mm/yyyy.
La fecha base debe colocarse en el parámetro 1. En caso de que este parámetro no represente una fecha válida se devolverá un error en el comando indicando que uno de los parámetros no es válido.
Del 2do parámetro se obtendrá la cantidad de días / semanas / meses / años a sumar. Este valor es un entero que puede ser negativo, en cuyo caso, se restará el correspondiente valor. En caso de que el valor no sea un entero válido se devolverá un error en el comando indicando que uno de los parámetros no es válido.
Esta función utilizará el parámetro TIPO para determinar si el valor a sumar representa una cantidad de días / semanas / meses / años
Se retorna la fecha resultada tras agregar los días / semanas / meses / años indicados
Ejemplos de Uso Avanzado #
- Calcular la fecha de vencimiento: Supongamos que estás automatizando el seguimiento de facturas. Puedes usar «DateFx» con la función «Agregar» para calcular la fecha de vencimiento sumando 30 días a la fecha de emisión de la factura.
- Determinar cuántos días faltan para un evento: Si tienes la fecha de un evento y quieres saber cuántos días faltan, puedes usar la función «Diferencia entre fechas». Ingresas la fecha del evento y la fecha de hoy, y «DateFx» te dirá la cantidad de días restantes.
- Obtener el día de la semana de una fecha específica: Imagina que necesitas programar una tarea para un día específico de la semana. Con la función «Día de la semana», puedes ingresar una fecha y «DateFx» te dirá si es lunes, martes, miércoles, etc.
Errores Comunes y Soluciones #
- Error: «Uno de los parámetros no es válido».
- Solución: Este error ocurre principalmente con la función «Agregar». Asegúrate de que la fecha en el Parámetro 1 esté en uno de los formatos soportados por STELA y que el valor en el Parámetro 2 sea un número entero.
Casos de Uso #
- Automatización de tareas repetitivas: Como calcular fechas de vencimiento, programar recordatorios o generar informes con fechas precisas.
- Captura de datos visuales: «DateFx» puede ser parte de flujos de trabajo que procesan información visual que incluye fechas, como extraer fechas de documentos escaneados.