PHP TOP

IntlDateFormatter::create »

« IntlTimeZone::useDaylightTime

IntlDateFormatter クラス

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

はじめに

Date Formatter は、パターン文字列や出来合いのパターンを使用してロケールに依存する日付のフォーマット/パースを行う具象クラスです。

このクラスは ICU の日付フォーマット機能を表します。これを使用すると、パターン文字列や出来合いのパターンを使用して日付を各地域のフォーマットで表示したり、文字列をパースして PHP の日付として扱ったりすることができます。

クラス概要

class IntlDateFormatter {

/* 定数 */

public const int FULL;

public const int LONG;

public const int MEDIUM;

public const int SHORT;

public const int NONE;

public const int RELATIVE_FULL;

public const int RELATIVE_LONG;

public const int RELATIVE_MEDIUM;

public const int RELATIVE_SHORT;

public const int GREGORIAN;

public const int TRADITIONAL;

/* メソッド */

public __construct(
    ?string $locale,
    int $dateType = IntlDateFormatter::FULL,
    int $timeType = IntlDateFormatter::FULL,
    IntlTimeZone|DateTimeZone|string|null $timezone = null,
    IntlCalendar|int|null $calendar = null,
    ?string $pattern = null
)

public static create(
    ?string $locale,
    int $dateType = IntlDateFormatter::FULL,
    int $timeType = IntlDateFormatter::FULL,
    IntlTimeZone|DateTimeZone|string|null $timezone = null,
    IntlCalendar|int|null $calendar = null,
    ?string $pattern = null
): ?IntlDateFormatter

public getCalendar(): int|false

public getDateType(): int|false

public getErrorCode(): int

public getErrorMessage(): string

public getLocale(int $type = ULOC_ACTUAL_LOCALE): string|false

public getPattern(): string|false

public getTimeType(): int|false

public getTimeZoneId(): string|false

public getCalendarObject(): IntlCalendar|false|null

public getTimeZone(): IntlTimeZone|false

public isLenient(): bool

public localtime(string $string, int &$offset = null): array|false

public parse(string $string, int &$offset = null): int|float|false

public setCalendar(IntlCalendar|int|null $calendar): bool

public setLenient(bool $lenient): void

public setPattern(string $pattern): bool

public setTimeZone(IntlTimeZone|DateTimeZone|string|null $timezone): bool

}

参考

» ICU Date formatter

» ICU Date formats

定義済み定数

これらの定数は、DateType や TimeType のコンストラクタでさまざまなフォーマットを指定するために使用します。

IntlDateFormatter::NONE: この要素を含まない
IntlDateFormatter::FULL: 完全に指定した形式 (Tuesday, April 12, 1952 AD あるいは 3:30:42pm PST)
IntlDateFormatter::LONG: 長い形式 (January 12, 1952 あるいは 3:30:32pm)
IntlDateFormatter::MEDIUM: 中間の形式 (Jan 12, 1952)
IntlDateFormatter::SHORT: 不可欠なデータのみを扱う最も省略した形式 (12/13/52 あるいは 3:30pm)
IntlDateFormatter::RELATIVE_FULL: IntlDateFormatter::FULL と同じですが、昨日、今日、明日についてはそれぞれ、 yesterday, today, tomorrow になります。 PHP 8.0.0 以降で、dateType に限って利用可能です。
IntlDateFormatter::RELATIVE_LONG: IntlDateFormatter::LONG と同じですが、昨日、今日、明日についてはそれぞれ、 yesterday, today, tomorrow になります。 PHP 8.0.0 以降で、dateType に限って利用可能です。
IntlDateFormatter::RELATIVE_MEDIUM: IntlDateFormatter::MEDIUM と同じですが、昨日、今日、明日についてはそれぞれ、 yesterday, today, tomorrow になります。 PHP 8.0.0 以降で、dateType に限って利用可能です。
IntlDateFormatter::RELATIVE_SHORT: IntlDateFormatter::SHORT と同じですが、昨日、今日、明日についてはそれぞれ、 yesterday, today, tomorrow になります。 PHP 8.0.0 以降で、dateType に限って利用可能です。

次の整数定数は、暦の種類を指定するものです。これらの暦は、すべてグレゴリオ暦にもとづくものです。グレゴリオ暦以外の暦はロケールで指定しなければなりません。たとえば、 locale="hi@calendar=BUDDHIST" のようになります。

IntlDateFormatter::TRADITIONAL: 非グレゴリオ暦
IntlDateFormatter::GREGORIAN: グレゴリオ暦

IntlDateFormatter::create — Date Formatter を作成する
IntlDateFormatter::format — 日付/時刻の値を文字列としてフォーマットする
IntlDateFormatter::formatObject — オブジェクトの書式を設定する
IntlDateFormatter::getCalendar — IntlDateFormatter が使用するカレンダー型を取得する
IntlDateFormatter::getDateType — IntlDateFormatter が使用する日付形式を取得する
IntlDateFormatter::getErrorCode — 直近の操作のエラーコードを取得する
IntlDateFormatter::getErrorMessage — 直近の操作のエラーテキストを取得する
IntlDateFormatter::getLocale — Formatter が使用するロケールを取得する
IntlDateFormatter::getPattern — IntlDateFormatter が使用するパターンを取得する
IntlDateFormatter::getTimeType — IntlDateFormatter が使用する時刻形式を取得する
IntlDateFormatter::getTimeZoneId — IntlDateFormatter が使用するタイムゾーン ID を取得する
IntlDateFormatter::getCalendarObject — カレンダーオブジェクトのコピーを取得する
IntlDateFormatter::getTimeZone — タイムゾーンを取得する
IntlDateFormatter::isLenient — IntlDateFormatter で使用する寛大さを取得する
IntlDateFormatter::localtime — 文字列をパースして、フィールドベースの時刻値にする
IntlDateFormatter::parse — 文字列をパースしてタイムスタンプにする
IntlDateFormatter::setCalendar — Formatter が使うカレンダー型を設定する
IntlDateFormatter::setLenient — パーサの寛大さを設定する
IntlDateFormatter::setPattern — IntlDateFormatter が使用するパターンを設定する
IntlDateFormatter::setTimeZone — タイムゾーンを設定する

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.

Atelier ”慶”

WEBクリエイター歴２０年、最先端技術と安心をお届けします。

PHPのお勉強！