Saltar al contenido principal Saltar al contenido complementario

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

Esta función devuelve un valor correspondiente a una marca de tiempo del primer milisegundo del primer día de la semana natural que contiene a date. El formato de salida predefinido es el DateFormat definido en el script.

Sintaxis:  

WeekStart(timestamp [, period_no [, first_week_day ]])

Tipo de datos que devuelve: dual

La función weekstart() determina en qué semana cae la fecha. Luego devuelve una marca de tiempo, en formato de fecha, con el primer milisegundo de esa semana. El primer día de la semana viene determinado por la variable de entorno FirstWeekDay. No obstante, esto puede ser reemplazado por el argumento de first_week_day en la función weekstart().

Argumentos
ArgumentoDescripción
timestampLa fecha o marca de tiempo para evaluar.
period_noshift 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.

Cuándo se utiliza

La función weekstart() se suele utilizar como parte de una expresión cuando el usuario desea que el cálculo utilice la fracción de la semana que ya ha transcurrido. Por ejemplo, se podría usar para calcular los salarios totales obtenidos por los empleados en la semana transcurrida hasta ahora.

Los siguientes ejemplos suponen:

SET FirstWeekDay=0;
Ejemplos de funciones
EjemploResultado
weekstart('01/12/2013')Devuelve 01/07/2013.
weekstart('01/12/2013', -1 )Devuelve 11/31/2012.
weekstart('01/12/2013', 0, 1)Devuelve 01/08/2013.

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.

Ejemplos:  

Si desea configuraciones ISO para semanas y números de semana, asegúrese de tener lo siguiente en el script:

Set DateFormat ='YYYY-MM-DD'; Set FirstWeekDay =0; // Monday as first week day Set BrokenWeeks =0; //(use unbroken weeks) Set ReferenceDay =4; // Jan 4th is always in week 1

Si desea la configuración de EE. UU., asegúrese de tener lo siguiente en el script:

Set DateFormat ='M/D/YYYY'; Set FirstWeekDay =6; // Sunday as first week day Set BrokenWeeks =1; //(use broken weeks) Set ReferenceDay =1; // Jan 1st is always in week 1

Los ejemplos anteriores dan como resultado lo siguiente, de la función weekstart():

Ejemplo de la función Weekstart
FechaInicio de la semana ISOInicio de semana en EE. UU.
Sab 2020 Dic 262020-12-2112/20/2020
Dom 2020 Dic 272020-12-2112/27/2020
Lun 2020 Dic 282020-12-2812/27/2020
Mar 2020 Dic 292020-12-2812/27/2020
Mie 2020 Dic 302020-12-2812/27/2020
Jue 2020 Dic 312020-12-2812/27/2020
Vie 2021 Ene 12020-12-2812/27/2020
Sab 2021 Ene 22020-12-2812/27/2020
Dom 2021 Ene 32020-12-281/3/2021
Lun 2021 Ene 42021-01-041/3/2021
Mar 2021 Ene 52021-01-041/3/2021
Nota informativaEl inicio de la semana es los lunes en la columna ISO y los domingos en la columna de EE. UU.

Ejemplo 1: sin argumentos adicionales

Ejemplo 2: period_no

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