35406 skanuj0170 (13)

Rozdział 6. ♦ Ciągi znaków, data i czas 181

Funkcja strftime

Funkcja strftime zwraca ciąg znaków sformatowany zgodnie z szablonem przekazanym w postaci argumentu. Jej wywołanie ma postać: strftime!formatl. timestamp])

Argument format to ciąg znaków, który może zawierać znaczniki przedstawione w tabeli 6.4. Jeżeli zostanie podany parametr timestamp, zostanie zwrócona odpowiadająca mu data, jeśli parametr ten zostanie pominięty, zostanie użyty bieżący czas lokalny. Nazwy miesięcy oraz dni tygodnia, a także inne parametry związane z ustawieniami lokalnymi, będą zgodne z danymi lokalizacyjnymi ustawionymi za pomocą funkcji setlocalę. Działanie strftime jest zależne od systemu operacyjnego, na którym działa PHP. Niektóre znaczniki mogą w związku tym być niedostępne. Przykładowe wywołania funkcji strftime zostały przedstawione w skrypcie widocznym na listingu 6.17. Efekt jego działania jest natomiast widoczny na rysunku 6.13.

Tabela 6.4. Znaczniki formatujące dla funkcji strftime

Znacznik	Znaczenie	Przykłady
Sa	Nazwa dnia tygodnia w postaci skróconej.	Pn, Wt, Śr
SA	Pełna nazwa dnia tygodnia.	poniedziałek, wtorek
Sb	Nazwa miesiąca w postaci skróconej.	sty, lut, mar
SB	Pełna nazwa miesiąca.	styczeń, luty, marzec
Sc	Data i czas w formacie bieżącej lokalizacji.	2008-02-17 18:35:46
SC	Określenie wieku, rok podzielony przez sto i zaokrąglony do liczby całkowitej z zakresu od 00 do 99.	20,21
Sd	Dzień miesiąca w postaci numerycznej.	od 01 do 31
SD	Znaczenie identyczne z Sm/Sd/Sy.	02/17/08
Se	Dzień miesiąca w postaci numerycznej, liczby jednocyfrowe poprzedzane są spacją.	od 1 do 31
*9	Znaczenie takie jak SG, bez uwzględnienia wieku.
SG	Czterocyfrowy rok powiązany z numerem tygodnia według standardu ISO.
Sh	Znaczenie takie samo jak Sb.	sty, lut, mar
SH	Godzina w formacie 24-godzinnym.	od 01 do 24
v SI	Godzina w formacie 12-godzinnym.	od 01 do 12
Sj	Numer dnia w roku,	od 001 do 366
ji Sm	Miesiąc w postaci numerycznej.	od 01 do 31
SM	Bieżąca liczba minut.	od 01 do 59
Sn	Znacznik nowej linii.
»P	Znacznik przed południem — po południu.	am, pm