MariaDB MONTHNAME() 函数使用指南
在 MariaDB 中,MONTHNAME()
是一个内置函数,它返回给定日期的月份名称。
它接受一个参数,即要从中提取月份名称的日期。
MariaDB MONTHNAME()
语法
这是 MariaDB MONTHNAME()
函数的语法:
MONTHNAME(date)
参数
date
- 必需的。一个日期或者日期时间表达式。
如果您提供了错误数量的参数,MariaDB 将报告一个错误:ERROR 1582 (42000): Incorrect parameter count in the call to native function 'MONTHNAME'
。
返回值
MariaDB MONTHNAME()
函数返回给定日期的月份的名字。在英语环境下,MONTHNAME()
返回值将是以下值中的一个: January
, February
, March
, April
, May
, June
, July
, August
, September
, October
, November
, December
。
如果指定的表达式不是一个合法的日期或者日期时间,MONTHNAME()
函数将返回 NULL
。
如果参数为 NULL
,MONTHNAME()
函数将返回 NULL
。
MariaDB MONTHNAME()
示例
示例 1
这个语句展示了 MariaDB MONTHNAME()
函数的基本用法:
SELECT
MONTHNAME('2023-01-11'),
MONTHNAME('2023-01-11 10:11:12');
输出:
+-------------------------+----------------------------------+
| MONTHNAME('2023-01-11') | MONTHNAME('2023-01-11 10:11:12') |
+-------------------------+----------------------------------+
| January | January |
+-------------------------+----------------------------------+
示例 2
这个语句展示所有月份的名称:
SELECT
MONTHNAME('2023-01-01'),
MONTHNAME('2023-02-01'),
MONTHNAME('2023-03-01'),
MONTHNAME('2023-04-01'),
MONTHNAME('2023-05-01'),
MONTHNAME('2023-06-01'),
MONTHNAME('2023-07-01'),
MONTHNAME('2023-08-01'),
MONTHNAME('2023-09-01'),
MONTHNAME('2023-10-01'),
MONTHNAME('2023-11-01'),
MONTHNAME('2023-12-01')\G
输出:
MONTHNAME('2023-01-01'): January
MONTHNAME('2023-02-01'): February
MONTHNAME('2023-03-01'): March
MONTHNAME('2023-04-01'): April
MONTHNAME('2023-05-01'): May
MONTHNAME('2023-06-01'): June
MONTHNAME('2023-07-01'): July
MONTHNAME('2023-08-01'): August
MONTHNAME('2023-09-01'): September
MONTHNAME('2023-10-01'): October
MONTHNAME('2023-11-01'): November
MONTHNAME('2023-12-01'): December
示例 3 - 区域
月份名称使用的语言由 lc_time_names
系统变量的值控制。
要显示中文的月份名称,请先将区域设置为 zh_CN
:
SET lc_time_names = 'zh_CN';
SELECT MONTHNAME('2023-01-11');
输出:
+-------------------------+
| MONTHNAME('2023-01-11') |
+-------------------------+
| 一月 |
+-------------------------+
你可以在此处检查 MariaDB 支持的区域设置列表。
结论
在 MariaDB 中,MONTHNAME()
是一个内置函数,它返回给定日期的月份名称。