Saltar al contenido principal

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

Esta función devuelve True si timestamp se encuentra dentro de la parte del trimestre que contiene a base_date hasta e incluido el último milisegundo de base_date.

Sintaxis:  

InQuarterToDate (timestamp, base_date, period_no [, first_month_of_year])

Tipo de datos que devuelve: Booleano

Nota informativa

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

Diagrama de la función inquartertodate

Diagrama de ejemplo del rango de fechas dentro del cual la función inquartertodate devolverá un valor de TRUE.

La función inquartertodate() divide el año en cuatro trimestres iguales entre el 1 de enero y el 31 de diciembre (o el inicio del año definido por el usuario y su fecha de finalización correspondiente). Usando la base_date, la función luego segmentará un trimestre en particular, con la base_date identificando tanto qué trimestre como la fecha máxima permitida para ese segmento de trimestre. Por último, la función devuelve un resultado booleano al comparar los valores de fecha prescritos con ese segmento.

Argumentos
Argumento Descripción
timestamp La fecha que desea comparar con base_date.
base_date La fecha que se utiliza para evaluar el trimestre.
period_no

El trimestre puede desplazarse mediante period_no. period_no es un entero, en el que el valor 0 indica el trimestre que contiene a base_date. Los valores negativos en period_no indican trimestres precedentes y los valores positivos indican trimestres 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.

Cuándo se utiliza

La función inquartertodate() devuelve un resultado booleano. Normalmente, este tipo de función se utilizará como condición en una expresión if. La función inquartertodate() se usaría para devolver una agregación o cálculo dependiendo de si una fecha evaluada ocurrió en el trimestre hasta la fecha en cuestión inclusive.

Por ejemplo, la función inquartertodate() se puede utilizar para identificar todos los equipos fabricados en un trimestre hasta una fecha específica.

Ejemplos de funciones
Ejemplo Resultado
inquartertodate('01/25/2013', '03/25/2013', 0) Devuelve TRUE, ya que el valor del timestamp, 01/25/2013, se encuentra dentro del período de tres meses del 01/01/2013 al  25/03/2013, en el cual se encuentra el valor de base_date, 25/03/2013.
inquartertodate('04/26/2013', '03/25/2013', 0) Devuelve FALSE, ya que el 26/04/2013 está fuera del mismo periodo que el ejemplo anterior.
inquartertodate('02/25/2013', '06/09/2013', -1) Devuelve TRUE, ya que el valor de period_no, -1, desplaza el período de búsqueda hacia atrás un período de tres meses (un trimestre del año). Esto hace que el período de búsqueda sea del 01/01/2013 al 09/03/2013.
inquartertodate('03/25/2006', '04/15/2006', 0, 2) Devuelve TRUE, ya que el valor de first_month_of_year está establecido en 2, lo que hace que el período de búsqueda sea del 01/02/2006 al 15/04/2006 en lugar del 01/04/2006 al 15/04/2006.

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 de la app.

La configuración regional por defecto de las apps se basa en una combinación de la configuración del proveedor de identidad, la configuración del sistema o la configuración del navegador. 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.

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