Esta função retorna um valor de exibição que mostra o mês (formatado de acordo com a variável de script MonthNames) e o ano com um valor numérico subjacente que corresponde a um carimbo de hora do primeiro milissegundo do primeiro dia do mês.
Sintaxe:
MonthName(date[, period_no])
Tipo de dados de retorno: dual
Argumentos
Argumento
Descrição
date
A data ou o carimbo de data/hora a ser avaliado.
period_no
period_no é um inteiro, no qual, se 0 ou omitido, indica o mês que contém date. Valores negativos em period_no indicam meses precedentes e valores positivos indicam meses sucessivos.
Exemplos de funções
Exemplo
Resultado
monthname('10/19/2013')
Retorna Oct 2013
monthname('10/19/2013', -1)
Retorna Sep 2013
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.
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:
date
transaction_month
Tabela de resultados
date
transaction_month
1/7/2022
Jan 2022
1/19/2022
Jan 2022
2/5/2022
Feb 2022
2/28/2022
Feb 2022
3/16/2022
Mar 2022
4/1/2022
Apr 2022
5/7/2022
May 2022
5/16/2022
May 2022
6/15/2022
Jun 2022
6/26/2022
Jun 2022
7/9/2022
Jul 2022
7/22/2022
Jul 2022
7/23/2022
Jul 2022
7/27/2022
Jul 2022
8/2/2022
Aug 2022
8/8/2022
Aug 2022
8/19/2022
Aug 2022
9/26/2022
Sep 2022
10/14/2022
Oct 2022
10/29/2022
Oct 2022
O campo transaction_month é criado na instrução de carregamento anterior usando a função monthname() e transmitindo o campo date como o argumento da função.
A função monthname() identifica que a transação 8192 ocorreu em março de 2022 e retorna esse valor usando a variável do sistema MonthNames.
Exemplo 2: period_no
Visão geral
Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova guia.
O script de carregamento contém:
O mesmo conjunto de dados inline e cenário do primeiro exemplo.
A criação de um campo, transaction_previous_month, que retorna o carimbo de data/hora do final do mês anterior à transação.
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:
date
transaction_previous_month
Tabela de resultados
date
transaction_previous_month
1/7/2022
Dez 2021
1/19/2022
Dez 2021
2/5/2022
Jan 2022
2/28/2022
Jan 2022
3/16/2022
Feb 2022
4/1/2022
Mar 2022
5/7/2022
Apr 2022
5/16/2022
Apr 2022
6/15/2022
May 2022
6/26/2022
May 2022
7/9/2022
Jun 2022
7/22/2022
Jun 2022
7/23/2022
Jun 2022
7/27/2022
Jun 2022
8/2/2022
Jul 2022
8/8/2022
Jul 2022
8/19/2022
Jul 2022
9/26/2022
Aug 2022
10/14/2022
Sep 2022
10/29/2022
Sep 2022
Nesse caso, como um period_no de -1 foi usado como o argumento de deslocamento na função monthname(), a função primeiro identifica o mês em que as transações ocorrem. Em seguida, ela muda para um mês anterior e retorna o nome desse mês e o ano.
A transação 8192 ocorreu em 16 de março. A função monthname() identifica que o mês anterior à transação foi fevereiro e retorna esse mês, no formato da variável do sistema MonthNames, junto com o ano 2022.
Exemplo 3: Exemplo de objeto de gráfico
Visão geral
Abra o editor de carregamento de dados e adicione o script de carregamento abaixo em uma nova guia.
O script de carregamento contém o mesmo conjunto de dados inline e cenário do primeiro exemplo. No entanto, neste exemplo, o conjunto de dados inalterado é carregado no aplicativo. O cálculo que retorna um carimbo de data/hora para o final do mês em que as transações ocorreram é criado como uma medida em um objeto de gráfico do aplicativo.
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:date.
Crie a seguinte medida:
=monthname(date)
Tabela de resultados
date
=monthname(date)
1/7/2022
Jan 2022
1/19/2022
Jan 2022
2/5/2022
Feb 2022
2/28/2022
Feb 2022
3/16/2022
Mar 2022
4/1/2022
Apr 2022
5/7/2022
May 2022
5/16/2022
May 2022
6/15/2022
Jun 2022
6/26/2022
Jun 2022
7/9/2022
Jul 2022
7/22/2022
Jul 2022
7/23/2022
Jul 2022
7/27/2022
Jul 2022
8/2/2022
Aug 2022
8/8/2022
Aug 2022
8/19/2022
Aug 2022
9/26/2022
Sep 2022
10/14/2022
Oct 2022
10/29/2022
Oct 2022
A medida month_name é criada no objeto de gráfico usando a função monthname() e transmitindo o campo date como argumento da função.
A função monthname() identifica que a transação 8192 ocorreu em março de 2022 e retorna esse valor usando a variável do sistema MonthNames.
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!