IntlDateFormatter 类

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

    介绍

    日期格式化器是一个具体类，它可以使用模式字符串和/或预定义模式来实现与区域设置相关的日期格式化/解析。

    此类表示 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 format(IntlCalendar|DateTimeInterface|array|string|int|float $datetime): string|false
    public static formatObject(IntlCalendar|DateTimeInterface $datetime, array|int|string|null $format = null, ?string $locale = null): string|false
    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
    }

    预定义常量

    这些常量用于在 DateType 和 TimeType 的构造函数中指定不同的格式。

    IntlDateFormatter::NONE
    不包含此元素
    IntlDateFormatter::FULL
    完全指定的样式（星期二，1952 年 4 月 12 日或下午 3:30:42 PST）
    IntlDateFormatter::LONG
    长样式（1952 年 1 月 12 日或下午 3:30:32）
    IntlDateFormatter::MEDIUM
    中等样式（1952 年 1 月 12 日）
    IntlDateFormatter::SHORT
    最简短的样式，只有必要的数据（12/13/52 或下午 3:30）
    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。

    以下 int 常量用于指定日历。 这些日历都直接基于公历。 非公历需要在语言环境中指定。 例如，locale="hi@calendar=BUDDHIST"。

    IntlDateFormatter::TRADITIONAL
    非公历
    IntlDateFormatter::GREGORIAN
    公历

    目录

    改进此页面

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

    用户贡献的注释

    此页面没有用户贡献的注释。
    To Top