Blok funkce DT2STR
Blok funkce DT2STR převádí čas s uvedeným formátem na řetězec.
Vstup DT
Vstup definuje datum v DT#, které se používá k výpočtu. Pokud není zadáno žádné datum, tak se vypočítává s časovým razítkem 0.
Vstup FORMAT
Vstupem je definován formát jako řetězec. Pokud není zadána žádná hodnota nebo je ponechán prázdný, tak se předpokládá řetězec "Y-m-d H:i:s".
Tip: Aby bylo možné vypsat písmeno nebo d, musí být každé písmeno označené escape znakem \. Například: "\d\a\y: d" vypíše "day: 01".
| Formátovací znaky | Popis | Příklad návratových hodnot |
|---|---|---|
| Den | ||
| d | Den v měsíci, 2-místný s předcházející nulou | 01 až 31 |
| D | Den v týdnu, zkrácený na tři písmena | Mon až Sun |
| j | Den v měsíci bez předcházejících nul | 1 až 31 |
| l (malé 'L') | Výpis dne v týdnu | Sunday až Saturday |
| N | Numerická reprezentace dne v týdnu podle ISO-8601 | 1 (pro pondělí) až 7 (pro neděli) |
| S | Přípona anglického seznamu pro den v měsíci, dva znaky | st, nd, rd nebo th. Doporučeno k použití s j. |
| w | Numerický den v týdnu | 0 (pro neděli) až 6 (pro sobotu) |
| z | Den v roce (začínající od 0) | 0 až 365 |
| Týden | ||
| W | Číslo týdne v roce podle ISO-8601, týden začíná v pondělí | Příklad: 42 (42. týden v roce) |
| Měsíc | ||
| F | Měsíc jako celé slovo, jako January nebo March | January až December |
| m | Měsíc jako číslo, s předcházejícími nulami | 01 až 12 |
| M | Název měsíce se třemi písmeny | Jan až Dec |
| n | Číslo měsíce, bez předcházejících nul | 1 až 12 |
| t | Počet dnů v daném měsíci | 28 až 31 |
| Rok | ||
| L | Přestupný rok nebo ne | 1 pro přestupný rok, jinak 0 |
| o | Rok kalendářního týdne podle ISO-8601. To dává stejnou hodnotu jako Y, pokud nepatří ISO-kalendářní týden (W) k předchozímu nebo následujícímu roku, pak se použije ten rok. | Příklady: 1999 nebo 2003 |
| Y | Čtyřmístný rok | Příklady: 1999 nebo 2003 |
| y | Rok, dvoumístný | Příklady: 99 nebo 03 |
| Čas | ||
| a | Malé písmeno: Ante meridiem (před polednem) a Post meridiem (po poledni) | am nebo pm |
| A | Velké písmeno: Ante meridiem (před polednem) a Post meridiem (po poledni) | AM nebo PM |
| B | Swatch internetový čas | 000 až 999 |
| g | Hodina v 12hodinovém formátu, bez předcházejících nul | 1 až 12 |
| G | Hodina v 24hodinovém formátu, bez předcházejících nul | 0 až 23 |
| h | Hodina v 12hodinovém formátu, s předcházejícími nulami | 01 až 12 |
| H | Hodina v 24hodinovém formátu, s předcházejícími nulami | 00 až 23 |
| i | Minuty, s předcházejícími nulami | 00 až 59 |
| s | Sekundy, s předcházejícími nulami | 00 až 59 |
| u | Mikrosekundy. Vždy vytváří výstup 000000. | Příklad: 000000 |
| Časová zóna | ||
| e | Identifikátor časové zóny | Příklady: UTC, GMT, Atlantic/Azores |
| I (velké 'i') | Zda datum spadá do letního času | 1 při letním čase, jinak 0. |
| O | Rozdíl času od Greenwich time (GMT) v hodinách | Příklad: +0200 |
| P | Rozdíl času od Greenwich time (GMT) v hodinách s dvojtečkou mezi hodinami a minutami | Příklad: +02:00 |
| T | Zkratka časové zóny | Příklady: EST, MDT... |
| Z | Posun časové zóny v sekundách. Posun pro časová pásma západně od UTC je vždy záporný a pro časová pásma východně od UTC vždy kladný. | -43200 až 50400 |
| z | Vrací den v roce bez předcházející nuly | |
| Úplné datum/čas | ||
| c | ISO 8601 datum | 2004-02-12T15:19:21+00:00 |
| r | Podle » RFC 2822 formátované datum | Příklad: Thu, 21 Dec 2000 16:01:07 +0200 |
| U | Sekundy od začátku UNIX epochy (January 1 1970 00:00:00 GMT) | Viz také blok funkce TIME |
Výstup STR
Výstup vrací řetězec s uvedeným formátem.