Saltar al contenido principal Saltar al contenido complementario

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

Esta función devuelve un valor que muestra el número de año y de semana con un valor numérico subyacente correspondiente a una marca de tiempo del primer milisegundo del primer día de la semana que contiene a date.

Sintaxis:  

WeekName(date[, period_no [, first_week_day [, broken_weeks [, reference_day]]]])

La función weekname() determina en qué semana cae la fecha y devuelve el número de semana y el año de esa semana. El primer día de la semana viene determinado por la variable del sistema FirstWeekDay. No obstante, también puede cambiar el primer día de la semana usando el argumento first_week_day en la función weekname().

 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.

Un desarrollador de aplicaciones norteamericano a menudo incluye Set BrokenWeeks=1; en el script, lo que corresponde a semanas interrumpidas. Un desarrollador de aplicaciones europeo a menudo incluye Set BrokenWeeks=0; en el script, lo que corresponde a semanas ininterrumpidas.

Si su aplicación utiliza semanas interrumpidas, el recuento 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.

Sin embargo, si su aplicación usa 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 del sistema ReferenceDay y FirstWeekDay.

Ejemplo de la función Weekname
Fecha Nombre de semana ISO Nombre de semana en EE. UU.
Sab 2020 Dic 26 2020/52 2020/52
Dom 2020 Dic 27 2020/52 2020/53
Lun 2020 Dic 28 2020/53 2020/53
Mar 2020 Dic 29 2020/53 2020/53
Mie 2020 Dic 30 2020/53 2020/53
Jue 2020 Dic 31 2020/53 2020/53
Vie 2021 Ene 1 2020/53 2021/01
Sab 2021 Ene 2 2020/53 2021/01
Dom 2021 Ene 3 2020/53 2021/02
Lun 2021 Ene 4 2021/01 2021/02
Mar 2021 Ene 5 2021/01 2021/02

La función weekname() es útil cuando desea comparar agregaciones por semanas.

Por ejemplo, si desea ver el total de ventas de productos por semana. Para mantener la coherencia con la variable de entorno BrokenWeeks en la aplicación, utilice weekname() en vez de lunarweekname(). 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 segmentadas, la semana 1 puede contener menos de siete días.

Tipo de datos que devuelve: dual

Argumentos
Argumento Descripción
timestamp La fecha o marca de tiempo para evaluar.
period_no shift es un entero, donde el valor 0 indica la semana que contiene a date. Los valores negativos en el desplazamiento indican semanas precedentes y los valores positivos indican semanas subsiguientes.
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

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.

Los siguientes ejemplos suponen:

Set FirstWeekDay=0; Set BrokenWeeks=0; Set ReferenceDay=4;
Ejemplos de funciones
Ejemplo Resultado
weekname('01/12/2013') Devuelve 2013/02.
weekname('01/12/2013', -1) Devuelve 2013/01.
weekname('01/12/2013', 0, 1) Devuelve 2013/02.

Ejemplo 1: Fecha sin argumentos adicionales

Ejemplo 2: period_no

Ejemplo: first_week_day

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.