weekname Função de script e de gráfico | Qlik Sense no Windows Ajuda
Ir para conteúdo principal Pular para conteúdo complementar

weekname Função de script e de gráfico

Esta função retorna um valor que mostra o número do ano e da semana com um valor numérico subjacente que corresponde a um carimbo de hora do primeiro milissegundo do primeiro dia da semana que contém a date.

WeekName(date[, period_no [, first_week_day [, broken_weeks [, reference_day]]]])

A função weekname() determina em qual semana a data cai e retorna o número e o ano dessa semana. O primeiro dia da semana é determinado pela FirstWeekDayvariável de sistema . No entanto, você também pode alterar o primeiro dia da semana usando o argumento first_week_day da função weekname().

 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.

Um desenvolvedor de aplicativos norte-americano geralmente obtém Set BrokenWeeks=1; no script, o que corresponde a semanas interrompidas. Um desenvolvedor de aplicativos europeu geralmente obtém Set BrokenWeeks=0; no script, correspondendo a semanas ininterruptas.

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.

No entanto, 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 sistema ReferenceDay e FirstWeekDay.

Exemplo da função Weekname
Data Nome da semana ISO Nome da semana dos EUA
Sat 2020 Dec 26 2020/52 2020/52
Sun 2020 Dec 27 2020/52 2020/53
Mon 2020 Dec 28 2020/53 2020/53
Tue 2020 Dec 29 2020/53 2020/53
Wed 2020 Dec 30 2020/53 2020/53
Thu 2020 Dec 31 2020/53 2020/53
Fri 2021 Jan 1 2020/53 2021/01
Sat 2021 Jan 2 2020/53 2021/01
Sun 2021 Jan 3 2020/53 2021/02
Mon 2021 Jan 4 2021/01 2021/02
Ter 2021, 5 de janeiro 2021/01 2021/02

A função weekname() é útil para quando você deseja comparar agregações por semanas.

Por exemplo, se você quiser ver o total de vendas de produtos por semana. Para manter a consistência com a variável de ambiente BrokenWeeks no aplicativo, use weekname() em vez de lunarweekname(). 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.

Tipo de dados de retorno: Dual

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 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 de janeiro definir como dia de referência para definir a semana 1. Por padrão, as funções do 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

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.

As configurações regionais padrão nos aplicativos são baseadas nas configurações regionais do sistema do computador ou servidor onde o Qlik Sense está instalado. Se o servidor Qlik Sense que você está acessando estiver definido como Suécia, o Editor de carregamento de dados usará as configurações regionais suecas para datas, horas e moedas. Essas configurações de formato regional não estão relacionadas ao idioma exibido na Qlik Sense interface do usuário. Qlik Sense será exibido no mesmo idioma do navegador que você está usando.

Os exemplos abaixo pressupõem que:

Set FirstWeekDay=0; Set BrokenWeeks=0; Set ReferenceDay=4;
Exemplos de funções
Exemplo Resultado
weekname('01/12/2013') Retorna 2013/02.
weekname('01/12/2013', -1) Retorna 2013/01.
weekname('01/12/2013', 0, 1) Retorna 2013/02.

Exemplo 1: data 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 – avise-nos!