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

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

Essa função retorna um número inteiro representando o número da semana correspondente à data inserida.

Sintaxe:  

week(timestamp [, first_week_day [, broken_weeks [, reference_day]]])

Tipo de dados de retorno: inteiro

Argumentos
Argumento Descrição
timestamp A data ou o carimbo de data/hora a ser avaliado.
first_week_day

Especifica o dia no qual inicia a semana. Se omitido, o valor da variável FirstWeekDay será 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.

broken_weeks

Se você não especificar broken_weeks, o valor da variável BrokenWeeks será usado para definir se as semanas são quebradas ou não.

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

reference_day

Se você não especificar reference_day, o valor da variável ReferenceDay será usado para definir qual dia em janeiro será definido como dia de referência para definir a semana 1. Por padrão, as funções Qlik Sense usam 4 como o dia de referência. Isso significa que a semana 1 deve conter 4 de janeiro, ou dito de outra forma, que a semana 1 deve sempre ter pelo menos 4 dias em janeiro.

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

A função week() determina em qual semana a data cai e retorna o número da semana.

 No Qlik Sense, as configurações regionais são obtidas quando o aplicativo é criado, e as configurações correspondentes são armazenadas no script como variáveis de ambiente. Elas são usados para determinar o número da semana.

Isso significa que a maioria dos desenvolvedores de aplicativos europeus obtém as seguintes variáveis de ambiente, correspondentes à definição ISO 8601:

Set FirstWeekDay =0; // Monday as first week day Set BrokenWeeks =0; // Use unbroken weeks Set ReferenceDay =4; // Jan 4th is always in week 1

Um desenvolvedor de aplicativos norte-americano geralmente recebe as seguintes variáveis de ambiente:

Set FirstWeekDay =6; // Sunday as first week day Set BrokenWeeks =1; // Use broken weeks Set ReferenceDay =1; // Jan 1st is always in week 1

O primeiro dia da semana é determinado pela variável de sistema FirstWeekDay. Você também pode alterar o primeiro dia da semana usando o argumento first_week_day na função week().

Se seu aplicativo usar semanas interrompidas, a contagem de números de semana começará em 1º de janeiro e terminará no dia anterior à variável do sistema FirstWeekDay, independentemente de quantos dias tenham ocorrido.

Se o seu aplicativo estiver usando semanas não quebradas, a semana 1 pode começar no ano anterior ou nos primeiros dias de janeiro. Isso depende de como você usa as variáveis de ambiente FirstWeekDay e ReferenceDay.

Quando usar

A função The week() é útil quando você deseja comparar agregações por semanas. Por exemplo, ela pode ser usada se você deseja ver o total de vendas de produtos por semana. A função week() é escolhida no lugar de weekname() quando o usuário deseja que o cálculo não use necessariamente as variáveis de sistema BrokenWeeks, FirstWeekDay ou ReferenceDay do aplicativo.

Por exemplo, se você quiser ver o total de vendas de produtos por semana.

Se o aplicativo estiver usando semanas não quebradas, a semana 1 pode conter datas de dezembro do ano anterior ou pode excluir datas em janeiro do ano atual. Se o aplicativo estiver usando semanas quebradas, a semana 1 pode conter menos de sete dias.

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.

Os exemplos abaixo pressupõem

Set DateFormat= 'MM/DD/YYYY'; Set FirstWeekDay=0; Set BrokenWeeks=0; Set ReferenceDay=4;
Exemplos de funções
Exemplo Resultado

week('12/28/2021')

Retorna 52.

week(44614) Retorna 8, já que esse é o número de série de 22/02/2022.
week('01/03/2021') Retorna 53.
week('01/03/2021',6) Returna 1.

Exemplo 1: Variáveis padrão do sistema

Exemplo 2: first_week_day

Exemplo 3: unbroken_weeks

Exemplo 4: reference_day

Exemplo 5: Exemplo de objeto de gráfico

Exemplo 6: 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!