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
Diagrama da função monthname
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 as configurações regionais do aplicativo.
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.
Diagrama da função monthname, exemplo básico
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.
Diagrama da função monthname, exemplo de period_no
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.
Diagrama da função monthname, exemplo de objeto de gráfico
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!