La classe IntlDateFormatter

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

Introduction

La classe IntlDateFormatter 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 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

}

Historique

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

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 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

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 convertit en temps
IntlDateFormatter::parse — Analyse une chaîne vers un timestamp
IntlDateFormatter::parseToCalendar — Analyse une chaîne en timestamp, en mettant à jour un calendrier ouvert
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

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

+add a note

User Contributed Notes 1 note

down

pluk77 at gmail dot com ¶

1 month 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

+add a note