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 }

Voir aussi

• » ICU Date formatter

• » ICU Date formats

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

• IntlDateFormatter::create — Crée un formateur de date
• IntlDateFormatter::format — Formate la date et l'heure sous forme de chaîne
• IntlDateFormatter::formatObject — Formate un objet
• IntlDateFormatter::getCalendar — Lit le calendrier utilisé par l'objet IntlDateFormatter
• IntlDateFormatter::getDateType — Lit le type de date utilisé par IntlDateFormatter
• IntlDateFormatter::getErrorCode — Lit le code d'erreur de la dernière opération
• IntlDateFormatter::getErrorMessage — Lit le dernier message d'erreur
• IntlDateFormatter::getLocale — Lit la locale utilisée par le formateur
• IntlDateFormatter::getPattern — Lit le modèle utilisé par IntlDateFormatter
• IntlDateFormatter::getTimeType — Lit le type de temps pour IntlDateFormatter
• IntlDateFormatter::getTimeZoneId — Lit le fuseau horaire de IntlDateFormatter
• IntlDateFormatter::getCalendarObject — Récupère une copie de l'objet formateur du calendrier
• IntlDateFormatter::getTimeZone — Récupère le formateur du décalage horaire
• IntlDateFormatter::isLenient — Retourne la sévérité utilisée pour IntlDateFormatter
• IntlDateFormatter::localtime — Analyse une chaîne et la convertie en temps
• IntlDateFormatter::parse — Analyse une chaîne vers un timestamp
• IntlDateFormatter::setCalendar — Définit le type de calendrier utilisé par le formateur
• IntlDateFormatter::setLenient — Configure la souplesse de l'analyseur
• IntlDateFormatter::setPattern — Configure le modèle utilisé par le IntlDateFormatter
• IntlDateFormatter::setTimeZone — Définit le formateur pour le décalage horaire