strftime

Manuál PHP
Předcházející		Další

Popis

string strftime ( string format [, int timestamp])

Vrací řetězec formátovaný podle daného formátovacího řetězce, s použitím daného časového razítka timestamp, nebo aktuálního místního času, není-li razítko dáno. Název měsíce, dne v týdnu a další jazykově závislé řetězce respektují národní specifika nastavená pomocí setlocale().

Ve formátovacím řetězci se rozlišují tyto konverzní specifikátory:

%a - zkrácený název dne v týdnu (podle národního nastavení)
%A - úplný název dne v týdnu (podle národního nastavení)
%b - zkrácený název měsíce (podle národního nastavení)
%B - úplný název měsíce (podle národního nastavení)
%c - reprezentace času a data preferovaná aktuálním národním nastavením
%C - číslo století (rok dělený 100 a zkrácený na celé číslo, od 00 do 99)
%d - den v měsíci jako desítkové číslo (01 až 31)
%D - totéž jako %m/%d/%y
%e - den v měsíci jako desítkové číslo, jedné samotné číslici (čísla 1 až 9) předchází mezera (' 1' až '31')
%g - jako %G, ale bez století
%G - čtyřčíslicově reprezentovaný rok odpovídající týdnu podle ISO (viz %V). Má tentýž formát a hodnotu jako %Y, kromě toho, že pokud číslo týdne podle ISO patří předchozímu nebo následujícímu roku, bude tento odlišný rok použit.
%h - totéž jako %b
%H - hodina jako desítkové číslo ve 24-hodinovém formátu (00 až 23)
%I - hodina jako desítkové číslo ve 12-hodinovém formátu (01 až 12)
%j - den v roce jako desítkové číslo (001 až 366)
%m - měsíc jako desítkové číslo (01 až 12)
%M - minuta jako desítkové číslo
%n - znak odřádkování
%p - `am' nebo `pm' v závislosti na hodnotě času, resp. odpovídající řetězec podle národního nastavení
%r - čas v notaci a.m. a p.m. (12-hodinové)
%R - čas ve 24-hodinové notaci
%S - sekunda jako desítkové číslo
%t - znak tabulátoru
%T - aktuální čas, totéž jako %H:%M:%S

%u - den v týdnu jako desítkové číslo [1,7], 1 reprezentuje pondělí

Varování

Na počítačích Sun Solaris se vyskytuje neděle jako první den v týdnu, přestože ISO 9889:1999 (aktuální C standard) jasně specifikuje, že by to mělo být pondělí.

%U - týden v aktuálním roce jako desítkové číslo, počínaje první nedělí jako prvním dnem prvního týdne
%V - týden v aktuálním roce podle ISO 8601:1988 jako desítkové číslo, v rozsahu od 01 do 53, kde 1 je první týden s alespoň 4 dny v tomto roce, a s pondělkem jako prvním dnem v týdnu. (Odpovídající rok lze získat pomocí %G nebo %g.)
%W - týden v aktuálním roce jako desítkové číslo, počínaje prvním pondělkem jako prvním dnem prvního týdne
%w - den v týdnu jako desítkové číslo, neděle odpovídá 0
%x - preferovaná reprezentace data (bez času) pro aktuální národní nastavení
%X - preferovaná reprezentace času (bez data) pro aktuální národní nastavení
%y - rok jako desítkové číslo bez století (00 až 99)
%Y - rok jako desítkové číslo včetně století
%Z - časová zóna, její název nebo zkratka
%% - znak `%' (procento)

Poznámka: Všechny konverzní specifikátory nemusí být podporovány vaší C knihovnou, potom nebudou podporovány ani funkcí strftime() v PHP. To znamená, že %T a %D nebudou fungovat na Windows.

Příklad 1. Příklad - strftime()

setlocale (LC_TIME, "C");
print (strftime ("%A je ve finštině "));
setlocale (LC_TIME, "fi_FI");
print (strftime ("%A, ve francouzštině "));
setlocale (LC_TIME, "fr_FR");
print (strftime ("%A a v němčině "));
setlocale (LC_TIME, "de_DE");
print (strftime ("%A.\n"));

Tento příklad bude fungovat jen tehdy, máte-li daná národní specifika nainstalována v systému.

Viz také setlocale() a mktime(), a specifikaci Open Group strftime().