Ir para conteúdo principal

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

Esta função retornará True se timestamp estiver dentro do mês que contém base_date.

Sintaxe:  

InMonth (timestamp, base_date, period_no)

Diagrama da função indaytotime.

Diagrama mostrando as condições da função inmonth.

Em outras palavras, a função inmonth() determina se um conjunto de datas cai neste mês e retorna um valor booleano com base em uma base_date que identifica o mês.

A função inmonth() retorna um resultado booleano. Normalmente, esse tipo de função será usado como uma condição em um if expression. Isso retorna uma agregação ou cálculo dependendo de se uma data ocorreu no mês, incluindo a data em questão.

Por exemplo, a função inmonth() pode ser usada para identificar todos os equipamentos fabricados em um mês específico.

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
carimbo de data/hora A data que você deseja comparar com base_date.
base_date Data que é usada para avaliar o mês. É importante notar que base_date pode ser qualquer dia dentro de um mês.
period_no O mês pode ser deslocado por period_no. period_no é um inteiro, em que o valor 0 indica o mês que contém base_date. Valores negativos em period_no indicam meses precedentes, e valores positivos indicam meses sucessivos.

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 em uma combinação de configurações do provedor de identidade, configurações do sistema ou configurações do navegador. 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 a criação de aplicativos.

Exemplos de funções
Exemplo Resultado
inmonth ('25/01/2013', '01/01/2013', 0) Retorna True
inmonth('25/01/2013', '23/04/2013', 0) Retorna False
inmonth ('25/01/2013', '01/01/2013', -1) Retorna False
inmonth ('25/12/2012', '17/01/2013', -1) Retorna True

Exemplo 1: Sem argumentos adicionais

Exemplo 2: period_no

Exemplo 3: Objeto de gráfico

Exemplo 4: Cenário