month – função de script e 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
Exemplo | Resultado |
---|---|
month( 2012-10-12 ) |
retorna Oct |
month( 35648 ) | retorna Aug, por que 35648 = 1997-08-06 |
Exemplo 1 – conjunto de dados DateFormat (script)
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 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
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-May- 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)
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
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)
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
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-May- 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
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).
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.