La classe IntlDateFormatter

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

    Introduction

    La classe DateFormatter est une classe concrète, qui active l'analyse et le formatage de dates, basé sur des chaînes modèles, ou des règles.

    Cette classe représente les fonctionnalités de formatage des dates ICU. Elle permet aux utilisateurs d'afficher des dates dans un format localisé, ou d'analyser des chaînes PHP pour extraire des dates.

    Class synopsis

    class IntlDateFormatter {
    /* Constantes */
    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;
    /* Méthodes */
    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 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
    }

    Historique

    Version Description
    8.4.0 Ajout de la constante IntlDateFormatter::PATTERN.

    Constantes pré-définies

    Ces constantes sont utilisées pour spécifier différents formats dans le constructeur des classes DateType et TimeType.

    IntlDateFormatter::NONE int
    N'inclut pas cet élément
    IntlDateFormatter::FULL int
    Style complètement spécifié (Tuesday, April 12, 1952 AD or 3:30:42pm PST)
    IntlDateFormatter::LONG int
    Style long (January 12, 1952 or 3:30:32pm)
    IntlDateFormatter::MEDIUM int
    Style intermédiaire (Jan 12, 1952)
    IntlDateFormatter::SHORT int
    Style abrégé, uniquement les informations essentielles (12/13/52 ou 3:30pm)
    IntlDateFormatter::RELATIVE_FULL int
    Identique à IntlDateFormatter::FULL, mais hier, aujourd'hui, et demain sont affichés comme yesterday, today, et tomorrow, respectivement. Disponible à partir de PHP 8.0.0, pour dateType uniquement.
    IntlDateFormatter::RELATIVE_LONG int
    Identique à IntlDateFormatter::LONG, mais hier, aujourd'hui, et demain sont affichés comme yesterday, today, et tomorrow, respectivement. Disponible à partir de PHP 8.0.0, pour dateType uniquement.
    IntlDateFormatter::RELATIVE_MEDIUM int
    Identique à IntlDateFormatter::MEDIUM, mais hier, aujourd'hui, et demain sont affichés comme yesterday, today, et tomorrow, respectivement. Disponible à partir de PHP 8.0.0, pour dateType uniquement.
    IntlDateFormatter::RELATIVE_SHORT int
    Identique à IntlDateFormatter::SHORT, mais hier, aujourd'hui, et demain sont affichés comme yesterday, today, et tomorrow, respectivement. Disponible à partir de PHP 8.0.0, pour dateType uniquement.
    IntlDateFormatter::PATTERN int
    Utilise le modèle donné dans pattern. Disponible à partir de PHP 8.4.0.

    Les constantes entières suivantes sont utilisées pour spécifier des calendriers. Ces calendriers sont basés directement sur le calendrier grégorien. Les calendriers non-grégoriens doivent être spécifiés dans une locale. Les exemples peuvent inclure locale="hi@calendar=BUDDHIST".

    IntlDateFormatter::TRADITIONAL int
    Calendrier non-grégorien
    IntlDateFormatter::GREGORIAN int
    Calendrier grégorien

    Historique

    Version Description
    8.4.0 Les constantes de classe sont désormais typées.

    Sommaire

    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.
    To Top