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(); // 1723723827
- L'appel avec un argument renvoie l'heure actuelle dans le format demandé.
echo wfTimestamp( TS_ISO_8601 ); // 2024-08-15T12:10:27Z
- 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 = 20240827121027;
echo wfTimestamp( TS_ISO_8601, $timestamp ); // 2024-08-15T12:10:27Z
$timestamp = '2024-08-15T12:10:27Z';
echo wfTimestamp( TS_RFC2822, $timestamp ); // Thu, 15 Aug 2024 12:10:27 GMT
Formats
Type | Constante | Format[1] | Exemple | Notes | ||
---|---|---|---|---|---|---|
MySQL DATETIME |
TS_DB |
Y-m-d H:i:s |
2024-08-15 12:10:27 | |||
DB2 | TS_DB2 |
Y-m-d H:i:s |
2024-08-15 12:10:27 | Supprimé en gerrit:50764
| ||
Exif | TS_EXIF |
Y:m:d H:i:s |
2024:08:15 12:10:27 | 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-08-15T12:10:27Z | Utilisé par Special:Export et par l'API | ||
ISO 8601 de base (sans fuseau horaire) | TS_ISO_8601_BASIC |
Ymd\THis\Z |
20240815T121027Z | Utilisé par ResourceLoader | ||
MediaWiki | TS_MW |
YmdHis |
20240815121027 | |||
Oracle | TS_ORACLE |
d-m-Y H:i:s.000000 |
15-08-2024 12:10:27.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-08-15 12:10:27+00 | Valait 'Y-m-d H:i:s' . ' GMT' avant la gerrit:459601 | ||
RFC 2822 | TS_RFC2822 |
D, d M Y H:i:s |
Thu, 15 Aug 2024 12:10:27 GMT | Pour les courriels et les entêtes HTTP | ||
UNIX time | TS_UNIX |
U |
1723723827 | Nombre de secondes depuis 1970-01-01 00:00:00 UTC. |
- ↑ Codes des formats par fonction PHP
date()
. - ↑ 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