PHP setlocale()関数

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 リファレンスマニュアル その他の拡張機能