DateFx: Permite aplicar una función, indicando parámetros si es necesario, y guardar el resultado de la función.
Parámetros #
- Función: Menú desplegable con las funciones posibles a utilizar. Dia de la semana/ Hoy/ Año/ Mes/ Día/ Diferencia entre fechas/ Agregar.
- Parámetro 1: Parámetro por el que se envía información a la función, si así lo requiere.
- Parámetro 2: Parámetro por el que se envía información a la función, si así lo requiere (lo que va en este campo depende de la función que se utiliza).
- Tipo de dato: Tipo de dato que se desea utilizar para la función. Días/Semanas/Meses/Años.
- Variable: Variable donde vamos a guardar el resultado de la función.
Formatos de fechas soportados por STELA:
- 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 2023)
- 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/2023)
- 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