DateTimeInterface::format DateTimeImmutable::format DateTime::format date_format Zwraca datę sformatowaną według określonego formatu &reftitle.description; &style.oop; public stringDateTimeInterface::format stringformat public stringDateTimeImmutable::format stringformat public stringDateTime::format stringformat &style.procedural; stringdate_format DateTimeInterfaceobject stringformat Zwraca datę sformatowaną według określonego formatu. &reftitle.parameters; &date.datetime.description; format Format zwracanej daty string. Zobacz możliwe ustawienia formatowania poniżej. Istnieje także kilka predefiniowanych stałych daty, których można użyć w zamian, przykładowo DATE_RSS zawiera ciąg formatujący 'D, d M Y H:i:s'. Znak formatujący Opis Przykłady zwracanych wartości Dzień --- --- d Dzień miesiąca, 2 cyfry z wiodącymi zerami 01 do 31 D Tekstowy opis angielskiej nazwy dnia, trzy litery Mon kończąc na Sun j Dzień miesiąca bez zer wiodących 1 do 31 l (małe 'L') Pełen angielski opis dnia tygodnia Sunday aż do Saturday N Liczbowa forma dnia tygodnia, zgodna z normą ISO-8601 1 (dla poniedziałku) aż do 7 (dla niedzieli) S Angielski przyrostek porządkowy dla dnia miesiąca, 2 litery st, nd, rd lub th. Dobrze wygląda w połączeniu z j w Liczbowa forma dnia tygodnia 0 (dla niedzieli) aż go 6 (dla soboty) z Dzień roku (zaczynając od 0) 0 aż do 365 Tydzień --- --- W Numer tygodnia w roku, zgodny z normą ISO-8601, Tygodnie rozpoczynają się od poniedziałku Przykład: 42 (42. tydzień roku) Miesiąc --- --- F Pełen angielski opis, dnia miesiąca, taki jak January czy March January aż do December m Liczbowa forma miesiąca, z zerami wiodącymi 01 aż do 12 M Krótki, angielski opis miesiąca, trzy litery Jan aż do Dec n Liczbowa forma miesiąca, bez zer wiodących 1 aż do 12 t Ilość dni w danym miesiącu 28 do 31 Rok --- --- L Informacja o tym, czy rok jest przestępnym 1 jeśli rok jest przestępny, 0 w przeciwnym wypadku. o ISO-8601 week-numbering year. Zwraca to taką samą wartość jak Y, z tym, że jeśli numer tygodnia ISO (W) należy do poprzedniego lub następnego roku, to taki rok będzie użyty w zamian. Przykłady: 1999 lub 2003 X Rozszerzona numeryczna reprezentacja roku, minimum 4 cyfry, z - dla lat p.n.e. i + dla lat n.e. Przykłady: -0055, +0787, +1999, +10191 x Rozszerzona pełna numeryczna forma jeśli wymagana lub standardowa pełna numeryczna forma jeśli jest to możliwe (jak Y). Minimum 4 cyfry. Lata p.n.e. są poprzedzone znakiem -. Lata od 10000 włącznie są poprzedzone znakiem +. Przykłady: -0055, 0787, 1999, +10191 Y Pełna liczbowa forma roku, 4 cyfry, ze znakiem - dla lat p.n.e. Przykłady: -0055, 0787, 1999, 2003, 10191 y Dwie cyfry reprezentujące rok Przykłady: 99 lub 03 Czas --- --- a Pora dnia, dwie małe litery (przed/po południu) (łac. Ante/Post meridiem) am lub pm A Pora dnia, dwie duże litery (przed/po południu) (łac. Ante/Post meridiem) AM or PM B Swatch Internet Time 000 aż do 999 g Godzina, w formacie 12-godzinnym, bez zer wiodących 1 aż do 12 G Godzina, w formacie 24-godzinnym, bez zer wiodących 0 aż do 23 h Godzina, w formacie 12-godzinnym, z zerami wiodącymi 01 aż do 12 H Godzina, w formacie 24-godzinnym, z zerami wiodącymi 00 do 23 i Minuty z zerami wiodącymi 00 do 59 s Sekundy, z zerami wiodącymi 00 do 59 u Mikrosekundy. Zauważ, że date zawsze wygeneruje 000000, ponieważ przyjmuje parametr typu int, podczas gdy DateTimeInterface::format obsługuje mikrosekundy, jeżeli obiekt o typie DateTimeInterface został utworzony z mikrosekundami. Przykład: 654321 v Milisekundy. Takie same uwagi jak dla u. Example: 654 Strefa czasowa --- --- e Identyfikator strefy czasowej Przykłady: UTC, GMT, Europe/Zagreb I (duże i) Informacja o tym, czy data jest w czasie letnim 1 jeśli czas jest letni, 0 w przeciwnym razie. O Różnica z czasem Greenwich (GMT) w godzinach Przykład: +0200 P Różnica z czasem Greenwich (GMT) z dwukropkiem pomiędzy godzinami i minutami Przykład: +02:00 p Takie samo jak P, ale zwraca Z zamiast +00:00 (dostępne od PHP 8.0.0) Przykłady: Z lub +02:00 T Skrót dla strefy czasowej, jeśli znany; w przeciwnym razie różnica do GMT Przykłady: EST, MDT, +05 Z Różnica dla strefy czasowej w sekundach. Wyrównanie to jest zawsze ujemne dla stref położonych na zachód od południka 0 (UTC) oraz dodatnie dla tych leżących na wschód od niego. -43200 aż do 50400 Pełna data/czas --- --- c Data w standardzie ISO 8601 2004-02-12T15:19:21+00:00 r Data zgodna z RFC 2822/RFC 5322 Przykład: Thu, 21 Dec 2000 16:01:07 +0200 U Sekundy liczone od ery UNIX-a (January 1 1970 00:00:00 GMT) Zobacz także time Inne znaki umieszczone w łańcuchu formatującym zostaną wyświetlone normalnie, bez ich zamieniania. Z zwróci zawsze 0 podczas używania gmdate. Ponieważ ta funkcja przyjmuje jako znacznik czasu jedynie typ int, znak formatujący u przydaje się jedynie, gdy używamy funkcji date_format z samodzielnie zdefiniowanymi znacznikami czasu stworzonymi za pomocą funkcji date_create. &reftitle.returnvalues; Zwraca ciąg znaków ze sformatowaną datą w wypadku powodzenia. &reftitle.changelog; &Version; &Description; 8.2.0 Dodano znaki formatujące X i x. 8.0.0 Dodano znak formatujący p. &reftitle.examples; &style.oop; format('Y-m-d H:i:s'); ?> ]]> &style.procedural; ]]> &example.outputs; format('l'), "\n"; // Wyświetli na przykład Wednesday 19th of October 2022 08:40:48 AM echo $date->format('l jS \o\f F Y h:i:s A'), "\n"; /* można też użyć stałych jako argumentu */ // wyświetli na przykład: Wed, 19 Oct 2022 08:40:48 +0000 echo $date->format(DateTimeInterface::RFC2822), "\n"; ?> ]]> Możesz ochronić rozpoznawalne znaki w łańcuchu formatującym przed zinterpretowaniem przez poprzedzenie ich znakiem ucieczki (backslashem). Jeśli znak razem z backslashem jest specjalną sekwencją, możliwe, iż będzie trzeba poprzedzić kolejnym znakiem ucieczki całą sekwencję. format('l \t\h\e jS'); ?> ]]> Aby sformatować datę w innych językach można użyć IntlDateFormatter::format zamiast DateTimeInterface::format. &reftitle.notes; Ta metoda nie wspiera tłumaczeń, wszystkie zwracane wartości są po angielsku. &reftitle.seealso; IntlDateFormatter::format