Manual:wfTimestamp/cs
Přehled
[edit ]wfTimestamp() (součást GlobalFunctions.php) poskytuje funkce pro převod mezi běžnými formáty časových razítek, včetně MediaWiki timestamps, UNIX timestamps, formátu MySQL DATETIME , [formátu http://www.faqs.org/rfcs/rfc2822.html RFC 2822] a dalších.
Úplný seznam naleznete níže ve formátech.
Časová razítka budou vypsána bez časového pásma nebo v časovém pásmu GMT, jak je určeno v daném formátu.
Při vkládání časového razítka do databáze nikdy nepoužívejte wfTimestamp(). Toto se přeruší v Postgresu a možná i v dalších databázích jiných než MySQL. Místo toho použijte $dbw->timestamp()
Použití
[edit ]wfTimestamp( $output_format, $timestamp )
- Vrátí časové razítko typu řetězec ve formátu určeném argumentem
$output_format. - Vyvolá hodnotu
MWException, pokud jsou pomocí argumentu$output_formatpředány nesprávné formáty. - Vrátí hodnotu
false, pokud je prostřednictvím argumentu$timestamppředáno neplatné nebo nerozpoznané časové razítko.
| Argument | Výchozí | Poznámky |
|---|---|---|
$output_format
|
TS_UNIX
|
Musí to být jedna z konstant uvedených v tabulce formats. |
$timestamp
|
Aktuální čas | Mělo by se jednat o doslovné časové razítko (např. 2010年12月03日 22:07:25). Lze použít libovolný formát uvedený v tabulce formátů.
|
- Volání bez argumentů pro vrácení aktuálního času ve formátu času UNIX.
echo wfTimestamp(); // 1759756575
- Volání s jedním argumentem vrátí aktuální čas v zadaném formátu.
echo wfTimestamp( TS_ISO_8601 ); // 2025年10月06日T13:16:15Z
- Volání se dvěma argumenty vrátí libovolné časové razítko v zadaném formátu.
Všimněte si, že časové razítko může být v libovolném formátu, který wfTimestamp() dokáže vypsat.
$timestamp = 20251015131615;
echo wfTimestamp( TS_ISO_8601, $timestamp ); // 2025年10月06日T13:16:15Z
$timestamp = '2025-10-06T13:16:15Z';
echo wfTimestamp( TS_RFC2822, $timestamp ); // 2025年10月06日 13:16:15 GMT
Formáty
[edit ]| Typ | Konstanta | Formát[1] | Příklad | Poznámky |
|---|---|---|---|---|
MySQL DATETIME |
TS_DB |
Y-m-d H:i:s |
2025年10月06日 13:16:15 | |
| DB2 | TS_DB2 |
Y-m-d H:i:s |
2025年10月06日 13:16:15 | Odstraněno od gerrit:50764
Verze MediaWiki:
1.15 – 1.20
|
| Exif | TS_EXIF |
Y:m:d H:i:s |
.&checktime(2025,10,06,':') 13:16:15 | Nemělo by se nikdy používat, ale je uvedeno pro úplnost. [2] |
| ISO 8601 (bez časového pásma) | TS_ISO_8601 |
Y-m-d\TH:i:s\Z |
2025年10月06日T13:16:15Z | Používáno rozhraním Special:Export a rozhraním API |
| ISO 8601 základní (bez časového pásma) | TS_ISO_8601_BASIC |
Ymd\THis\Z |
20251006T131615Z | Používá ResourceLoader |
| MediaWiki | TS_MW |
YmdHis |
20251006131615 | |
| Oracle | TS_ORACLE |
d-m-Y H:i:s.000000 |
06-10-2025 13:16:15.000000 | Před phab:rSVN51500 to bylo 'd-M-y h.i.s A' . ' +00:00' |
| PostgreSQL | TS_POSTGRES |
Y-m-d H:i:s+00 |
2025年10月06日 13:16:15+00 | Před gerrit:459601 to bylo 'Y-m-d H:i:s' . ' GMT' |
| RFC 2822 | TS_RFC2822 |
D, d M Y H:i:s |
2025年10月06日 13:16:15 GMT | Pro e-maily a HTTP záhlaví |
| Čas UNIX | TS_UNIX |
U |
1759756575 | Počet sekund od 1970年01月01日 00:00:00 UTC |
- ↑ Formátování kódů pomocí funkce
date()v PHP. - ↑ Zdokumentováno na straně 28 (pro tag DateTime) a straně 36 (pro tagy DateTimeOriginal a DateTimeDigitized) specifikace Exif 2.2. Stáhněte si specifikaci http://exif.org/Exif2-2.PDF
Související odkazy
[edit ]- wfTimestamp() - zdrojová dokumentace