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

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

Essa função descobre se um carimbo de data/hora está dentro do mesmo mês, bimestre, trimestre, quadrimestre ou semestre como data base. Também é possível descobrir se uma data/hora está dentro de um período de tempo anterior ou seguinte.

Sintaxe:  

InMonths(n_months, timestamp, base_date, period_no [, first_month_of_year])

Tipo de dados de retorno: Booleano

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

Diagrama da função inmonths()

Diagrama que mostra o intervalo de tempo em que a função inmonths() avaliará uma data base como true ou false.

A função inmonths() divide o ano em segmentos com base no argumento n_months fornecido. Em seguida, ela determina se cada carimbo de data/hora avaliado se enquadra no mesmo segmento do argumento base_date. No entanto, se um argumento period_no for fornecido, a função determinará se os carimbos de data/hora se enquadram em um período anterior ou posterior de base_date.

Os seguintes segmentos do ano estão disponíveis na função como argumentos n_month.

Argumentos n_month
Período Número de meses
mês 1
bimestre 2
trimestre 3
quadrimestre 4
semestre 6

A função inmonths() retorna um resultado booleano. Normalmente, esse tipo de função será usado como uma condição em um if expression. Usando a função inmonths(), você pode selecionar o período que deseja avaliar. Por exemplo, permitir que o usuário identifique produtos fabricados no mês, trimestre ou semestre de um determinado período.

Tipo de dados de retorno: Booleano

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

Argumentos
Argumento Descrição
n_months

O número de meses que define o período. Um inteiro ou uma expressão que se resolve como um inteiro que deve ser um dos seguintes: 1 (equivalente à função inmonth()), 2 (bimestre), 3 (equivalente à função inquarter()), 4 (quadrimestre) ou 6 (semestre).

timestamp A data que você deseja comparar com base_date.
base_date Data que é usada para avaliar o período.
period_no

O período pode ser deslocado por period_no, um inteiro ou expressão que resolve um inteiro, no qual o valor 0 indica o período que contém base_date. Valores negativos em period_no indicam períodos precedentes e valores positivos indicam períodos sucessivos.

first_month_of_year

Se desejar trabalhar com anos (fiscais) que não comecem em janeiro, indique um valor entre 2 e 12 em first_month_of_year.

Você pode usar os seguintes valores para definir o primeiro mês do ano no argumento first_month_of_year:

Valores first_month_of_year
Month Valor
Fevereiro 2
Março 3
Abril 4
Maio 5
Junho 6
Julho 7
Agosto 8
Setembro 9
Outubro 10
Novembro 11
Dezembro 12

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.

Exemplos de funções
Exemplo Resultado
inmonths(4, '01/25/2013', '04/25/2013', 0) Retorna TRUE. Porque o valor de timestamp, 25/01/2013, está dentro do período de quatro meses de 01/01/2013 a 30/04/2013, no qual está o valor de base_date, 25/04/2013.
inmonths(4, '05/25/2013', '04/25/2013', 0) Retorna FALSE. Porque 25/05/2013 está fora do mesmo período do exemplo anterior.
inmonths(4, '11/25/2012', '02/01/2013', -1 ) Retorna TRUE. Porque o valor de period_no, -1, retrocede o período de pesquisa em um período de quatro meses (o valor de n meses), o que torna o período de pesquisa de 01/09/2012 a 31/12/2012.
inmonths(4, '05/25/2006', '03/01/2006', 0, 3) Retorna TRUE. Como o valor de first_month_of_year está definido como 3, o que torna o período de pesquisa de 01/03/2006 a 30/07/2006 em vez de 01/01/2006 a 30/04/2006.

Exemplo 1: Nenhum argumento adicional

Exemplo 2: period_no

Exemplo 3: first_month_of_year

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!