Функции PHP setlocale()Functions

PHP String 参考手册Справочное руководство по строкам PHP

Примеры

Установите локаль US English, затем верните её к системному значению по умолчанию:

<?php
echo setlocale(LC_ALL,"US");
echo "<br>";
echo setlocale(LC_ALL,NULL);
?>

Запустить пример »

Определение и использование

Функция setlocale() устанавливает информацию о локали (региональную информацию).

Информация о локали — это язык, валюта, время и другие сведения для географического региона.

Примечание:Функция setlocale() изменяет информацию о локали только для текущего скрипта.

Совет:Вы можете установить информацию о локали по умолчанию для системы с помощью setlocale(LC_ALL,NULL).

Совет:Чтобы получить информацию о числовом формате, обратитесь к функцииlocaleconv().


Синтаксис

setlocale(constant,location)

Parameters Описание
constant Обязательный. Указывает, какую информацию о локали следует установить.

Доступные константы:

  • LC_ALL - все параметры ниже
  • LC_COLLATE - порядок сортировки
  • LC_CTYPE - классификация и преобразование символов (например, все символы в верхнем или нижнем регистре)
  • LC_MESSAGES - формат системных сообщений
  • LC_MONETARY - формат валюты
  • LC_NUMERIC - числовой формат
  • LC_TIME - формат даты и времени
location Обязательный. Указывает, для какой страны/региона задать информацию о локали. Может быть строкой или массивом. Можно передать несколько локаций.

Если параметр location равен NULL или пустой строке "", имя локации будет установлено в значение переменной окружения с тем же именем, что и у указанных выше констант, либо установлено в соответствии с "LANG".

Если параметр location равен "0", настройка локали не изменяется, и возвращается только текущая настройка.

Если параметр location является массивом, setlocale() перебирает каждый элемент массива, пока не найдет допустимый код языка или региона. Это полезно, если регион имеет разные названия в разных системах.

Примечание:Чтобы просмотреть все доступные языковые коды, посетите наш справочник по языковым кодам.

Технические детали

Возвращаемое значение: Возвращает текущую настройку локали или FALSE при ошибке. Возвращаемое значение зависит от системы, на которой выполняется PHP.
Версия PHP: 4+
Список изменений: В PHP 4.2.0 передача констант в виде строк была объявлена устаревшей. Вместо этого используйте доступные константы. Передача констант в виде строк будет генерировать предупреждение.

В PHP 4.3.0 можно передавать несколько локаций.локации。

Начиная с PHP 5.3.0, если в параметр, предназначенный для констант, передается строка вместо одной из констант LC_, функция выдает уведомление E_DEPRECATED.


PHP String 参考手册Справочное руководство по строкам PHP Другие расширения