Saltar al contenido principal Saltar al contenido complementario

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

Esta función devuelve un entero que representa el número de semana correspondiente a la fecha introducida.

Sintaxis:  

week(timestamp [, first_week_day [, broken_weeks [, reference_day]]])

Tipo de datos que devuelve: Entero

Argumentos
Argumento Descripción
timestamp La fecha o marca de tiempo para evaluar.
first_week_day

Especifica el día en el que se inicia la semana. Si se omite, se utiliza el valor de la variable FirstWeekDay.

Los valores posibles de first_week_day son 0 para el lunes, 1 para el martes, 2 para el miércoles, 3 para el jueves, 4 para el viernes, 5 para el sábado y 6 para el domingo.

Para más información sobre la variable del sistema, vea FirstWeekDay.

broken_weeks

Si no especifica broken_weeks, el valor de la variable BrokenWeeks se usará para definir si las semanas se rompen o no.

Para más información sobre la variable del sistema, vea BrokenWeeks

reference_day

Si no especifica reference_day, el valor de la variable ReferenceDay se usará para definir qué día de enero debe configurarse como día de referencia para definir la semana 1. De forma predeterminada, las funciones Qlik Sense usan 4 como día de referencia. Esto significa que la semana 1 debe incluir el 4 de enero o, dicho de otro modo, que la semana 1 siempre debe incluir 4 días de enero como mínimo.

Para más información sobre la variable del sistema, vea ReferenceDay

La función week() determina en qué semana cae la fecha y devuelve el número de semana.

 En Qlik Sense, la configuración regional se obtiene cuando se crea la app y la configuración correspondiente se almacena en el script como variables de entorno. Estos se utilizan para determinar el número de semana.

Esto significa que la mayoría de los desarrolladores de aplicaciones europeos obtienen las siguientes variables de entorno, correspondientes a la definición ISO 8601:

Set FirstWeekDay =0; // Monday as first week day Set BrokenWeeks =0; // Use unbroken weeks Set ReferenceDay =4; // Jan 4th is always in week 1

Un desarrollador de aplicaciones norteamericano a menudo obtiene las siguientes variables de entorno:

Set FirstWeekDay =6; // Sunday as first week day Set BrokenWeeks =1; // Use broken weeks Set ReferenceDay =1; // Jan 1st is always in week 1

El primer día de la semana viene determinado por la variable del sistema FirstWeekDay. También puede cambiar el primer día de la semana usando el argumento first_week_day en la función week().

Si su aplicación utiliza semanas interrumpidas, el número de semanas comienza el 1 de enero y finaliza el día anterior a la variable del sistema FirstWeekDay, independientemente de cuántos días hayan transcurrido.

Si su aplicación utiliza semanas ininterrumpidas, la semana 1 puede comenzar en el año anterior o en los primeros días de enero. Esto depende de cómo use las variables de entorno FirstWeekDay y ReferenceDay.

Cuándo se utiliza

La función The week() es útil cuando se desea comparar agregaciones por semanas. Por ejemplo, si desea ver el total de ventas de productos por semana. La función week() se elige por encima de weekname() cuando el usuario desea que el cálculo no utilice necesariamente las variables del sistema, BrokenWeeks, FirstWeekDay o ReferenceDay de la aplicación.

Por ejemplo, si desea ver el total de ventas de productos por semana.

Si la aplicación utiliza semanas ininterrumpidas, la semana 1 puede contener fechas de diciembre del año anterior o excluir fechas de enero del año en curso. Si la aplicación utiliza semanas interrumpidas, la semana 1 puede contener menos de siete días.

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 su navegador.

Los siguientes ejemplos suponen

Set DateFormat= 'MM/DD/YYYY'; Set FirstWeekDay=0; Set BrokenWeeks=0; Set ReferenceDay=4;
Ejemplos de funciones
EjemploResultado

week('12/28/2021')

Devuelve 52.

week(44614)Devuelve 8, ya que este es el número de serie del 22/02/2022.
week('01/03/2021')Devuelve 53.
week('01/03/2021',6)Devuelve 1.

Ejemplo 1: variables predeterminadas del sistema

Ejemplo 2: first_week_day

Ejemplo 3: unbroken_weeks

Ejemplo 4: reference_day

Ejemplo 5: ejemplo de objeto gráfico

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