Manual:wfTimestamp/fr

Résumé

wfTimestamp() (qui fait partie de GlobalFunctions.php) fournit la fonction de conversion des formats communs des dates comprenant les dates MediaWiki, les dates UNIX, le format DATETIME de MySQL, le format de la RFC 2822 et autres. Voir le tableau des formats ci-dessous pour la liste complète.

Les dates seront générées sans mentionner le fuseau horaire ou bien dans le fuseau GMT, selon le format particulier choisi.

N'utilisez jamais wfTimestamp() lorsque vous introduisez une date dans la base de données. Cela perturbe Postgres et éventuellement les bases de données qui ne sont pas MySQL. A la place, utilisez $dbw->timestamp()

Utilisation

wfTimestamp( $output_format, $timestamp )

• Renvoie une date de type chaîne de caractères (string) dans le format spécifié par l'argument $output_format.
• Lève MWException si une valeur incorrecte de formats est passée dans l'argument $output_format.
• Renvoie false si une date non valide ou non reconnue est passée dans l'arguement $timestamp.

Argument	Valeur par défaut	Notes
$output_format	TS_UNIX	Une des constantes listées dans la table formats.
$timestamp	heure actuelle	Doit être une date littérale (par exemple 2010-12-03 22:07:25). Tout format du tableau formats peut être utilisé.

Un appel sans argument renvoie l'heure actuelle au format des dates UNIX.

echo wfTimestamp(); // 1729825983

L'appel avec un argument renvoie l'heure actuelle dans le format demandé.

echo wfTimestamp( TS_ISO_8601 ); // 2024-10-25T03:13:03Z

L'appel avec deux arguments renvoie une date arbitraire dans le format demandé.

Notez-bien que la date peut être dans tout format que wfTimestamp() est capable de générer.

$timestamp = 20241003031303; echo wfTimestamp( TS_ISO_8601, $timestamp ); // 2024-10-25T03:13:03Z $timestamp = '2024-10-25T03:13:03Z'; echo wfTimestamp( TS_RFC2822, $timestamp ); // Fri, 25 Oct 2024 03:13:03 GMT

Formats

Type	Constante	Format	Exemple	Notes
MySQL DATETIME	TS_DB	Y-m-d H:i:s	2024-10-25 03:13:03
DB2	TS_DB2	Y-m-d H:i:s	2024-10-25 03:13:03	Supprimé en gerrit:50764 Versions de MediaWiki : 1.15 – 1.20
Exif	TS_EXIF	Y:m:d H:i:s	2024:10:25 03:13:03	Ne doit jamais être utilisé mais présent ici pour la compatibilité.
ISO 8601 (sans fuseau horaire)	TS_ISO_8601	Y-m-d\TH:i:s\Z	2024-10-25T03:13:03Z	Utilisé par Special:Export et par l'API
ISO 8601 de base (sans fuseau horaire)	TS_ISO_8601_BASIC	Ymd\THis\Z	20241025T031303Z	Utilisé par ResourceLoader
MediaWiki	TS_MW	YmdHis	20241025031303
Oracle	TS_ORACLE	d-m-Y H:i:s.000000	25-10-2024 03:13:03.000000	Valait 'd-M-y h.i.s A' . ' +00:00' avant la phab:rSVN51500
PostgreSQL	TS_POSTGRES	Y-m-d H:i:s+00	2024-10-25 03:13:03+00	Valait 'Y-m-d H:i:s' . ' GMT' avant la gerrit:459601
RFC 2822	TS_RFC2822	D, d M Y H:i:s	Fri, 25 Oct 2024 03:13:03 GMT	Pour les courriels et les entêtes HTTP
UNIX time	TS_UNIX	U	1729825983	Nombre de secondes depuis 1970-01-01 00:00:00 UTC.

Voir aussi

• documents source pour wfTimestamp()