Função MySQL MONTHNAME()

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 orderstabela do banco de dados de exemplo :

O exemplo a seguir usa MONTHNAMEpara 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_namescontrola 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_namespara controlar o idioma do nome do mês.