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 GREGORIAN;
public const int TRADITIONAL;
/* Méthodes */
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
}

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
N'inclut pas cet élément
IntlDateFormatter::FULL
Style complètement spécifié (Tuesday, April 12, 1952 AD or 3:30:42pm PST)
IntlDateFormatter::LONG
Style long(January 12, 1952 or 3:30:32pm)
IntlDateFormatter::MEDIUM
Style intermédiaire (Jan 12, 1952)
IntlDateFormatter::SHORT
Style abrégé, uniquement les informations essentielles (12/13/52 ou 3:30pm)
IntlDateFormatter::RELATIVE_FULL
Identique à IntlDateFormatter::FULL, mais hier, aujourd'hui, et demain sont afficher comme yesterday, today, et tomorrow, respectivement. Disponible à partir de PHP 8.0.0, pour dateType uniquement.
IntlDateFormatter::RELATIVE_LONG
Identique à IntlDateFormatter::LONG, mais hier, aujourd'hui, et demain sont afficher comme yesterday, today, et tomorrow, respectivement. Disponible à partir de PHP 8.0.0, pour dateType uniquement.
IntlDateFormatter::RELATIVE_MEDIUM
Identique à IntlDateFormatter::MEDIUM, mais hier, aujourd'hui, et demain sont afficher comme yesterday, today, et tomorrow, respectivement. Disponible à partir de PHP 8.0.0, pour dateType uniquement.
IntlDateFormatter::RELATIVE_SHORT
Identique à IntlDateFormatter::SHORT, mais hier, aujourd'hui, et demain sont afficher comme yesterday, today, et tomorrow, respectivement. Disponible à partir de PHP 8.0.0, pour dateType uniquement.

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
Calendrier non-grégorien
IntlDateFormatter::GREGORIAN
Calendrier grégorien

Sommaire