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

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

Essa função retornará True se timestamp estiver dentro da semana que contém base_date.

Sintaxe:  

InWeek (timestamp, base_date, period_no[, first_week_day])

Tipo de dados de retorno: Booleano

No Qlik Sense, o valor booleano “true” é representado por -1, e o valor falso é representado por 0.

Diagrama do intervalo da função inweek()

Diagrama que mostra como a função inweek() pode ser usada para avaliar datas dentro de segmentos de semanas e retornar um resultado booleano se um dado cair ou não em um intervalo selecionado.

A função inweek() usa o argumento base_date para identificar em qual período de sete dias a data cai. O dia de início da semana é baseado na variável de sistema FirstWeekDay. No entanto, você também pode alterar o primeiro dia da semana usando o argumento first_week_day da função inweek().

Depois que a semana selecionada for definida, a função retornará resultados booleanos ao comparar os valores de data prescritos com esse segmento da semana.

A função inweek() retorna um resultado booleano. Normalmente, esse tipo de função será usado como uma condição em um if expression. A função inweek() retorna uma agregação ou cálculo que depende se uma data avaliada ocorreu na semana com a data selecionada do argumento base_date.

Por exemplo, a função inweek() pode ser usada para identificar todos os equipamentos fabricados em uma semana específica.

Argumentos
Argumento Descrição
timestamp A data que você deseja comparar com base_date.
base_date Data que é usada para avaliar a semana.
period_no A semana pode ser deslocada por period_no. period_no é um inteiro, em que o valor 0 indica a semana que contém base_date. Os valores negativos em period_no indicam semanas precedentes e os valores positivos indicam semanas subsequentes.
first_week_day

Por padrão, o primeiro dia da semana é domingo (conforme determinado pela variável de sistema FirstWeekDay), começando à meia-noite entre sábado e domingo. O parâmetro first_week_day substitui a variável FirstWeekDay. Para indicar a semana que começa em outro dia, especifique um sinalizador entre 0 e 6.

Valores de first_week_day
Dia Valor
Segunda-feira 0
Terça-feira 1
Quarta-feira 2
Quinta-feira 3
Sexta-feira 4
Sábado 5
Domingo 6

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 em que 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 interface do usuário do Qlik Sense. O Qlik Sense será exibido no mesmo idioma do navegador que você está usando.

Exemplos de funções
Exemplo Resultado
inweek ('01/12/2006', '01/14/2006', 0) Retorna TRUE
inweek ('01/12/2006', '01/20/2006', 0 ) Retorna FALSE
inweek ('01/12/2006', '01/14/2006', -1 ) Retorna FALSE
inweek ('01/07/2006', '01/14/2006', -1) Retorna TRUE
inweek ('01/12/2006', '01/09/2006', 0, 3) Retorna FALSE porque first_week_day está especificado como 3 (quinta-feira), o que torna 01/12/2006 o primeiro dia da semana seguinte à semana contendo 01/09/2006.

Estes tópicos podem ajudar você a trabalhar com essa função:

Tópicos relacionados
Tópico Sinalizador/valor padrão Descrição
FirstWeekDay 6 / Domingo Define o dia de início de cada semana.

Exemplo 1: Nenhum argumento adicional

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!