La función devuelve True si timestamp se encuentra dentro de la semana que contiene a base_date.
Sintaxis:
InWeek (timestamp, base_date, period_no[, first_week_day])
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 del rango de la función inweek()
La función inweek() utiliza el argumento de base_date para identificar en qué periodo de siete días cae la fecha. El día de inicio de la semana se basa en la variable del sistema FirstWeekDay. No obstante, también puede cambiar el primer día de la semana usando el argumento first_week_day de la función inweek().
Una vez que se haya definido la semana seleccionada, la función devolverá resultados booleanos al comparar los valores de fecha prescritos con ese segmento de semana.
Cuándo se utiliza
La función InWeek devuelve un resultado booleano. Normalmente, este tipo de función se utilizará como condición en una if expression. La función InWeek devuelve una agregación o cálculo que depende de si una fecha evaluada ocurrió en la semana con la fecha seleccionada del argumento base_date.
Por ejemplo, la función InWeek se puede utilizar para identificar todos los equipos fabricados en una semana determinada.
| Argumento | Descripción |
|---|---|
| timestamp | La fecha que desea comparar con base_date. |
| base_date | La fecha que se utiliza para evaluar la semana. |
| period_no | La semana puede desplazarse mediante period_no. period_no es un entero, en el que el valor 0 indica la semana que contiene a base_date. Los valores negativos en period_no indican semanas precedentes y los valores positivos indican semanas subsiguientes. |
| first_week_day |
De forma predeterminada, el primer día de la semana es el domingo (según lo determina la variable de sistema FirstWeekDay), comenzando a la medianoche entre el sábado y el domingo. El parámetro first_week_day reemplaza a la variable FirstWeekDay. Para indicar una semana que comienza en otro día, especifique un desplazamiento entre 0 y 6. |
| Día | Valor |
|---|---|
| Lunes | 0 |
| Martes | 1 |
| Miércoles | 2 |
| Jueves | 3 |
| Viernes | 4 |
| Sábado | 5 |
| Domingo | 6 |
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.
| Ejemplo | Resultado |
|---|---|
| inweek ('01/12/2006', '01/14/2006', 0) | Devuelve TRUE |
| inweek ('01/12/2006', '01/20/2006', 0 ) | Devuelve FALSE |
| inweek ('01/12/2006', '01/14/2006', -1 ) | Devuelve FALSE |
| inweek ('01/07/2006', '01/14/2006', -1) | Devuelve TRUE |
| inweek ('01/12/2006', '01/09/2006', 0, 3) | Devuelve FALSE porque first_week_day está especificado como 3 (Jueves), lo que hace que 12/01/2006 sea el primer día de la semana que sigue a la semana que contiene a 09/01/2006. |
Estos temas le ayudarán a trabajar con esta función:
| Tema | Valor/indicador predeterminado | Descripción |
|---|---|---|
| FirstWeekDay | 6 / Domingo | Define el día de inicio de cada semana. |
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 del mes de enero de 2022, el cual se carga en una tabla denominada "Transactions".
-
La variable del sistema FirstWeekDay configurada en 6 (domingo).
-
Un load precedente que contiene lo siguiente:
-
La función inweek(), configurada como el campo "in_week" que determina qué transacciones se realizaron en la semana del 14 de enero de 2022.
-
La función weekday(), configurada como el campo "week_day" que muestra qué día de la semana corresponde a cada fecha.
-
Script de carga
SET FirstWeekDay=6;
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*,
weekday(date) as week_day,
inweek(date,'01/14/2022', 0) as in_week
;
Load
*
Inline
[
id,date,amount
8188,'01/02/2022',37.23
8189,'01/05/2022',17.17
8190,'01/06/2022',88.27
8191,'01/08/2022',57.42
8192,'01/09/2022',53.80
8193,'01/10/2022',82.06
8194,'01/11/2022',40.39
8195,'01/12/2022',87.21
8196,'01/13/2022',95.93
8197,'01/14/2022',45.89
8198,'01/15/2022',36.23
8199,'01/16/2022',25.66
8200,'01/17/2022',82.77
8201,'01/18/2022',69.98
8202,'01/26/2022',76.11
8203,'01/27/2022',25.12
8204,'01/28/2022',46.23
8205,'01/29/2022',84.21
8206,'01/30/2022',96.24
8207,'01/31/2022',67.67
]; Resultados
Cargue los datos y abra una hoja. Cree una nueva tabla y agregue estos campos como dimensiones:
-
date
-
week_day
-
in_week
| date | week_day | in_week |
|---|---|---|
| 01/02/2022 | Dom | 0 |
| 01/05/2022 | Mié | 0 |
| 01/06/2022 | Jue | 0 |
| 01/08/2022 | Sáb | 0 |
| 01/09/2022 | Dom | -1 |
| 01/10/2022 | Lun | -1 |
| 01/11/2022 | Mar | -1 |
| 01/12/2022 | Mié | -1 |
| 01/13/2022 | Jue | -1 |
| 01/14/2022 | Vie | -1 |
| 01/15/2022 | Sáb | -1 |
| 01/16/2022 | Dom | 0 |
| 01/17/2022 | Lun | 0 |
| 01/18/2022 | Mar | 0 |
| 01/26/2022 | Mié | 0 |
| 01/27/2022 | Jue | 0 |
| 01/28/2022 | Vie | 0 |
| 01/29/2022 | Sáb | 0 |
| 01/30/2022 | Dom | 0 |
| 01/31/2022 | Lun | 0 |
El campo "in_week" se crea en la instrucción load anterior mediante el uso de la función inweek(). El primer argumento identifica qué campo se está evaluando. El segundo argumento es una fecha codificada, 14 de enero, que es la base_date. El argumento de base_date funciona con la variable del sistema FirstWeekDay para identificar la semana de comparación. Un period_no de 0 — lo que significa que la función no compara las semanas anteriores o posteriores a la semana segmentada — es el argumento final.
La variable de sistema FirstWeekDay determina que las semanas comienzan en domingo y terminan en sábado. Por lo tanto, enero se dividiría en semanas de acuerdo con el diagrama inferior, siendo las fechas entre el 9 y el 15 de enero el período válido para el cálculo de inweek():
Diagrama del calendario con el rango de la función inweek() resaltado
Cualquier transacción que ocurra entre el 9 y el 15 de enero devolverá un resultado booleano de TRUE.
Ejemplo 2: period_no
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:
-
El mismo conjunto de datos que contiene un conjunto de transacciones para 2022 se carga en una tabla llamada "Transactions".
-
La variable del sistema FirstWeekDay configurada en 6 (domingo).
-
Un load precedente que contiene lo siguiente:
-
La función inweek (), configurada como el campo "prev_week" que determina qué transacciones se realizaron una semana completa antes de la semana del 14 de enero de 2022.
-
La función weekday(), configurada como el campo "week_day" que muestra qué día de la semana corresponde a cada fecha.
-
Script de carga
SET FirstWeekDay=6;
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*,
weekday(date) as week_day,
inweek(date,'01/14/2022', -1) as prev_week
;
Load
*
Inline
[
id,date,amount
8188,'01/02/2022',37.23
8189,'01/05/2022',17.17
8190,'01/06/2022',88.27
8191,'01/08/2022',57.42
8192,'01/09/2022',53.80
8193,'01/10/2022',82.06
8194,'01/11/2022',40.39
8195,'01/12/2022',87.21
8196,'01/13/2022',95.93
8197,'01/14/2022',45.89
8198,'01/15/2022',36.23
8199,'01/16/2022',25.66
8200,'01/17/2022',82.77
8201,'01/18/2022',69.98
8202,'01/26/2022',76.11
8203,'01/27/2022',25.12
8204,'01/28/2022',46.23
8205,'01/29/2022',84.21
8206,'01/30/2022',96.24
8207,'01/31/2022',67.67
]; Resultados
Cargue los datos y abra una hoja. Cree una nueva tabla y agregue estos campos como dimensiones:
-
date
-
week_day
-
prev_week
| fecha | week_day | prev_week |
|---|---|---|
| 01/02/2022 | Dom | -1 |
| 01/05/2022 | Mié | -1 |
| 01/06/2022 | Jue | -1 |
| 01/08/2022 | Sáb | -1 |
| 01/09/2022 | Dom | 0 |
| 01/10/2022 | Lun | 0 |
| 01/11/2022 | Mar | 0 |
| 01/12/2022 | Mié | 0 |
| 01/13/2022 | Jue | 0 |
| 01/14/2022 | Vie | 0 |
| 01/15/2022 | Sáb | 0 |
| 01/16/2022 | Dom | 0 |
| 01/17/2022 | Lun | 0 |
| 01/18/2022 | Mar | 0 |
| 01/26/2022 | Mié | 0 |
| 01/27/2022 | Jue | 0 |
| 01/28/2022 | Vie | 0 |
| 01/29/2022 | Sáb | 0 |
| 01/30/2022 | Dom | 0 |
| 01/31/2022 | Lun | 0 |
Utilizar -1 como el argumento de period_no en la función inweek(), desplaza los límites de la semana de comparación hacia atrás en siete días completos. Con un period_no de 0 la semana sería entre el 9 y el 15 de enero. Pero en este ejemplo, el period_no de -1 desplaza el límite inicial y final de este segmento hacia atrás una semana. Los límites de fecha pasan a ser del 2 de enero al 8 de enero.
Diagrama del calendario con el rango de la función inweek() resaltado
Por lo tanto, cualquier transacción que ocurra entre el 2 y el 8 de enero devolverá un resultado booleano de TRUE.
Ejemplo: first_week_day
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:
-
El mismo conjunto de datos que contiene un conjunto de transacciones para 2022 se carga en una tabla llamada "Transactions".
-
La variable del sistema FirstWeekDay configurada en 6 (domingo).
-
Un load precedente que contiene lo siguiente:
-
La función inweek(), configurada como el campo "in_week" que determina qué transacciones se realizaron en la semana del 14 de enero de 2022.
-
La función weekday(), configurada como el campo "week_day" que muestra qué día de la semana corresponde a cada fecha.
-
Script de carga
SET FirstWeekDay=6;
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*,
weekday(date) as week_day,
inweek(date,'01/14/2022', 0, 0) as in_week
;
Load
*
Inline
[
id,date,amount
8188,'01/02/2022',37.23
8189,'01/05/2022',17.17
8190,'01/06/2022',88.27
8191,'01/08/2022',57.42
8192,'01/09/2022',53.80
8193,'01/10/2022',82.06
8194,'01/11/2022',40.39
8195,'01/12/2022',87.21
8196,'01/13/2022',95.93
8197,'01/14/2022',45.89
8198,'01/15/2022',36.23
8199,'01/16/2022',25.66
8200,'01/17/2022',82.77
8201,'01/18/2022',69.98
8202,'01/26/2022',76.11
8203,'01/27/2022',25.12
8204,'01/28/2022',46.23
8205,'01/29/2022',84.21
8206,'01/30/2022',96.24
8207,'01/31/2022',67.67
]; Resultados
Cargue los datos y abra una hoja. Cree una nueva tabla y agregue estos campos como dimensiones:
-
date
-
week_day
-
in_week
| fecha | week_day | in_week |
|---|---|---|
| 01/02/2022 | Dom | 0 |
| 01/05/2022 | Mié | 0 |
| 01/06/2022 | Jue | 0 |
| 01/08/2022 | Sáb | 0 |
| 01/09/2022 | Dom | 0 |
| 01/10/2022 | Lun | -1 |
| 01/11/2022 | Mar | -1 |
| 01/12/2022 | Mié | -1 |
| 01/13/2022 | Jue | -1 |
| 01/14/2022 | Vie | -1 |
| 01/15/2022 | Sáb | -1 |
| 01/16/2022 | Dom | -1 |
| 01/17/2022 | Lun | 0 |
| 01/18/2022 | Mar | 0 |
| 01/26/2022 | Mié | 0 |
| 01/27/2022 | Jue | 0 |
| 01/28/2022 | Vie | 0 |
| 01/29/2022 | Sáb | 0 |
| 01/30/2022 | Dom | 0 |
| 01/31/2022 | Lun | 0 |
Utilizando 0 como el argumento de first_week_day en la función inweek(), el argumento de la función reemplaza a la variable de sistema FirstWeekDay y establece el lunes como el primer día de la semana.
Diagrama del calendario con el rango de la función inweek() resaltado
Por lo tanto, cualquier transacción que ocurra entre el 10 y el 16 de enero devolverá un resultado booleano de TRUE.
Ejemplo 4: ejemplo de objeto gráfico
Vista general
Se utilizan el mismo conjunto de datos y el mismo escenario que en el primer ejemplo.
Sin embargo, en este ejemplo, el conjunto de datos sin modificar se carga en la aplicación. Cree una medida en la tabla de resultados para determinar qué transacciones se realizaron en la semana del 14 de enero de 2022.
Script de carga
SET FirstWeekDay=6;
SET DateFormat='MM/DD/YYYY';
Transactions:
Load
*
Inline
[
id,date,amount
8188,'01/02/2022',37.23
8189,'01/05/2022',17.17
8190,'01/06/2022',88.27
8191,'01/08/2022',57.42
8192,'01/09/2022',53.80
8193,'01/10/2022',82.06
8194,'01/11/2022',40.39
8195,'01/12/2022',87.21
8196,'01/13/2022',95.93
8197,'01/14/2022',45.89
8198,'01/15/2022',36.23
8199,'01/16/2022',25.66
8200,'01/17/2022',82.77
8201,'01/18/2022',69.98
8202,'01/26/2022',76.11
8203,'01/27/2022',25.12
8204,'01/28/2022',46.23
8205,'01/29/2022',84.21
8206,'01/30/2022',96.24
8207,'01/31/2022',67.67
]; Resultados
Cargue los datos y abra una hoja. Cree una nueva tabla y agregue este campo como dimensión:
-
date
Cree las siguientes medidas:
-
=inweek (date,'01/14/2022',0), para calcular si las transacciones se realizaron en la misma semana del 14 de enero.
-
=weekday(date), para mostrar qué día de la semana corresponde a cada fecha.
| fecha | week_day | =inweek (date,'01/14/2022',0) |
|---|---|---|
| 01/02/2022 | Dom | 0 |
| 01/05/2022 | Mié | 0 |
| 01/06/2022 | Jue | 0 |
| 01/08/2022 | Sáb | 0 |
| 01/09/2022 | Dom | -1 |
| 01/10/2022 | Lun | -1 |
| 01/11/2022 | Mar | -1 |
| 01/12/2022 | Mié | -1 |
| 01/13/2022 | Jue | -1 |
| 01/14/2022 | Vie | -1 |
| 01/15/2022 | Sáb | -1 |
| 01/16/2022 | Dom | 0 |
| 01/17/2022 | Lun | 0 |
| 01/18/2022 | Mar | 0 |
| 01/26/2022 | Mié | 0 |
| 01/27/2022 | Jue | 0 |
| 01/28/2022 | Vie | 0 |
| 01/29/2022 | Sáb | 0 |
| 01/30/2022 | Dom | 0 |
| 01/31/2022 | Lun | 0 |
La medida "in_week" se crea en el gráfico mediante la función inweek(). El primer argumento identifica qué campo se está evaluando. El segundo argumento es una fecha codificada, 14 de enero, que es la base_date. El argumento de base_date funciona con la variable del sistema FirstWeekDay para identificar la semana de comparación. Un period_no de 0 es el argumento final.
La variable de sistema FirstWeekDay determina que las semanas comienzan en domingo y terminan en sábado. Por lo tanto, enero se dividiría en semanas de acuerdo con el diagrama inferior, siendo las fechas entre el 9 y el 15 de enero el período válido para el cálculo de inweek():
Diagrama del calendario con el rango de la función inweek() resaltado
Cualquier transacción que ocurra entre el 9 y el 15 de enero devolverá un resultado booleano de TRUE.