PHP setlocale() 函數

PHP String 參考手冊 PHP String 參考手冊

實例

設置地區為 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)

參數 描述
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 中,可傳遞多個 locations

自 PHP 5.3.0 起,如果傳遞給 constant 參數的是字串,而不是 LC_ 常量之一,該函數會拋出一個 E_DREPRECATED 通知。


PHP String 參考手冊 PHP String 參考手冊