La función CALENDARAUTO devuelve una tabla con una única columna llamada "Date" conteniendo un rango secuencial de fechas entre dos fechas extraídas automáticamente del modelo de datos (e incluidas en el rango).
CALENDARAUTO(
<fiscal_year_end_month>
)
- fiscal_year_end_month: Argumento opcional. Número entero entre el 1 y el 12 indicando el último mes del año fiscal (donde 1 corresponde a enero y 12 a diciembre). Si se omite, se toma el valor indicado en la plantilla de la tabla calendario del usuario actual -si existe-. En caso contrario toma el valor 12 (correspondiente a diciembre).
La función CALENDAR devuelve una tabla con una única columna llamada "Date".
El rango de fechas se calcula según las siguientes consideraciones:
- Como fecha inicial se considera la fecha más antigua que aparezca en el modelo de datos que no provenga de una columna calculada ni de una tabla calculada.
- Como fecha final se considera la última fecha más reciente en el modelo de datos que no provenga de una columna calculada ni de una tabla calculada.
- El rango de fechas devuelto será aquel que comience con el primer día del año fiscal correspondiente a la fecha inicial y que termine con el último día del año fiscal correspondiente a la fecha final.
En este ejemplo se parte de una tabla ("Ventas") conteniendo información sobre un conjunto de ventas, información que incluye la fecha en la que se produjo cada una:
A continuación se crea una tabla personalizada con la función CALENDARAUTO indicando como final del año fiscal el mes de diciembre. Nótese que todas las fechas incluidas en la tabla de ventas pertenecen, por lo tanto, al mismo año fiscal. La función extrae las fechas de inicio (15 de enero de 2016) y final (22 de febrero de 2016), calcula el comienzo del año fiscal para la fecha de inicio (1 de enero de 2016) y el final del año fiscal para la fecha de finalización (31 de diciembre de 2016) y devuelve una tabla con el rango de fechas entre el 1 de enero de 2016 y el 31 de diciembre de 2016:
Sin embargo, si definiésemos la tabla personalizada indicando como final del año fiscal el mes de enero, la fecha más antigua y la más reciente del modelo de datos ya no pertenecerían al mismo año fiscal (el 15 de enero de 2016 pertenece al año fiscal que arranca el 1 de febrero de 2015 y termina el 31 de enero de 2016, y el 22 de febrero de 2016 pertenece al año fiscal que arranca el 1 de febrero de 2016 y termina el 31 de enero de 2017), por lo que las fechas que limitan el rango a devolver cambian: el comienzo del año fiscal para la fecha de inicio sería, según se ha explicado, el 1 de febrero de 2015 y el final del año fiscal para la fecha de finalización sería el 31 de enero de 2017, por lo que la función CALENDARAUTO devuelve el rango de fechas entre ambas:
