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

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
Ejemplo Resultado
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. 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.

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
Fecha Inicio de la semana ISO Inicio de semana en EE. UU.
Sab 2020 Dic 26 2020-12-21 12/20/2020
Dom 2020 Dic 27 2020-12-21 12/27/2020
Lun 2020 Dic 28 2020-12-28 12/27/2020
Mar 2020 Dic 29 2020-12-28 12/27/2020
Mie 2020 Dic 30 2020-12-28 12/27/2020
Jue 2020 Dic 31 2020-12-28 12/27/2020
Vie 2021 Ene 1 2020-12-28 12/27/2020
Sab 2021 Ene 2 2020-12-28 12/27/2020
Dom 2021 Ene 3 2020-12-28 1/3/2021
Lun 2021 Ene 4 2021-01-04 1/3/2021
Mar 2021 Ene 5 2021-01-04 1/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.