Ir para conteúdo principal Pular para conteúdo complementar

weekstart – função de script e gráfico

Esta função retorna um valor correspondente ao carimbo de data/hora com o primeiro milissegundo do primeiro dia da semana do calendário que contém a date. O formato de saída padrão é o DateFormat definido no script.

Sintaxe:  

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

Tipo de dados de retorno: dual

A função weekstart() determina em qual semana a data cai. Em seguida, ela retorna um carimbo de data/hora, em formato de data, para o primeiro milissegundo daquela semana. O primeiro dia da semana é determinado pela variável de ambiente FirstWeekDay. No entanto, isso pode ser substituído pelo argumento first_week_day na função weekstart().

Argumentos
Argumento Descrição
timestamp A data ou o carimbo de data/hora a ser avaliado.
period_no shift é um inteiro, em que o valor 0 indica a semana que contém a date. Os valores negativos no deslocamento indicam semanas precedentes e os valores positivos indicam semanas subsequentes.
first_week_day

Especifica o dia no qual inicia a semana. Se omitido, o valor da variável FirstWeekDay é usado.

Os valores possíveis first_week_day são 0 para segunda-feira, 1 para terça, 2 para quarta-feira, 3 para quinta-feira, 4 para sexta-feira, 5 para sábado e 6 para domingo.

Para obter mais informações sobre a variável de sistema, consulte FirstWeekDay.

Quando usar

A função weekstart() é comumente usada como parte de uma expressão quando o usuário deseja que o cálculo use a fração da semana decorrida até o momento. Por exemplo, ela pode ser usada se um usuário deseja calcular o total de salários ganhos pelos funcionários na semana até o momento.

Os exemplos a seguir pressupõem que:

SET FirstWeekDay=0;
Exemplos de funções
Exemplo Resultado
weekstart('01/12/2013') Retorna 01/07/2013.
weekstart('01/12/2013', -1 ) Retorna 11/31/2012.
weekstart('01/12/2013', 0, 1) Retorna 01/08/2013.

Configurações regionais

A menos que especificado de outra forma, os exemplos neste tópico usam o seguinte formato de data: MM/DD/AAAA. O formato de data é especificado na instrução SET DateFormat no seu script de carregamento de dados. A formatação de data padrão pode ser diferente no seu sistema devido às suas configurações regionais e outros fatores. Você pode alterar os formatos nos exemplos abaixo para atender às suas necessidades. Ou pode alterar os formatos no seu script de carregamento para corresponder a esses exemplos. Para obter mais informações, consulte Modificando configurações regionais para aplicativos e scripts.

As configurações regionais padrão nos aplicativos são baseadas no perfil do usuário. Essas configurações de formato regional não estão relacionadas ao idioma exibido na interface do usuário do Qlik Cloud. O Qlik Cloud será exibido no mesmo idioma do navegador que você está usando.

Se você for um criador de aplicativos, poderá definir a região padrão para os aplicativos que criar. Para obter mais informações, consulte Definir suas configurações regionais preferidas para criar aplicativos e scripts no Qlik Cloud Analytics.

Exemplos:  

Se quiser configurações ISO para semanas e números de semanas, certifique-se de ter o seguinte no 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

Se quiser configurações dos EUA, certifique-se de ter o seguinte no 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

Os exemplos acima resultam no seguinte resultado da função weekstart():

Exemplo da função Weekstart
Date Início da semana ISO Início da semana dos EUA
Sat 2020 Dec 26 2020-12-21 12/20/2020
Sun 2020 Dec 27 2020-12-21 12/27/2020
Mon 2020 Dec 28 2020-12-28 12/27/2020
Tue 2020 Dec 29 2020-12-28 12/27/2020
Wed 2020 Dec 30 2020-12-28 12/27/2020
Thu 2020 Dec 31 2020-12-28 12/27/2020
Fri 2021 Jan 1 2020-12-28 12/27/2020
Sat 2021 Jan 2 2020-12-28 12/27/2020
Sun 2021 Jan 3 2020-12-28 1/3/2021
Mon 2021 Jan 4 2021-01-04 1/3/2021
Ter 2021, 5 de janeiro 2021-01-04 1/3/2021
Nota informativaO início da semana é às segundas-feiras na coluna ISO e aos domingos na coluna US.

Exemplo 1: Sem argumentos adicionais

Exemplo 2: period_no

Exemplo 3: first_week_day

Exemplo 4: Exemplo de objeto de gráfico

Exemplo 5: Cenário

Esta página ajudou?

Se você encontrar algum problema com esta página ou seu conteúdo - um erro de digitação, uma etapa ausente ou um erro técnico - informe-nos como podemos melhorar!