PHPのお勉強！

PHP TOP
PHP 8.4.2 Released!

    Locale クラス

    (PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)

    はじめに

    "ロケール" とは、言語や文化等の地域固有の内容を API で取得する際に使用する識別子のことです。PHP で使用しているロケールは、 ICU (そして他の多くの Unix 系 OS や Mac、Java など) が採用している CLDR ロケールと同じです。 ロケールは、RFC 4646 形式の言語タグ (アンダースコアではなくハイフンを使用したもの) を使用します。古くから用いられているアンダースコア形式の識別子も使用できます。 特にことわりがない限り、このクラスの関数では両方の形式の識別子を使用可能です。

    識別子の例を以下にあげます。

    • en-US (英語、米国)
    • zh-Hant-TW (中国語、繁体字、台湾 )
    • fr-CA, fr-FR (それぞれ、カナダのフランス語とフランスのフランス語)

    Locale クラス (そしてそれに対応する手続き型の関数) を使用して、ロケール識別子に対する操作を行います。 たとえばその識別子が妥当な形式かどうかを調べたりします。 CLDR が UAX #35 で使用している (そして ICU も継承している) 拡張は、ICU で普通に用いることができます。

    Locale クラスのインスタンスを作成することはできません。 すべての関数/メソッドは :: を付けて呼び出します。

    null や空文字列は "root" ロケールとなります。 この "root" ロケールは、CLDR においては "en_US_POSIX" と同じ意味になります。言語タグ (そして ロケール識別子) は大文字小文字を区別しません。 仕様にあわせて大文字小文字の正規化を行う関数が存在します。

    クラス概要

    class Locale {
    /* 定数 */
    public const int ACTUAL_LOCALE;
    public const int VALID_LOCALE;
    public const null DEFAULT_LOCALE = null;
    public const string LANG_TAG;
    public const string EXTLANG_TAG;
    public const string SCRIPT_TAG;
    public const string REGION_TAG;
    public const string VARIANT_TAG;
    public const string GRANDFATHERED_LANG_TAG;
    public const string PRIVATE_TAG;
    /* メソッド */
    public static acceptFromHttp(string $header): string|false
    public static canonicalize(string $locale): ?string
    public static composeLocale(array $subtags): string|false
    public static filterMatches(string $languageTag, string $locale, bool $canonicalize = false): ?bool
    public static getAllVariants(string $locale): ?array
    public static getDefault(): string
    public static getDisplayLanguage(string $locale, ?string $displayLocale = null): string|false
    public static getDisplayName(string $locale, ?string $displayLocale = null): string|false
    public static getDisplayRegion(string $locale, ?string $displayLocale = null): string|false
    public static getDisplayScript(string $locale, ?string $displayLocale = null): string|false
    public static getDisplayVariant(string $locale, ?string $displayLocale = null): string|false
    public static getKeywords(string $locale): array|false|null
    public static getPrimaryLanguage(string $locale): ?string
    public static getRegion(string $locale): ?string
    public static getScript(string $locale): ?string
    public static lookup(
        array $languageTag,
        string $locale,
        bool $canonicalize = false,
        ?string $defaultLocale = null
    ): ?string
    public static parseLocale(string $locale): ?array
    public static setDefault(string $locale): bool
    }

    定義済み定数

    Locale::DEFAULT_LOCALE
    NumberFormatter のようなロケールの影響を受けるさまざまなクラスのメソッドの locale パラメータとして使用します。 この定数は、デフォルトのロケールをメソッドで使用するようにします。

    これらの定数は、さまざまなクラスの getLocale メソッドでロケールを選択するために使用します。

    Locale::ACTUAL_LOCALE
    これは、データが実際にやってくる元のロケールです。
    Locale::VALID_LOCALE
    これは、ICU がサポートする最も明確なロケールです。

    ロケールのサブタグ

    これらの定数は、ロケールのパースや合成の方法を定義します。 locale_compose() の引数に渡す配列のキーとして使用し、 また locale_parse() が返す連想配列のキーとしても用いられます。

    Locale::LANG_TAG
    言語サブタグ
    Locale::EXTLANG_TAG
    拡張言語サブタグ
    Locale::SCRIPT_TAG
    文字サブタグ
    Locale::REGION_TAG
    地域サブタグ
    Locale::VARIANT_TAG
    変化形サブタグ
    Locale::GRANDFATHERED_LANG_TAG
    先祖言語 (Grandfathered Language) サブタグ
    Locale::PRIVATE_TAG
    プライベートサブタグ

    目次

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes

    There are no user contributed notes for this page.