PHP 8.4.24 Released!

    The IntlDateFormatter class

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

    简介

    Date Formatter is a concrete class that enables locale-dependent formatting/parsing of dates using pattern strings and/or canned patterns.

    This class represents the ICU date formatting functionality. It allows users to display dates in a localized format or to parse strings into PHP date values using pattern strings and/or canned patterns.

    Class synopsis

    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 PATTERN;
    public const int GREGORIAN;
    public const int TRADITIONAL;
    /* 方法 */
    public function __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 function 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 function format(IntlCalendar|DateTimeInterface|array|string|int|float $datetime): string|false
    public static function formatObject(IntlCalendar|DateTimeInterface $datetime, array|int|string|null $format = null, ?string $locale = null): string|false
    public function getCalendar(): int|false
    public function getDateType(): int|false
    public function getErrorCode(): int
    public function getErrorMessage(): string
    public function getLocale(int $type = ULOC_ACTUAL_LOCALE): string|false
    public function getPattern(): string|false
    public function getTimeType(): int|false
    public function getTimeZoneId(): string|false
    public function getCalendarObject(): IntlCalendar|false|null
    public function getTimeZone(): IntlTimeZone|false
    public function isLenient(): bool
    public function localtime(string $string, int &$offset = null): array|false
    public function parse(string $string, int &$offset = null): int|float|false
    public function parseToCalendar(string $string, int &$offset = null): int|float|false
    public function setCalendar(IntlCalendar|int|null $calendar): bool
    public function setLenient(bool $lenient): void
    public function setPattern(string $pattern): bool
    public function setTimeZone(IntlTimeZone|DateTimeZone|string|null $timezone): bool
    }

    更新日志

    版本 说明
    8.4.0 Added IntlDateFormatter::PATTERN.

    预定义常量

    These constants are used to specify different formats in the constructor for DateType and TimeType.

    IntlDateFormatter::NONE int
    Do not include this element
    IntlDateFormatter::FULL int
    Completely specified style (Tuesday, April 12, 1952 AD or 3:30:42pm PST)
    IntlDateFormatter::LONG int
    Long style (January 12, 1952 or 3:30:32pm)
    IntlDateFormatter::MEDIUM int
    Medium style (Jan 12, 1952)
    IntlDateFormatter::SHORT int
    Most abbreviated style, only essential data (12/13/52 or 3:30pm)
    IntlDateFormatter::RELATIVE_FULL int
    The same as IntlDateFormatter::FULL, but yesterday, today, and tomorrow show as yesterday, today, and tomorrow, respectively. Available as of PHP 8.0.0, for dateType only.
    IntlDateFormatter::RELATIVE_LONG int
    The same as IntlDateFormatter::LONG, but yesterday, today, and tomorrow show as yesterday, today, and tomorrow, respectively. Available as of PHP 8.0.0, for dateType only.
    IntlDateFormatter::RELATIVE_MEDIUM int
    The same as IntlDateFormatter::MEDIUM, but yesterday, today, and tomorrow show as yesterday, today, and tomorrow, respectively. Available as of PHP 8.0.0, for dateType only.
    IntlDateFormatter::RELATIVE_SHORT int
    The same as IntlDateFormatter::SHORT, but yesterday, today, and tomorrow show as yesterday, today, and tomorrow, respectively. Available as of PHP 8.0.0, for dateType only.
    IntlDateFormatter::PATTERN int
    Uses the pattern given in pattern. Available as of PHP 8.4.0.

    The following int constants are used to specify the calendar. These calendars are all based directly on the Gregorian calendar. Non-Gregorian calendars need to be specified in locale. Examples might include locale="hi@calendar=BUDDHIST".

    IntlDateFormatter::TRADITIONAL int
    Non-Gregorian Calendar
    IntlDateFormatter::GREGORIAN int
    Gregorian Calendar

    更新日志

    版本 说明
    8.4.0 The class constants are now typed.

    目录

    发现了问题？

    了解如何改进此页面 • 提交拉取请求 • 报告一个错误
    ＋添加备注

    用户贡献的备注 1 note

    up
    0
    pluk77 at gmail dot com
    10 hours ago
    The constructor performs Level 1 and Level 2 canonicalization according to ICU standards. See http://userguide.icu-project.org/locale#TOC-Canonicalization. 

This means all of these (and others) local format work:
'pt', 'pt-PT',  'pt-PT', 'pt_PT.utf8', 'pt_PT.utf8'

https://github.com/php/php-src/issues/11942
    ＋添加备注
    To Top