Resumo : neste tutorial você aprenderá como usar a MONTHNAME()
função MySQL para retornar o nome de um mês para uma data específica.
Introdução à função MySQL MONTHNAME()
A MONTHNAME()
função retorna o nome e de um mês para uma data .
Aqui está a sintaxe da MONTHNAME()
função:
MONTHNAME(date)
Linguagem de código: SQL (linguagem de consulta estruturada) ( sql )
Nesta sintaxe:
date
: Esta é a data em que você deseja obter o nome do mês.
A MONTHNAME()
função retorna uma string que representa o nome do mês para a data especificada.
Se a data for NULL
, a MONTHNAME()
função retornará NULL
.
Exemplo de função MySQL MONTHNAME()
Vejamos alguns exemplos de uso da MONTHNAME()
função.
1) Exemplo simples de função MONTHNAME()
O exemplo a seguir usa a MONTHNAME()
função para obter o nome do mês da data '2023-10-16'
:
SELECT MONTHNAME('2023-10-16') Month;
Linguagem de código: SQL (linguagem de consulta estruturada) ( sql )
Saída:
+---------+
| Month |
+---------+
| October |
+---------+
1 row in set (0.00 sec)
Linguagem de código: SQL (linguagem de consulta estruturada) ( sql )
2) Usando a função MONTHNAME com dados da tabela
Usaremos a orders
tabela do banco de dados de exemplo :
O exemplo a seguir usa MONTHNAME
para contar o número de pedidos por mês em 2004
:
SELECT
MONTHNAME(orderDate) month,
COUNT(*) orderCount
FROM
orders
WHERE YEAR(orderDate) = 2004
GROUP BY
MONTHNAME(orderDate)
Linguagem de código: SQL (linguagem de consulta estruturada) ( sql )
Saída:
+-----------+------------+
| month | orderCount |
+-----------+------------+
| January | 8 |
| February | 11 |
| March | 8 |
| April | 10 |
| May | 8 |
| June | 12 |
| July | 11 |
| August | 12 |
| September | 12 |
| October | 13 |
| November | 33 |
| December | 13 |
+-----------+------------+
12 rows in set (0.00 sec)
Linguagem de código: SQL (linguagem de consulta estruturada) ( sql )
Linguagem
A variável de sistema @@lc_time_names
controla o idioma do nome do mês.
Para visualizar a localidade atual, você usa a seguinte instrução:
SELECT @@lc_time_names;
Linguagem de código: SQL (linguagem de consulta estruturada) ( sql )
Saída:
+-----------------+
| @@lc_time_names |
+-----------------+
| en_US |
+-----------------+
1 row in set (0.00 sec)
Linguagem de código: SQL (linguagem de consulta estruturada) ( sql )
A localidade atual é en_US
. Portanto, você verá o nome do mês em inglês, como janeiro, fevereiro, etc.
Para obter o nome do mês em um idioma diferente, você precisa alterar a localidade atual para a desejada.
Por exemplo, a instrução a seguir altera a localidade atual para fr_FR
:
SET @@lc_time_names = 'fr_FR';
Linguagem de código: SQL (linguagem de consulta estruturada) ( sql )
Agora, se você recuperar o nome do mês de uma data, obterá o nome do mês em francês em vez de inglês. Por exemplo:
SELECT MONTHNAME('2023-10-16') Month;
Linguagem de código: SQL (linguagem de consulta estruturada) ( sql )
Saída:
+---------+
| Month |
+---------+
| octobre |
+---------+
1 row in set (0.00 sec)
Linguagem de código: SQL (linguagem de consulta estruturada) ( sql )
Resumo
- Use a
MONTHNAME()
função para obter o nome do mês de uma data específica. - Use a variável @@
lc_time_names
para controlar o idioma do nome do mês.