(PHP 5 >= 5.5.0, PHP 7, PHP 8, PECL intl >= 3.0.0)
IntlDateFormatter::formatObject -- datefmt_format_object — Formate un objet
Style orienté objet
$datetime
, array|int|string|null$format
= null
, ?string$locale
= null
): string|falseStyle procédural
$datetime
, array|int|string|null$format
= null
, ?string$locale
= null
): string|falseCette fonction permet le formatage d'un objet IntlCalendar ou d'un objet DateTime sans avoir créé auparavant un objet IntlDateFormatter.
L'objet IntlDateFormatter temporaire créé prendra le décalage horaire depuis l'objet passé. La base de données des décalages horaires interne à PHP ne sera pas utilisée - ICU sera utilisé à la place. L'identifiant de décalage horaire utilisé dans les objets DateTime doit toutefois exister également dans la base de données ICU.
datetime
Un objet de type IntlCalendar ou de type DateTime. L'information de décalage horaire dans l'objet sera utilisée.
format
Format de la date/heure. Peut-être soit un tableau avec deux éléments (d'abord le style de la date, puis, le style de l'heure, en utilisant une des constantes suivantes : IntlDateFormatter::NONE
, IntlDateFormatter::SHORT
, IntlDateFormatter::MEDIUM
, IntlDateFormatter::LONG
, IntlDateFormatter::FULL
), soit un type int avec la valeur de l'une de ces constantes (auquel cas, il sera utilisé à la fois pour la date et l'heure), ou un type string avec le format décrit dans la » documentation ICU. Si null
est fourni, le style par défaut sera utilisé.
locale
La locale à utiliser, ou null
pour utiliser la locale par défaut.
Une chaîne de caractères contenant le résultat ou false
si une erreur survient.
Exemple #1 Exemple avec IntlDateFormatter::formatObject()
<?php
ini_set('date.timezone', 'UTC');
ini_set('intl.default_locale', 'fr_FR');
$cal = IntlCalendar::fromDateTime("2013-06-06 17:05:06 Europe/Dublin");
echo "défault :\n\t",
IntlDateFormatter::formatObject($cal),
"\n";
echo "long \$format (complet) :\n\t",
IntlDateFormatter::formatObject($cal, IntlDateFormatter::FULL),
"\n";
echo "array \$format (aucun, complet) :\n\t",
IntlDateFormatter::formatObject($cal, array(
IntlDateFormatter::NONE,
IntlDateFormatter::FULL)),
"\n";
echo "string \$format (d 'de' MMMM y):\n\t",
IntlDateFormatter::formatObject($cal, "d 'de' MMMM y", 'en_US'),
"\n";
echo "avec DateTime :\n\t",
IntlDateFormatter::formatObject(
new DateTime("2013-09-09 09:09:09 Europe/Madrid"),
IntlDateFormatter::FULL,
'es_ES'),
"\n";
L'exemple ci-dessus va afficher :
défault : 6 juin 2013 17:05:06 long $format (complet): jeudi 6 juin 2013 17:05:06 heure d’été irlandaise array $format (aucun, complet): 17:05:06 heure d’été irlandaise string $format (d 'de' MMMM y): 6 de June 2013 avec DateTime : lunes, 9 de septiembre de 2013 09:09:09 Hora de verano de Europa central