12.16 MySQL Server Locale Support — MySQL 9.2

12.16 Поддержка локалей MySQL Server

Локаль, указанная системной переменной lc_time_names, управляет языком, используемым для отображения названий и сокращений дней и месяцев. Эта переменная влияет на вывод функций DATE_FORMAT(), DAYNAME() и MONTHNAME().

lc_time_names не влияет на функцию STR_TO_DATE() или GET_FORMAT().

Значение lc_time_names не влияет на результат из FORMAT(), но эта функция принимает необязательный третий параметр, который позволяет указать локаль, используемую для десятичной точки, разделителя тысяч и группировки чисел результата. Разрешенные значения локалей совпадают с допустимыми значениями системной переменной lc_time_names.

Имена локалей содержат языковые и региональные подтеги, перечисленные в IANA (http://www.iana.org/assignments/language-subtag-registry), такие как 'ja_JP' или 'pt_BR'. Значение по умолчанию равно 'en_US' независимо от настроек локали вашей системы, но вы можете установить значение при запуске сервера или установить значение GLOBAL во время выполнения, если у вас есть достаточные привилегии для установки глобальных системных переменных; см. Раздел 7.1.9.1, «Привилегии на системные переменные». Любой клиент может проверить значение lc_time_names или установить его значение SESSION для изменения локали для собственного подключения.

(Первое утверждение SET NAMES в следующем примере может быть не обязательно, если никакие настройки, относящиеся к набору символов и сортировке, не были изменены от значений по умолчанию; мы включаем его для полноты.)

mysql> SET NAMES 'utf8mb4';
Query OK, 0 rows affected (0.09 sec)

mysql> SELECT @@lc_time_names;
+-----------------+
| @@lc_time_names |
+-----------------+
| en_US           |
+-----------------+
1 row in set (0.00 sec)

mysql> SELECT DAYNAME('2020-01-01'), MONTHNAME('2020-01-01');
+-----------------------+-------------------------+
| DAYNAME('2020-01-01') | MONTHNAME('2020-01-01') |
+-----------------------+-------------------------+
| Wednesday             | January                 |
+-----------------------+-------------------------+
1 row in set (0.00 sec)

mysql> SELECT DATE_FORMAT('2020-01-01','%W %a %M %b');
+-----------------------------------------+
| DATE_FORMAT('2020-01-01','%W %a %M %b') |
+-----------------------------------------+
| Wednesday Wed January Jan               |
+-----------------------------------------+
1 row in set (0.00 sec)

mysql> SET lc_time_names = 'es_MX';
Query OK, 0 rows affected (0.00 sec)

mysql> SELECT @@lc_time_names;
+-----------------+
| @@lc_time_names |
+-----------------+
| es_MX           |
+-----------------+
1 row in set (0.00 sec)

mysql> SELECT DAYNAME('2020-01-01'), MONTHNAME('2020-01-01');
+-----------------------+-------------------------+
| DAYNAME('2020-01-01') | MONTHNAME('2020-01-01') |
+-----------------------+-------------------------+
| miércoles             | enero                   |
+-----------------------+-------------------------+
1 row in set (0.00 sec)

mysql> SELECT DATE_FORMAT('2020-01-01','%W %a %M %b');
+-----------------------------------------+
| DATE_FORMAT('2020-01-01','%W %a %M %b') |
+-----------------------------------------+
| miércoles mié enero ene                 |
+-----------------------------------------+
1 row in set (0.00 sec)

Имя дня или месяца для каждой из затронутых функций преобразуется из utf8mb4 в набор символов, указанный системной переменной character_set_connection.

lc_time_names можно установить на любое из следующих значений локалей. Набор локалей, поддерживаемых MySQL, может отличаться от набора локалей, поддерживаемых вашей операционной системой.

Значение локали	Значение
`ar_AE`	Арабский – Объединённые Арабские Эмираты
`ar_BH`	Арабский – Бахрейн
`ar_DZ`	Арабский – Алжир
`ar_EG`	Арабский – Египет
`ar_IN`	Арабский – Индия
`ar_IQ`	Арабский – Ирак
`ar_JO`	Арабский – Иордания
`ar_KW`	Арабский – Кувейт
`ar_LB`	Арабский – Ливан
`ar_LY`	Арабский – Ливия
`ar_MA`	Арабский – Марокко
`ar_OM`	Арабский – Оман
`ar_QA`	Арабский – Катар
`ar_SA`	Арабский – Саудовская Аравия
`ar_SD`	Арабский – Судан
`ar_SY`	Арабский – Сирия
`ar_TN`	Арабский – Тунис
`ar_YE`	Арабский – Йемен
`be_BY`	Белорусский – Беларусь
`bg_BG`	Болгарский – Болгария
`ca_ES`	Каталанский – Испания
`cs_CZ`	Чешский – Чешская Республика
`da_DK`	Датский – Дания
`de_AT`	Немецкий – Австрия
`de_BE`	Немецкий – Бельгия
`de_CH`	Немецкий – Швейцария
`de_DE`	Немецкий – Германия
`de_LU`	Немецкий – Люксембург
`el_GR`	Греческий – Греция
`en_AU`	Английский – Австралия
`en_CA`	Английский – Канада
`en_GB`	Английский – Соединённое Королевство
`en_IN`	Английский – Индия
`en_NZ`	Английский – Новая Зеландия
`en_PH`	Английский – Филиппины
`en_US`	Английский – Соединённые Штаты
`en_ZA`	Английский – Южная Африка
`en_ZW`	Английский – Зимбабве
`es_AR`	Испанский – Аргентина
`es_BO`	Испанский – Боливия
`es_CL`	Испанский – Чили
`es_CO`	Испанский – Колумбия
`es_CR`	Испанский – Коста-Рика
`es_DO`	Испанский – Доминиканская Республика
`es_EC`	Испанский – Эквадор
`es_ES`	Испанский – Испания
`es_GT`	Испанский – Гватемала
`es_HN`	Испанский – Гондурас
`es_MX`	Испанский – Мексика
`es_NI`	Испанский – Никарагуа
`es_PA`	Испанский – Панама
`es_PE`	Испанский – Перу
`es_PR`	Испанский – Пуэрто-Рико
`es_PY`	Испанский – Парагвай
`es_SV`	Испанский – Сальвадор
`es_US`	Испанский – Соединённые Штаты
`es_UY`	Испанский – Уругвай
`es_VE`	Испанский – Венесуэла
`et_EE`	Эстонский – Эстония
`eu_ES`	Баскский – Испания
`fi_FI`	Финский – Финляндия
`fo_FO`	Фарерский – Фарерские острова
`fr_BE`	Французский – Бельгия
`fr_CA`	Французский – Канада
`fr_CH`	Французский – Швейцария
`fr_FR`	Французский – Франция
`fr_LU`	Французский – Люксембург
`gl_ES`	Галисийский – Испания
`gu_IN`	Гуджарати – Индия
`he_IL`	Иврит – Израиль
`hi_IN`	Хинди – Индия
`hr_HR`	Хорватский – Хорватия
`hu_HU`	Венгерский – Венгрия
`id_ID`	Индонезийский – Индонезия
`is_IS`	Исландский – Исландия
`it_CH`	Итальянский – Швейцария
`it_IT`	Итальянский – Италия
`ja_JP`	Японский – Япония
`ko_KR`	Корейский – Республика Корея
`lt_LT`	Литовский – Литва
`lv_LV`	Латвийский – Латвия
`mk_MK`	Македонский – Северная Македония
`mn_MN`	Монгольский – Монголия
`ms_MY`	Малайский – Малайзия
`nb_NO`	Норвежский (букмол) – Норвегия
`nl_BE`	Нидерландский – Бельгия
`nl_NL`	Нидерландский – Нидерланды
`no_NO`	Норвежский – Норвегия
`pl_PL`	Польский – Польша
`pt_BR`	Португальский – Бразилия
`pt_PT`	Португальский – Португалия
`rm_CH`	Ретороманский – Швейцария
`ro_RO`	Румынский – Румыния
`ru_RU`	Русский – Россия
`ru_UA`	Русский – Украина
`sk_SK`	Словацкий – Словакия
`sl_SI`	Словенский – Словения
`sq_AL`	Албанский – Албания
`sr_RS`	Сербский – Сербия
`sv_FI`	Шведский – Финляндия
`sv_SE`	Шведский – Швеция
`ta_IN`	Тамильский – Индия
`te_IN`	Телугу – Индия
`th_TH`	Тайский – Таиланд
`tr_TR`	Турецкий – Турция
`uk_UA`	Украинский – Украина
`ur_PK`	Урду – Пакистан
`vi_VN`	Вьетнамский – Вьетнам
`zh_CN`	Китайский – Китай
`zh_HK`	Китайский – Гонконг
`zh_TW`	Китайский – Тайвань