Manual:wfTimestamp/de
Überblick
wfTimestamp()
(part of GlobalFunctions.php) provides functionality to convert between common timestamp formats, including MediaWiki timestamps, UNIX timestamps, MySQL DATETIME
format, RFC 2822 format and more.
See formats below for a full list.
Timestamps will be output without a timezone or in the GMT timezone, as specified by the particular format.
Never use wfTimestamp() when inserting a timestamp into the database. This will break in Postgres and possibly other non-MySQL databases. Verwende stattdessen $dbw->timestamp()
Verwendung
wfTimestamp( $output_format, $timestamp )
- Returns a timestamp of type string in the format specified by the
$output_format
argument. - Throws
MWException
if an incorrect formats is passed via the$output_format
argument. - Returns
false
if an invalid or unrecognized timestamp is passed via the$timestamp
argument.
Argument | Default | Anmerkungen |
---|---|---|
$output_format
|
TS_UNIX
|
Must be one of the constants listed in the formats table. |
$timestamp
|
Die aktuelle Zeit | Should be a literal timestamp (e.g. 2010-12-03 22:07:25 ). Any format listed in the formats table can be used.
|
- Call with no arguments to return the current time in UNIX time format.
echo wfTimestamp(); // 1733196797
- Call with one argument to return the current time in the specified format.
echo wfTimestamp( TS_ISO_8601 ); // 2024-12-03T03:33:17Z
- Call with two arguments to return an arbitrary timestamp in the specified format.
Note that the timestamp can be in any format that wfTimestamp()
can output.
$timestamp = 20241217033317;
echo wfTimestamp( TS_ISO_8601, $timestamp ); // 2024-12-03T03:33:17Z
$timestamp = '2024-12-03T03:33:17Z';
echo wfTimestamp( TS_RFC2822, $timestamp ); // Tue, 03 Dec 2024 03:33:17 GMT
Formate
Typ | Constant | Format[1] | Beispiel | Anmerkungen | ||
---|---|---|---|---|---|---|
MySQL DATETIME |
TS_DB |
Y-m-d H:i:s |
2024-12-03 03:33:17 | |||
DB2 | TS_DB2 |
Y-m-d H:i:s |
2024-12-03 03:33:17 | Entfernt in gerrit:50764
| ||
Exif | TS_EXIF |
Y:m:d H:i:s |
2024:12:03 03:33:17 | Sollte nie verwendet werden, aber ist der Vollständigkeit halber enthalten. [2] | ||
ISO 8601 (keine Zeitzone) | TS_ISO_8601 |
Y-m-d\TH:i:s\Z |
2024-12-03T03:33:17Z | Verwendet von Special:Export und der API | ||
ISO 8601 basic (no timezone) | TS_ISO_8601_BASIC |
Ymd\THis\Z |
20241203T033317Z | Verwendet von ResourceLoader | ||
MediaWiki | TS_MW |
YmdHis |
20241203033317 | |||
Oracle | TS_ORACLE |
d-m-Y H:i:s.000000 |
03-12-2024 03:33:17.000000 | War 'd-M-y h.i.s A' . ' +00:00' vor phab:rSVN51500 | ||
PostgreSQL | TS_POSTGRES |
Y-m-d H:i:s+00 |
2024-12-03 03:33:17+00 | War 'Y-m-d H:i:s' . ' GMT' vor gerrit:459601 | ||
RFC 2822 | TS_RFC2822 |
D, d M Y H:i:s |
Tue, 03 Dec 2024 03:33:17 GMT | For email and HTTP headers | ||
UNIX time | TS_UNIX |
U |
1733196797 | Nummer an Sekunden seit 1970-01-01 00:00:00 UTC |
- ↑ Formatting codes per PHP's
date()
function. - ↑ Dokumentiert auf Seite 28 (Für den DateTime-Tag) und Seite 36 (für die DateTimeOriginal- und DateTimeDigitized-Tags) der Exif 2.2-Spezifikation. Lade die Spezifikation unter http://exif.org/Exif2-2.PDF herunter