関数・クラス解説

nl_langinfo

version:PHP 4 >= 4.1.0, PHP 5, PHP 7 (公式)

現在のロケール情報の、言語に関する各種情報を取得する

注意

この関数は Windows 環境にはまだ実装されていません

フォーマット

string : nl_langinfo ( int $item )

パラメータ

int $item
取得する項目を定数(あるいは数値)で指定。定数は以下を参照してください。なおロケールによっては、指定できないものもあります。

nl_langinfo 定数
定数説明
LC_TIME カテゴリの定数
ABDAY_(1-7)一週間中の n 番目の曜日名の略式表記
DAY_(1-7)一週間中の n 番目の曜日名 (DAY_1 = 日曜日)
ABMON_(1-12)n 番目の月の名前の略式表記
MON_(1-12)n 番目の月の名前
AM_STR午前を表す文字列
PM_STR午後を表す文字列
D_T_FMTstrftime() で日時を表すためのフォーマット文字列として使用することが可能な文字列
D_FMTstrftime() で日付を表すためのフォーマット文字列として使用することが可能な文字列
T_FMTstrftime() で時刻を表すためのフォーマット文字列として使用することが可能な文字列
T_FMT_AMPMstrftime() でAM/PM付き 12 時間表記を表すためのフォーマット文字列として使用することが可能な文字列
ERAロケール固有の元号付きフォーマット
ERA_YEARロケール固有の元号付きフォーマットでの年
ERA_D_T_FMTロケール固有の元号付きフォーマットでの日時 (strftime() で使用可能な文字列)
ERA_D_FMTロケール固有の元号付きフォーマットでの日付 (strftime() で使用可能な文字列)
ERA_T_FMTロケール固有の元号付きフォーマットでの時刻 (strftime() で使用可能な文字列)
LC_MONETARY カテゴリの定数
INT_CURR_SYMBOL国際通貨記号
CURRENCY_SYMBOL地域通貨記号
CRNCYSTRCURRENCY_SYMBOL と同じ値
MON_DECIMAL_POINT小数点文字
MON_THOUSANDS_SEP1000 単位桁区切り (3 桁ごとのグループ化) の区切り文字
MON_GROUPING'grouping' と同じ
POSITIVE_SIGN正値の表示に使用される記号
NEGATIVE_SIGN負値の表示に使用される記号
INT_FRAC_DIGITS国際的な方法で表現する際の小数点以下の桁数
FRAC_DIGITS地域的な方法で表現する際の小数点以下の桁数
P_CS_PRECEDESCURRENCY_SYMBOL の前に正値がある場合 1 を返す
P_SEP_BY_SPACECURRENCY_SYMBOL と正値がスペースで区切られる場合 1 を返す
N_CS_PRECEDESCURRENCY_SYMBOL の前に負値がある場合 1 を返す
N_SEP_BY_SPACECURRENCY_SYMBOL と負値がスペースで区切られる場合 1 を返す
P_SIGN_POSN
  • 量および CURRENCY_SYMBOL を括弧で括る場合、0 を返す
  • 量および CURRENCY_SYMBOL の前に符号文字列を置く場合、1 を返す
  • 量および CURRENCY_SYMBOL の後に符号文字列を置く場合、2 を返す
  • CURRENCY_SYMBOL の直前に符号文字列を置く場合、3 を返す
  • CURRENCY_SYMBOL の直後に符号文字列を置く場合、4 を返す
N_SIGN_POSN
LC_NUMERIC カテゴリの定数
DECIMAL_POINT小数点文字
RADIXCHARDECIMAL_POINT と同じ値
THOUSANDS_SEP1000 単位桁区切り (3 桁ごとのグループ化) の区切り文字
THOUSEPTHOUSANDS_SEP と同じ値
GROUPING
LC_MESSAGES カテゴリの定数
YESEXPR"はい" の入力にマッチさせるための正規表現
NOEXPR"いいえ" の入力にマッチさせるための正規表現
YESSTR"はい" のための出力文字列
NOSTR"いいえ" のための出力文字列
LC_CTYPE カテゴリの定数
CODESET文字エンコーディング名の文字列を返す


返値 string
指定した情報を文字列で返します。無効なitem を指定した場合は FALSE が返ります。

解説

現在のロケールの言語・数値情報などを取得できます。似たような関数にlocaleconv()がありますが、nl_langinfo は全ての要素を取得できます。 nl_langinfo() はいかなる特定要素も取得可能です。

記述サンプル

サンプルコードはありません

参考リンク

localeconv 現在のロケール(設定された地域)の数値フォーマットに関する情報を得る
setlocale ロケール情報の設定を行う

タグ

言語 ロケール String 文字列


公式リファレンス

書式

nl_langinfo ( int $item ) : string

説明

nl_langinfo() はロケールカテゴリの独立した要素にアクセスするために使用されます。 localeconv() と異なり、全ての要素を返します。 nl_langinfo() はいかなる特定要素も取得可能です。

パラメータ

