Saltar al contenido principal Saltar al contenido complementario

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

Esta función devuelve el año al que pertenece el número de semana según las variables de entorno. El número de semana varía entre 1 y 52 aproximadamente.

Sintaxis:  

weekyear(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 weekyear() determina en qué semana de un año cae una fecha. Luego devuelve el año correspondiente a ese número de semana.

Si BrokenWeeks está configurado como 0 (false), weekyear() devolverá lo mismo que year().

Diagrama del rango de la función weekyear()

Diagrama que muestra el rango de tiempo que evalúa la función weekyear().

Sin embargo, si la variable del sistema BrokenWeeks está configurada para usar semanas ininterrumpidas, la semana 1 solo debe contener una cierta cantidad de días en enero conforme al valor especificado en la variable del sistema ReferenceDay.

Por ejemplo, si se utiliza un valor ReferenceDay de 4, la semana 1 debe incluir al menos cuatro días en enero. Es posible que la semana 1 incluya fechas de diciembre del año anterior o que el número de semana final de un año incluya fechas de enero del año siguiente. En situaciones como esta, la función weekyear() devolverá un valor diferente al de la función year().

Diagrama del rango de la función weekyear() cuando se usan semanas no interrumpidas

Diagrama que muestra el funcionamiento de weekyear() con semanas no interrumpidas.

La función weekyear() es útil cuando se desea comparar agregaciones por años. Por ejemplo, si desea ver el total de ventas de productos por año. La función weekyear() se elige por delante de year() cuando el usuario desea mantener la coherencia con la variable del sistema BrokenWeeks en la app.

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 Qlik Cloud Analítica.

Ejemplos de funciones
Ejemplo Resultado
weekyear('12/30/1996',0,0,4) devuelve 1997, porque la semana 1 de 1997 empieza el 30/12/1996
weekyear('01/02/1997',0,0,4) Devuelve 1997
weekyear('12/28/1997',0,0,4) Devuelve 1997
weekyear('12/30/1997',0,0,4) Devuelve 1998, porque la semana 1 de 1998 empieza el 29/12/1997
weekyear('01/02/1999',0,0,4) Devuelve 1998, porque la semana 53 de 1998 finaliza el 03/01/1999
Temas relacionados
Tema Interacción
week - función de script y de gráfico Esta función devuelve un entero que representa el número de semana conforme a la ISO 8601
year - función de script y de gráfico Devuelve un entero que representa el año en que la expresión se interpreta como una fecha según la interpretación numérica estándar.

Ejemplo 1: semanas interrumpidas

Ejemplo 2: semanas no interrumpidas

Ejemplo 3: ejemplo de objeto gráfico

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