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

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

Essa função retorna um valor correspondente a um carimbo de data/hora do último milissegundo do último dia da semana do calendário contendo date. O formato de saída padrão será o DateFormat definido no script.

Sintaxe:  

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

Tipo de dados de retorno: dual

A função weekend() determina em qual semana a data cai. Em seguida, ela retorna um carimbo de data/hora, em formato de data, para o último 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 weekend().

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 para 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 weekend() é normalmente usada como parte de uma expressão quando o usuário deseja que o cálculo use os dias restantes da semana para a data especificada. Por exemplo, ela pode ser usada se um usuário deseja calcular o total de juros ainda não acumulados durante a semana.

Os exemplos a seguir pressupõem que:

SET FirstWeekDay=0;

 

Exemplo Resultado
weekend('01/10/2013') Retorna 01/12/2013 23:59:59.
weekend('01/10/2013', -1) Retorna 01/05/2013 23:59:59..
weekend('01/10/2013', 0, 1) Retorna 01/14/2013 23:59:59.

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 weekend():

Exemplo de função de fim de semana
Date ISO week end US week end
Sat 2020 Dec 26 2020-12-27 12/26/2020
Sun 2020 Dec 27 2020-12-27 1/2/2021
Mon 2020 Dec 28 2021-01-03 1/2/2021
Tue 2020 Dec 29 2021-01-03 1/2/2021
Wed 2020 Dec 30 2021-01-03 1/2/2021
Thu 2020 Dec 31 2021-01-03 1/2/2021
Fri 2021 Jan 1 2021-01-03 1/2/2021
Sat 2021 Jan 2 2021-01-03 1/2/2021
Sun 2021 Jan 3 2021-01-03 1/9/2021
Mon 2021 Jan 4 2021-01-10 1/9/2021
Ter 2021, 5 de janeiro 2021-01-10 1/9/2021
Nota informativaOs fins de semana são aos domingos na coluna ISO e aos sábados na coluna US.

Exemplo 1: Exemplo básico

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!