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()
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
| 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.
| 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 en su navegador.
Ejemplo 1: sin argumentos adicionales
Vista general
Abra el editor de carga de datos y agregue el script de carga a continuación a una nueva pestaña.
El script de carga contiene:
Un conjunto de datos que contiene un conjunto de transacciones entre 2020 y 2022, que se carga en una tabla llamada "Transactions".
El campo de fecha proporcionado en el formato de la variable del sistema DateFormat: (MM/DD/AAAA).
La creación de un campo, two_months_later, que devuelve la fecha correspondiente a dos meses después de que se haya realizado la transacción.
Script de carga
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*,
addmonths(date,2) as two_months_later
;
Load
*
Inline
[
id,date,amount
8188,'01/10/2020',37.23
8189,'02/28/2020',17.17
8190,'04/09/2020',88.27
8191,'04/16/2020',57.42
8192,'05/21/2020',53.80
8193,'08/14/2020',82.06
8194,'10/07/2020',40.39
8195,'12/05/2020',87.21
8196,'01/22/2021',95.93
8197,'02/03/2021',45.89
8198,'03/17/2021',36.23
8199,'04/23/2021',25.66
8200,'05/04/2021',82.77
8201,'06/30/2021',69.98
8202,'07/26/2021',76.11
8203,'12/27/2021',25.12
8204,'02/02/2022',46.23
8205,'02/26/2022',84.21
8206,'03/07/2022',96.24
8207,'03/11/2022',67.67
];Resultados
Cargue los datos y abra una hoja. Cree una nueva tabla y agregue estos campos como dimensiones:
date
two_months_later
| date | two_months_later |
|---|---|
| 01/10/2020 | 03/10/2020 |
| 02/28/2020 | 04/28/2020 |
| 04/09/2020 | 06/09/2020 |
| 04/16/2020 | 06/16/2020 |
| 05/21/2020 | 07/21/2020 |
| 08/14/2020 | 10/14/2020 |
| 10/07/2020 | 12/07/2020 |
| 12/05/2020 | 02/05/2021 |
| 01/22/2021 | 03/22/2021 |
| 02/03/2021 | 04/03/2021 |
| 03/17/2021 | 05/17/2021 |
| 04/23/2021 | 06/23/2021 |
| 05/04/2021 | 07/04/2021 |
| 06/30/2021 | 08/30/2021 |
| 07/26/2021 | 09/26/2021 |
| 12/27/2021 | 02/27/2022 |
| 02/02/2022 | 04/02/2022 |
| 02/26/2022 | 04/26/2022 |
| 03/07/2022 | 05/07/2022 |
| 03/11/2022 | 05/11/2022 |
El campo "two_months_later" se crea en la instrucción load anterior, mediante el uso de la función addmonths(). El primer argumento proporcionado identifica qué fecha se está evaluando. El segundo argumento es el número de meses que hay que sumar o restar a startdate. En este caso, se proporciona el valor de 2.
Diagrama de la función addmonths(), ejemplo sin argumentos adicionales
La transacción 8193 tuvo lugar el 14 de agosto. Por lo tanto, la función addmonths() devuelve el 14 de octubre de 2020 para el campo two_months_later.
Ejemplo 2: Final de mes relativo
Vista general
Abra el editor de carga de datos y agregue el script de carga a continuación a una nueva pestaña.
El script de carga contiene:
Un conjunto de datos que contiene un conjunto de transacciones de fin de mes de 2022, que se carga en una tabla llamada Transactions.
El campo de fecha proporcionado en el formato de la variable del sistema DateFormat: (MM/DD/AAAA).
La creación de un campo, relative_two_months_prior, que devuelve la fecha relativa de fin de mes de dos meses antes de que se realizara la transacción.
Script de carga
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*,
addmonths(date,-2,1) as relative_two_months_prior
;
Load
*
Inline
[
id,date,amount
8188,'01/28/2022',37.23
8189,'01/31/2022',57.54
8190,'02/28/2022',17.17
8191,'04/29/2022',88.27
8192,'04/30/2022',57.42
8193,'05/31/2022',53.80
8194,'08/14/2022',82.06
8195,'10/07/2022',40.39
];Resultados
Cargue los datos y abra una hoja. Cree una nueva tabla y agregue estos campos como dimensiones:
date
relative_two_months_prior
| date | relative_two_months_prior |
|---|---|
| 01/28/2022 | 11/27/2021 |
| 01/31/2022 | 11/30/2021 |
| 02/28/2022 | 12/31/2021 |
| 04/29/2022 | 02/27/2022 |
| 04/30/2022 | 02/28/2022 |
| 05/31/2022 | 03/31/2022 |
| 08/14/2022 | 06/14/2022 |
| 10/07/2022 | 08/07/2022 |
El campo relative_two_months_prior se crea en la instrucción de carga anterior mediante el uso de la función addmonths(). El primer argumento proporcionado identifica qué fecha se está evaluando. El segundo argumento es el número de meses que hay que sumar o restar a startdate. En este caso, se proporciona el valor de -2. El último argumento es la moda, con un valor de 1, que obliga a la función a calcular la fecha relativa de fin de mes para todas las fechas mayores o iguales que 28.
Diagrama de la función addmonths(), ejemplo con n=-2
La transacción 8191 tiene lugar el 29 de abril de 2022. Inicialmente, dos meses antes fijaría el mes en febrero. Entonces, debido a que el tercer argumento de la función establece el modo en 1 y el valor del día es posterior al 27, la función calcula el valor relativo de fin de mes. La función identifica que el 29 es el penúltimo día de abril y por tanto devuelve el penúltimo día de febrero, el 27.
Ejemplo 3: ejemplo de objeto gráfico
Vista general
Abra el editor de carga de datos y agregue el script de carga a continuación en una nueva pestaña.
El script de carga contiene el mismo conjunto de datos y escenario que el primer ejemplo.
Sin embargo, en este ejemplo, el conjunto de datos sin modificar se carga en la aplicación. El cálculo que devuelve la fecha de dos meses posteriores a la realización de la transacción se crea como una medida en un objeto gráfico.
Script de carga
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*
Inline
[
id,date,amount
8188,'01/10/2020',37.23
8189,'02/28/2020',17.17
8190,'04/09/2020',88.27
8191,'04/16/2020',57.42
8192,'05/21/2020',53.80
8193,'08/14/2020',82.06
8194,'10/07/2020',40.39
8195,'12/05/2020',87.21
8196,'01/22/2021',95.93
8197,'02/03/2021',45.89
8198,'03/17/2021',36.23
8199,'04/23/2021',25.66
8200,'05/04/2021',82.77
8201,'06/30/2021',69.98
8202,'07/26/2021',76.11
8203,'12/27/2021',25.12
8204,'02/02/2022',46.23
8205,'02/26/2022',84.21
8206,'03/07/2022',96.24
8207,'03/11/2022',67.67
];Resultados
Cargue los datos y abra una hoja. Cree una nueva tabla y agregue este campo como dimensión: date.
Cree la siguiente medida:
=addmonths(date,2)
| date | =addmonths(date,2) |
|---|---|
| 01/10/2020 | 03/10/2020 |
| 02/28/2020 | 04/28/2020 |
| 04/09/2020 | 06/09/2020 |
| 04/16/2020 | 06/16/2020 |
| 05/21/2020 | 07/21/2020 |
| 08/14/2020 | 10/14/2020 |
| 10/07/2020 | 12/07/2020 |
| 12/05/2020 | 02/05/2021 |
| 01/22/2021 | 03/22/2021 |
| 02/03/2021 | 04/03/2021 |
| 03/17/2021 | 05/17/2021 |
| 04/23/2021 | 06/23/2021 |
| 05/04/2021 | 07/04/2021 |
| 06/30/2021 | 08/30/2021 |
| 07/26/2021 | 09/26/2021 |
| 12/27/2021 | 02/27/2022 |
| 02/02/2022 | 04/02/2022 |
| 02/26/2022 | 04/26/2022 |
| 03/07/2022 | 05/07/2022 |
| 03/11/2022 | 05/11/2022 |
La medida two_months_later se crea en el objeto gráfico usando la función addmonths(). El primer argumento proporcionado identifica qué fecha se está evaluando. El segundo argumento es el número de meses que hay que sumar o restar a startdate. En este caso, se proporciona el valor de 2.
Diagrama de la función addmonths(), ejemplo de objeto gráfico
La transacción 8193 tuvo lugar el 14 de agosto. Por lo tanto, la función addmonths() devuelve el 14 de octubre de 2020 para el campo two_months_later.