Saltar al contenido principal Saltar al contenido complementario

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

Esta función determina si una fecha-hora se encuentra dentro del mismo periodo mensual, bimensual, trimestral, cuatrimestre o semestral que fecha base. También es posible hallar si la fecha-hora cae dentro de un periodo anterior o posterior.

Sintaxis:  

InMonths(n_months, timestamp, base_date, period_no [, first_month_of_year])

Tipo de datos que devuelve: Booleano

En Qlik Sense, el valor booleano verdadero viene representado por -1 y el valor falso está representado por 0.

Diagrama de la función inmonths()

Diagrama que muestra el intervalo de tiempo en el que la función inmonths() evaluará una fecha base como verdadera o falsa.

La función inmonths() divide el año en segmentos basándose en el argumento n_months proporcionado. Luego determina si cada marca de tiempo evaluada cae en el mismo segmento que el argumento de base_date. Sin embargo, si se proporciona un argumento period_no, la función determina si las marcas de tiempo caen en un período anterior o posterior a base_date.

Los siguientes segmentos del año están disponibles en la función n_month como argumentos.

Argumentos de n_month
Periodo Número de meses
mes 1
bimestre 2
trimestre 3
cuatrimestre 4
semestre 6

La función inmonths() devuelve un resultado booleano. Normalmente, este tipo de función se utilizará como condición en una if expression. Mediante el uso de la función inmonths(), puede seleccionar el período que desea evaluar. Por ejemplo, permitir que el usuario identifique los productos fabricados en el mes, trimestre o semestre de un período determinado.

Tipo de datos que devuelve: Booleano

En Qlik Sense, el valor booleano verdadero viene representado por -1 y el valor falso está representado por 0.

Argumentos
Argumento Descripción
n_months

El número de meses que define el periodo. Un entero o expresión que devuelve un entero que debe ser uno de los siguientes: 1 (equivalente a la función inmonth() ), 2 (bimestral), 3 (equivalente a la función inquarter()), 4 (cuatrimestral) o 6 (medio año).

timestamp La fecha que desea comparar con base_date.
base_date La fecha que se utiliza para evaluar el periodo.
period_no

El período se puede desplazar mediante period_no, un entero o una expresión que devuelve un entero, donde el valor 0 indica el período que contiene a base_date. Los valores negativos en period_no indican períodos precedentes y los valores positivos indican períodos subsiguientes.

first_month_of_year

Si desea trabajar con años (fiscales) que no comiencen en enero, indique un valor entre 2 y 12 en first_month_of_year.

Puede utilizar los siguientes valores para establecer el primer mes del año en el argumento first_month_of_year:

first_month_of_year values
Month Valor
Febrero 2
Marzo 3
Abril 4
May 5
Junio 6
Julio 7
Agosto 8
Septiembre 9
Octubre 10
Noviembre 11
Diciembre 12

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.

Ejemplos de funciones
Ejemplo Resultado
inmonths(4, '01/25/2013', '04/25/2013', 0)Devuelve TRUE. Porque el valor de la marca de tiempo 25/01/2013 se encuentra dentro del período de cuatro meses: 01/01/2013 a 30/04/2013, en el que se encuentra el valor de base_date, 25/04/2013.
inmonths(4, '05/25/2013', '04/25/2013', 0)Devuelve FALSE. Porque el 25/05/2013 está fuera del mismo periodo que el ejemplo anterior.
inmonths(4, '11/25/2012', '02/01/2013', -1 )Devuelve TRUE. Porque el valor de period_no, -1, desplaza el período de búsqueda hacia atrás un período de cuatro meses (el valor de n-meses), lo que hace que el período de búsqueda sea del 01/09/2012 al 31/12/2012.
inmonths(4, '05/25/2006', '03/01/2006', 0, 3)Devuelve TRUE. Porque el valor de first_month_of_year  está establecido en 3, lo que hace que el período de búsqueda sea del 01/03/2006 al 30/07/2006 en lugar de 01/01/2006 al 30/04/2006.

Ejemplo 1: sin argumentos adicionales

Ejemplo 2: period_no

Ejemplo 3: first_month_of_year

Ejemplo 4: ejemplo de objeto gráfico

Ejemplo 5: 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.