MONTHNAME¶

Sintaxe¶

MONTHNAME( <date_or_timestamp_expr> )

Argumentos¶

date_or_timestamp_expr

Uma data ou um carimbo de data/hora, ou uma expressão que pode ser avaliada como uma data ou um carimbo de data/hora.

Retornos¶

Esta função retorna um valor do tipo VARCHAR.

Notas de uso¶

Para retornar o nome completo do mês em vez do nome do mês com três letras, você pode usar a função TO_CHAR com a função TO_DATE ou TO_TIMESTAMP. O exemplo a seguir usa as funções TO_CHAR e TO_DATE para retornar o nome completo do mês para a data 2025-01-01:

SELECT TO_CHAR(TO_DATE('2025-01-01'), 'MMMM') AS full_month_name;

+-----------------+
| FULL_MONTH_NAME |
|-----------------|
| January         |
+-----------------+

Exemplos¶

Os exemplos a seguir usam a função MONTHNAME.

Retorna o nome do mês de três letras de uma data:

SELECT MONTHNAME(TO_DATE('2025-01-01')) AS month;

+-------+
| MONTH |
|-------|
| Jan   |
+-------+

Retorna o nome do mês de três letras de um carimbo de data/hora:

SELECT MONTHNAME(TO_TIMESTAMP('2025-04-03 10:00')) AS month;

+-------+
| MONTH |
|-------|
| Apr   |
+-------+

Retorna o nome do mês de três letras de valores DATE em uma coluna.

Primeiro, crie uma tabela com uma coluna DATE e insira vários valores DATE:

CREATE OR REPLACE TABLE monthname_function_demo (d DATE);

INSERT INTO monthname_function_demo (d) VALUES
  ('2024-01-01'::DATE),
  ('2024-02-02'::DATE),
  ('2024-03-03'::DATE),
  ('2024-04-04'::DATE),
  ('2024-05-05'::DATE),
  ('2024-06-06'::DATE),
  ('2024-07-07'::DATE),
  ('2024-08-08'::DATE),
  ('2024-09-09'::DATE),
  ('2024-10-10'::DATE),
  ('2024-11-11'::DATE),
  ('2024-12-12'::DATE);

Use a função MONTHNAME em uma consulta para retornar o nome do mês de três letras de cada valor na coluna d:

SELECT d,
       MONTHNAME(d) AS month
  FROM monthname_function_demo;

+------------+-------+
| D          | MONTH |
|------------+-------|
| 2024-01-01 | Jan   |
| 2024-02-02 | Feb   |
| 2024-03-03 | Mar   |
| 2024-04-04 | Apr   |
| 2024-05-05 | May   |
| 2024-06-06 | Jun   |
| 2024-07-07 | Jul   |
| 2024-08-08 | Aug   |
| 2024-09-09 | Sep   |
| 2024-10-10 | Oct   |
| 2024-11-11 | Nov   |
| 2024-12-12 | Dec   |
+------------+-------+