在 MariaDB 中以不同语言返回月份和星期名称

详细介绍在 MariaDB 中如何通过 DATE_FORMAT() 函数的语言环境(locale)参数或配置 lc_time_names 系统变量,输出多语言(如中文、英语、西班牙语)格式的月份全名与星期名称。

发布于

在多语言国际化(i18n)的 Web 应用程序或报表系统中,常需要直接由数据库返回符合目标语言习惯的月份与星期名称(例如将 Wednesday 显示为 星期三 或 miércoles)。

在 MariaDB 中,DATE_FORMAT() 函数不仅能够格式化日期,还支持指定语言环境(Locale)。

本文介绍两种多语言日期输出方式:直接在函数中传入 locale 参数与配置会话变量 @@lc_time_names。


检查当前默认语言设置

MariaDB 默认使用服务器或会话级别的 @@lc_time_names 系统变量决定日期时间文本的语言。通常默认值为 'en_US'(美国英语):

SELECT @@lc_time_names;

输出:

+-----------------+
| @@lc_time_names |
+-----------------+
| en_US           |
+-----------------+

若需查看 MariaDB 支持的全部区域语言代码列表,请参阅在 MariaDB 中查看所有支持的区域设置。


方法 1:在 DATE_FORMAT() 中直接传入 locale 参数

从 MariaDB 10.3 开始,DATE_FORMAT() 支持第三个可选参数 locale:

DATE_FORMAT(date, format[, locale])

这种方式最适合在同一条 SQL 查询中并排输出不同语种的结果,而无需改变整个数据库会话的全局状态。

示例 1:获取多语言月份名称

获取月份名称使用说明符 %M。下面的语句同时展示了默认语言、英语(en_US)、西班牙语(es_ES)以及简体中文(zh_CN)下的 1 月份名称:

SELECT
  DATE_FORMAT('2025-01-01', '%M') AS "Default",
  DATE_FORMAT('2025-01-01', '%M', 'en_US') AS "en_US",
  DATE_FORMAT('2025-01-01', '%M', 'es_ES') AS "es_ES",
  DATE_FORMAT('2025-01-01', '%M', 'zh_CN') AS "zh_CN";

输出:

+---------+---------+-------+--------+
| Default | en_US   | es_ES | zh_CN  |
+---------+---------+-------+--------+
| January | January | enero | 一月   |
+---------+---------+-------+--------+

关于获取月份名称的其他方式,可以参考在 MariaDB 中获取月份名称的 3 种方法。


示例 2:获取多语言星期名称

获取工作日(星期几)全名使用说明符 %W:

SELECT
  DATE_FORMAT('2025-01-01', '%W') AS "Default",
  DATE_FORMAT('2025-01-01', '%W', 'en_US') AS "en_US",
  DATE_FORMAT('2025-01-01', '%W', 'es_ES') AS "es_ES",
  DATE_FORMAT('2025-01-01', '%W', 'zh_CN') AS "zh_CN";

输出:

+-----------+-----------+------------+-----------+
| Default   | en_US     | es_ES      | zh_CN     |
+-----------+-----------+------------+-----------+
| Wednesday | Wednesday | miércoles  | 星期三    |
+-----------+-----------+------------+-----------+

关于星期名称的其他用法,可以参考在 MariaDB 中获取工作日名称的 3 种方法。


方法 2:通过会话变量 lc_time_names 批量生效

如果当前连接或存储过程中的所有日期格式化操作都固定为同一种语言,直接修改会话级变量 lc_time_names 更加简明:

SET lc_time_names = 'zh_CN';

SELECT
  DATE_FORMAT('2025-01-01', '%M') AS "Month",
  DATE_FORMAT('2025-01-01', '%W') AS "Day_Name";

输出:

+-------+----------+
| Month | Day_Name |
+-------+----------+
| 一月  | 星期三   |
+-------+----------+

[!TIP] SET lc_time_names = 'zh_CN'; 仅对当前数据库连接(会话)有效,不会影响其他并发客户端或持久化配置,非常安全。


总结

  • 单次局部转换推荐在 DATE_FORMAT(date, format, locale) 中直接指定第三个参数(如 'zh_CN'、'es_ES')。
  • 整个会话统一语言推荐使用 SET lc_time_names = 'zh_CN';。