item
item は要素の整数値、もしくは要素の定数名です。 以下は、使用される item に対する定数名と説明の一覧です。 これらの定数のいくつかは特定のロケールに対して未定義、 もしくは値がありません。
nl_langinfo 定数
定数 説明
LC_TIME カテゴリの定数
ABDAY_(1-7) 一週間中の n 番目の曜日名の略式表記
DAY_(1-7) 一週間中の n 番目の曜日名 (DAY_1 = 日曜日)
ABMON_(1-12) n 番目の月の名前の略式表記
MON_(1-12) n 番目の月の名前
AM_STR 午前を表す文字列
PM_STR 午後を表す文字列
D_T_FMT strftime() で日時を表すためのフォーマット文字列として使用することが可能な文字列
D_FMT strftime() で日付を表すためのフォーマット文字列として使用することが可能な文字列
T_FMT strftime() で時刻を表すためのフォーマット文字列として使用することが可能な文字列
T_FMT_AMPM strftime() でAM/PM付き 12 時間表記を表すためのフォーマット文字列として使用することが可能な文字列
ERA ロケール固有の元号付きフォーマット
ERA_YEAR ロケール固有の元号付きフォーマットでの年
ERA_D_T_FMT ロケール固有の元号付きフォーマットでの日時 (strftime() で使用可能な文字列)
ERA_D_FMT ロケール固有の元号付きフォーマットでの日付 (strftime() で使用可能な文字列)
ERA_T_FMT ロケール固有の元号付きフォーマットでの時刻 (strftime() で使用可能な文字列)
LC_MONETARY カテゴリの定数
INT_CURR_SYMBOL 国際通貨記号
CURRENCY_SYMBOL 地域通貨記号
CRNCYSTR CURRENCY_SYMBOL と同じ値
MON_DECIMAL_POINT 小数点文字
MON_THOUSANDS_SEP 1000 単位桁区切り (3 桁ごとのグループ化) の区切り文字
MON_GROUPING 'grouping' と同じ
POSITIVE_SIGN 正値の表示に使用される記号
NEGATIVE_SIGN 負値の表示に使用される記号
INT_FRAC_DIGITS 国際的な方法で表現する際の小数点以下の桁数
FRAC_DIGITS 地域的な方法で表現する際の小数点以下の桁数
P_CS_PRECEDES CURRENCY_SYMBOL の前に正値がある場合 1 を返す
P_SEP_BY_SPACE CURRENCY_SYMBOL と正値がスペースで区切られる場合 1 を返す
N_CS_PRECEDES CURRENCY_SYMBOL の前に負値がある場合 1 を返す
N_SEP_BY_SPACE CURRENCY_SYMBOL と負値がスペースで区切られる場合 1 を返す
P_SIGN_POSN
  • 量および CURRENCY_SYMBOL を括弧で括る場合、0 を返す
  • 量および CURRENCY_SYMBOL の前に符号文字列を置く場合、1 を返す
  • 量および CURRENCY_SYMBOL の後に符号文字列を置く場合、2 を返す
  • CURRENCY_SYMBOL の直前に符号文字列を置く場合、3 を返す
  • CURRENCY_SYMBOL の直後に符号文字列を置く場合、4 を返す
N_SIGN_POSN
LC_NUMERIC カテゴリの定数
DECIMAL_POINT 小数点文字
RADIXCHAR DECIMAL_POINT と同じ値
THOUSANDS_SEP 1000 単位桁区切り (3 桁ごとのグループ化) の区切り文字
THOUSEP THOUSANDS_SEP と同じ値
GROUPING  
LC_MESSAGES カテゴリの定数
YESEXPR "はい" の入力にマッチさせるための正規表現
NOEXPR "いいえ" の入力にマッチさせるための正規表現
YESSTR "はい" のための出力文字列
NOSTR "いいえ" のための出力文字列
LC_CTYPE カテゴリの定数
CODESET 文字エンコーディング名の文字列を返す

返値

要素を文字列で返します。item が有効でない場合は FALSE を返します。

注意

注意: この関数は Windows 環境にはまだ実装されていません。

参考

  • setlocale() - ロケール情報を設定する
  • localeconv() - 数値に関するフォーマット情報を得る
  • ワード検索


    ※入力キーワードが、関数名・説明文・タグに含まれるものを検索

    関数名アルファベット別

    A B C D E F G H I J
    K L M N O P Q R S T
    U V W X Y Z _

    最終更新一覧

    stristr
     大文字小文字を区別せず文字列を検索し、ヒット箇所以降(あるいは以前)の文字列を返却

    stripslashes
     バックスラッシュでエスケープされた文字列から、バックスラッシュを取り除く

    stripos
     大文字小文字を区別せずに文字列が最初に現れる位置を取得する

    stripcslashes
     addcslashes() でクォートされた文字列をアンクォートする

    strip_tags
     文字列から HTML と PHP のタグを除去して返却

    strcspn
     指定した文字が最初に現れる位置を調べる

    strcoll
     ロケールに基づいて2つの文字列を比較し同じか(あるいは大小)を判定する

    strcmp
     2つの文字列を比較し同じか(あるいは大小)を判定する

    strchr
     strstr() のエイリアス

    strcasecmp
     2つの文字列を比較(大文字小文字を区別せず同じとみなす)

    カテゴリー一覧

    PHP の振る舞いの変更
    音声フォーマットの操作
    認証サービス
    コマンドライン関連
    圧縮およびアーカイブ
    暗号
    データベース関連
    日付および時刻関連
    ファイルシステム
    自然言語および文字エンコーディング
    画像処理および作成
    メール関連
    数学
    テキスト以外の MIME 型
    プロセス制御
    その他の基本モジュール
    その他のサービス
    検索エンジン用の拡張モジュール
    サーバー固有のモジュール
    セッション関連
    テキスト処理
    変数・データ型関連
    ウェブサービス
    Windows 用のモジュール
    XML 操作
    GUI用の拡張モジュール