# month - Função de script e de gráfico

Esta função retorna um valor dual: um nome do mês, conforme definido na variável de ambiente MonthNames e um inteiro entre 1 e 12. O mês é calculado a partir da data de interpretação da expressão, de acordo com a interpretação do número padrão.

A função retorna o nome do mês no formato da `variável` do sistema MonthName para uma data específica. Ela é geralmente usada para criar um campo de dia como uma dimensão em um Calendário mestre.

Sintaxe:

month(expression)

Tipo de dados de retorno: inteiro

Exemplos de funções

| Exemplo | Resultado |
| --- | --- |
| `month(<br>2012-10-12 )` | retorna Oct |
| `month(<br>35648 )` | retorna Aug, por que 35648 = 1997-08-06 |

## Exemplo 1 – conjunto de dados DateFormat (script)

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/month.htm)

#### Script de carregamento e resultados

Visão geral

Abra o Data load editor e adicione o script de carregamento abaixo em uma nova guia.Editor de carregamento de dados

O script de carregamento contém:

* Um conjunto de dados de datas chamado Master\_Calendar.`` A variável do sistema `DateFormat` é definida como DD/MM/AAAA.

* Um carregamento anterior que cria um campo adicional, chamado`month_name`, usando a função `  month() `.

* Um campo adicional, chamado `long_date`, usando a função `date()` para expressar a data completa.

Script de carregamento

```

SET DateFormat='DD/MM/YYYY';

Master_Calendar:
Load
        date,
        date(date,'dd-MMMM-YYYY') as long_date,
        month(date) as month_name
Inline 
[
date
03/01/2022
03/02/2022
03/03/2022
03/04/2022
03/05/2022
03/06/2022
03/07/2022
03/08/2022
03/09/2022
03/10/2022
03/11/2022
];
```

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:

* `date`

* `long_date`

* `month_name`

Tabela de resultados

| data | long\_date | month\_name |
| --- | --- | --- |
| 03/01/2022 | 03-Janeiro- 2022 | Jan |
| 03/02/2022 | 03-Fevereiro- 2022 | Fev |
| 03/03/2022 | 03-Março- 2022 | Mar |
| 03/04/2022 | 03-Abril- 2022 | Abr |
| 03/05/2022 | 03-Maio- 2022 | Maio |
| 03/06/2022 | 03-Junho- 2022 | Jun |
| 03/07/2022 | 03-Julho- 2022 | Jul |
| 03/08/2022 | 03-Agosto- 2022 | Ago |
| 03/09/2022 | 03-Setembro- 2022 | Set |
| 03/10/2022 | 03-Outubro- 2022 | Out |
| 03/11/2022 | 03-Novembro- 2022 | Nov |

O nome do mês é avaliado corretamente pela função `month()` no script.

## Exemplo 2 – datas ANSI (script)

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/month.htm)

#### Script de carregamento e resultados

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:

* Um conjunto de dados de datas chamado `Master_Calendar`. A variável de sistema DateFormat DD/MM/AAAA é usada. No entanto, as datas incluídas no conjunto de dados estão no formato de data padrão ANSI.

* Um carregamento anterior que cria um campo adicional, chamado `month_name`, usando a função month().

* Um campo adicional, chamado `long_date`, usando a função para expressar a data completa.

Script de carregamento

```

SET DateFormat='DD/MM/YYYY'; 
Master_Calendar: 
Load 
       date, 
       date(date,'dd-MMMM-YYYY') as long_date, 
       month(date) as month_name 

Inline  
[ 
date 
2022-01-11 
2022-02-12 
2022-03-13 
2022-04-14 
2022-05-15 
2022-06-16 
2022-07-17 
2022-08-18 
2022-09-19
2022-10-20 
2022-11-21 
]; 
```

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:

* `date`

* `long_date`

* `month_name`

Tabela de resultados

