Saltar al contenido principal Saltar al contenido complementario

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

Esta función determina si una fecha-hora se encuentra dentro de la parte de un período mensual, bimensual, trimestral, cuatrimestral o semestral hasta e incluyendo el último milisegundo de base_date. 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

Diagrama de la función inmonthstodate.

Diagrama que muestra cómo se puede usar la función inmonthstodate para identificar si una marca de tiempo se encuentra dentro o fuera de un segmento de tiempo establecido.
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.

En la función inmonthstodate(), la base_date actúa como el punto final del segmento de año en particular del que forma parte.

Por ejemplo, si el año se dividió en segmentos cuatrimestrales y la base_date era el 15 de mayo, cualquier marca de tiempo entre el comienzo de enero y el final de abril devolvería un resultado booleano de FALSE. Las fechas entre el 1 y el 15 de mayo devolverían TRUE. El resto del año devolvería FALSE.

Diagrama del rango de resultados booleanos de la función inmonthstodate.

Diagrama que muestra el rango de resultados booleanos de la función inmonthstodate.

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 inmonthstodate() devuelve un resultado booleano. Normalmente, este tipo de función se utiliza como condición en una expresión condicional (if expression). Mediante el uso de la función inmonthstodate(), puede seleccionar el período que desea evaluar. Por ejemplo, proporcionar una variable de entrada que permita al usuario identificar los productos fabricados en el mes, trimestre o semestre de un período, hasta una fecha determinada.

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. Para más información, vea Modificar la configuración regional para aplicaciones y scripts.

La configuración regional predeterminada en las aplicaciones se basa en el perfil de usuario. Estos ajustes de formato regional no están relacionados con el idioma mostrado en la interfaz de usuario de Qlik Cloud. Qlik Cloud se mostrará en el mismo idioma que esté utilizando su navegador.

Si es un creador de aplicaciones, puede establecer la región por defecto para las apps que cree. Para más información, vea Establecer sus configuraciones regionales preferidas para crear apps y scripts en Analítica de Qlik Cloud.

Ejemplos de funciones
Ejemplo Resultado
inmonthstodate(4, '01/25/2013', '04/25/2013', 0) Devuelve True, porque el valor de timestamp, 01/25/2013, cae dentro del período de cuatro meses, del 01/01/2013 hasta el final de 04/25/2013, en el que se encuentra el valor de base_date, 04/25/2013.
inmonthstodate(4, '04/26/2013', '04/25/2006', 0) Devuelve False, porque 04/26/2013 está fuera del mismo período que el ejemplo anterior.
inmonthstodate(4, '09/25/2005', '02/01/2006', -1) Devuelve True, porque el valor de period_no, -1, desplaza el período de búsqueda un período de cuatro meses atrás (el valor de n-months), lo que hace que el período de búsqueda sea del 01/09/2005 al 02/01/2006.
inmonthstodate(4, '04/25/2006', '06/01/2006', 0, 3) Devuelve True, porque el valor de first_month_of_year está configurado en 3, lo que hace que el período de búsqueda sea del 03/01/2006 al 06/01/2006, en lugar del 05/01/2006 al 06/01/2006.

Ejemplo 1: sin argumentos adicionales

Ejemplo 2: period_no

Ejemplo 3: first_month_of_year

Ejemplo 4: ejemplo de 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.