Manual:wfTimestamp/fr

This page is a translated version of the page Manual:WfTimestamp and the translation is 100% complete.

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[1] 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é. [2]
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.
  1. Codes des formats par fonction PHP date().
  2. Documenté en page 28 (pour la balise DateTime) et page 36 (pour les balises DateTimeOriginal et DateTimeDigitized) de la spécification Exif 2.2 . Télécharger les spécifications à partir de http://exif.org/Exif2-2.PDF

Voir aussi