| data | long\_date | month\_name |
| --- | --- | --- |
| 03/11/2022 | 11-Março- 2022 | 11 |
| 03/12/2022 | 12-Março- 2022 | 12 |
| 03/13/2022 | 13-Março- 2022 | 13 |
| 03/14/2022 | 14-Março- 2022 | 14 |
| 03/15/2022 | 15-Março- 2022 | 15 |
| 03/16/2022 | 16-Março- 2022 | 16 |
| 03/17/2022 | 17-Março- 2022 | 17 |
| 03/18/2022 | 18-Março- 2022 | 18 |
| 03/19/2022 | 19-Março- 2022 | 19 |
| 03/20/2022 | 20-Março- 2022 | 20 |
| 03/21/2022 | 21-Março- 2022 | 21 |

O nome do mês é avaliado corretamente pela função `month()` no script.

## Exemplo 3 – Datas não formatadas (script)

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/month.htm)

#### Script de carregamento e resultados

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:

* Um conjunto de dados de datas chamado `Master_Calendar`. A variável de sistema `  DateFormat ` DD/MM/AAAA é usada.

* Um carregamento anterior que cria um campo adicional, chamado `month_name`, usando a função ` month()  `.

* A data original não formatada, chamada `unformatted_date`.

* Um campo adicional, chamado `long_date`, usando a função `  date() ` para expressar a data completa.

Script de carregamento

```

SET DateFormat='DD/MM/YYYY'; 

Master_Calendar: 
Load 
      unformatted_date, 
      date(unformatted_date,'dd-MMMM-YYYY') as long_date, 
      month(unformatted_date) as month_name 

Inline
[ 
unformatted_date 
44868 
44898 
44928 
44958 
44988 
45018 
45048 
45078 
45008 
45038 
45068 
]; 
```

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:

* `unformatted_date`

* `long_date`

* `month_name`

Tabela de resultados

| unformatted\_date | long\_date | month\_name |
| --- | --- | --- |
| 44868 | 03-Janeiro- 2022 | Jan |
| 44898 | 03-Fevereiro- 2022 | Fev |
| 44928 | 03-Março- 2022 | Mar |
| 44958 | 03-Abril- 2022 | Abr |
| 44988 | 03-Maio- 2022 | Maio |
| 45018 | 03-Junho- 2022 | Jun |
| 45048 | 03-Julho- 2022 | Jul |
| 45078 | 03-Agosto- 2022 | Ago |
| 45008 | 03-Setembro- 2022 | Set |
| 45038 | 03-Outubro- 2022 | Out |
| 45068 | 03-Novembro- 2022 | Nov |

O nome do mês é avaliado corretamente pela função `month()` no script.

## Exemplo 4 – Calculando o mês de vencimento

[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/month.htm)

#### Script de carregamento e expressão 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:

* Um conjunto de dados de pedidos feitos em março chamado `Subscriptions`. A tabela contém três campos:

  * id

  * order\_date

  * amount

Script de carregamento

```

Subscriptions: 
Load 
	 id, 
	 order_date, 
	 amount 
Inline  
[ 
id,order_date,amount 
1,03/01/2022,231.24 
2,03/02/2022,567.28 
3,03/03/2022,364.28 
4,03/04/2022,575.76 
5,03/05/2022,638.68 
6,03/06/2022,785.38 
7,03/07/2022,967.46 
8,03/08/2022,287.67 
9,03/09/2022,764.45 
10,03/10/2022,875.43 
11,03/11/2022,957.35 
]; 

```

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão: `order_date`.

Para calcular o mês de expiração de um pedido, crie esta medida `=month(order_date+180)`.

Tabela de resultados

| order\_date | =month(order\_date+180) |
| --- | --- |
| 03/01/2022 | Jul |
| 03/02/2022 | Ago |
| 03/03/2022 | Ago |
| 03/04/2022 | Set |
| 03/05/2022 | Out |
| 03/06/2022 | Nov |
| 03/07/2022 | Dez |
| 03/08/2022 | Jan |
| 03/09/2022 | Mar |
| 03/10/2022 | Abr |
| 03/11/2022 | Maio |

A função `month()` determina corretamente que um pedido feito em 11 de março expiraria em julho.

## Saiba mais

* [Carregando dados de uma tabela carregada anteriormente](https://help.qlik.com/pt-BR/sense/November2025/Subsystems/Hub/Content/Sense_Hub/Scripting/load-data-from-previously-loaded-table.htm)