Saltar al contenido principal Saltar al contenido complementario

addmonths - función de script y de gráfico

Esta función devuelve la fecha que figura n meses después de startdate o, si n es negativa, la fecha que figura n meses antes de startdate.

Sintaxis:  

AddMonths(startdate, n , [ , mode])

Tipo de datos que devuelve: dual

La función addmonths() suma o resta un número definido de meses, n, desde una fecha de inicio startdate y devuelve la fecha resultante.

El argumento de mode impactará en los valores de startdate en o a partir del día 28 de cada mes. Al establecer el argumento de mode en 1, la función addmonths() devuelve una fecha que es igual en distancia relativa al final del mes que la fecha startdate.

Ejemplo de diagrama de la función addmonths()

Diagrama de ejemplo que muestra cómo los diversos componentes de la función addmonths se unen para producir una fecha de salida.

Por ejemplo, el 28 de febrero es el último día del mes. Si la función addmonths(), con un mode de 1, se utiliza para devolver la fecha dos meses después, la función devolverá la última fecha de abril, el 30 de abril.

Diagrama de ejemplo de la función addmonths(), con mode=1

Diagrama de ejemplo que muestra cómo se puede modificar el argumento de "mode" para cambiar la fecha de salida de la función addmonths.
Argumentos
Argumento Descripción
startdate La fecha de inicio como una indicación de fecha, por ejemplo '2012-10-12'.
n El número de meses como un entero positivo o negativo.
mode Especifica si el mes se agrega en relación con el comienzo o el final del mes. El modo predeterminado es 0 para las adiciones relativas al comienzo del mes. Establezca el modo en 1 para las adiciones relativas al final del mes. Cuando el modo se establece en 1 y la fecha de entrada es 28 o superior, la función verifica cuántos días faltan para llegar al final del mes en la fecha de inicio. El mismo número de días para llegar al final del mes se establece en la fecha devuelta.

Cuándo se utiliza

La función addmonths() se utiliza normalmente en una expresión para encontrar una fecha un número determinado de meses antes o después de un período de tiempo.

Por ejemplo, la función addmonths() puede servir para identificar la fecha de finalización de los contratos de telefonía móvil.

Ejemplos de funciones
Ejemplo Resultado
addmonths ('01/29/2003' ,3) Devuelve "04/29/2003".
addmonths ('01/29/2003',3,0) Devuelve "04/29/2003".
addmonths ('01/29/2003',3,1) Devuelve "04/28/2003".
addmonths ('01/29/2003',1,0) Devuelve "02/28/2003".
addmonths ('01/29/2003',1,1) Devuelve "02/26/2003".
addmonths ('02/28/2003',1,0) Devuelve "03/28/2003".
addmonths ('02/28/2003',1,1) Devuelve "03/31/2003".
addmonths ('01/29/2003',-3) Devuelve "10/29/2002".

Configuraciones regionales

A menos que se especifique algo distinto, los ejemplos de este tema utilizan el siguiente formato de fecha: MM/DD/YYYY. El formato de fecha se especifica en la sentencia SET DateFormat de su script de carga de datos. El formato de fecha predeterminado puede ser diferente en su sistema, debido a su configuración regional y otros factores. Puede cambiar el formato en los ejemplos a continuación para ajustarlo a sus necesidades. O puede cambiar los formatos en su script de carga para que coincidan con estos ejemplos.

La configuración regional predeterminada en las aps se basa en la configuración del sistema regional de la computadora o servidor donde esté instalado Qlik Sense. Si el servidor de Qlik Sense al que está accediendo está configurado en Suecia, el editor de carga de datos utilizará la configuración regional sueca para las fechas, la hora y la moneda. Estos ajustes de formato regional no están relacionados con el idioma mostrado en la interfaz de usuario de Qlik Sense. Qlik Sense se mostrará en el mismo idioma que esté utilizando su navegador.

Ejemplo 1: sin argumentos adicionales

Ejemplo 2: Final de mes relativo

Ejemplo 3: ejemplo de objeto gráfico

Ejemplo 4: Escenario

¿Esta página le ha sido útil?

No dude en indicarnos en qué podemos mejorar si encuentra algún problema en esta página o su contenido, como, por ejemplo, errores tipográficos, pasos que falta o errores técnicos.