Edit Report a Bug

nl_langinfo

(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)

nl_langinfo — 言語およびロケール情報を検索する

説明

nl_langinfo(int $item): string|false

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 を返します。

例

例1 nl_langinfo() の例

<?php

var_dump(nl_langinfo(CODESET));
var_dump(nl_langinfo(YESEXPR));
?>

上の例の出力は、たとえば以下のようになります。

string(14) "ANSI_X3.4-1968"
string(5) "^[yY]"

注意

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

参考

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

add a note

User Contributed Notes 2 notes

down

mark at moderndeveloper dot com ¶

11 years ago


If you are looking for the stand-alone (nominative form) of a month, you may not be able to use nl_langinfo(), but with PHP 5.5 you can use something like:

<?php
echo IntlDateFormatter::formatObject(
         new DateTime('2013-01-01 00:00:00 Europe/Moscow'),
         'LLLL',
         'ru_RU');
?>

Note that the format uses the ICU patterns, not the PHP date() patterns.

down

avatar_at_hot_ee ¶

18 years ago


The value MON_(1-12) has special behavior in Russian locale: it returns declinated month names, that can be used as part of a date string, but not on their own.

For instance instead of "Январь" (the proper nominative form) it returns "Января" (form declinated for use in dates).

There seems to be no way to get the nominative form of the month name - one has to use translations instead.

add a note