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 as configurações regionais do aplicativo.

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 Definindo suas configurações regionais preferidas para criar aplicativos 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!