Tokeny formatu daty

Istnieją dwie szeroko używane rodziny łańcuchów formatu daty i nakładają się na tyle, aby być niebezpieczne. strftime — z C i odziedziczone przez Python, Ruby, PHP i GNU date — używa tokenów procentowych jak %Y. Unicode LDML, używany przez ICU, Java, moment i dayjs, używa powtórzonych liter jak yyyy. W LDML MM to miesiąc a mm to minuta; przywrócenie tej pary wstecz to klasyczny błąd.

Każdy wiersz poniżej jest renderowany dla tej samej chwili: poniedziałek 9 marca 2026, 14:05:07 UTC. Ta data jest wybrana, aby nic nie się ukrywało — pojedynczy-cyfrowy dzień i miesiąc ujawniają dopełnienie zerami, godzina popołudia sprawia, że zegary 12- i 24-godzinne różnią się widocznie, a dzień tygodnia jest jednoznaczny.

Pusta kolumna równoważna oznacza, że inny dialekt nie ma jednego tokena dla niego i musisz skomponować wartość samemu. Zestaw testów renderuje pola kalendarza za pomocą funkcji daty samej platformy i porównuje je z tą tabelą, więc przykłady nie mogą dryfować od rzeczywistości.

Rok

strftime	LDML	Pole	Renders as
%Y	yyyy	Czterocyfrowy rok	2026
%y	yy	Dwucyfrowy rokNiejednoznaczny przez konstrukcję. Unikaj go w czymkolwiek przechowanym.	26
%C		Wiek — rok podzielony przez 100	20
%G	YYYY	Rok numerowania tygodnia ISORóżni się od roku kalendarzowego wokół Nowego Roku. Używaj tylko z numerem tygodnia ISO.	2026

Miesiąc

W LDML MM to miesiąc i mm to minuta.

strftime	LDML	Pole	Renders as
%m	MM	Miesiąc, dopełniony zerami	03
%-m	M	Miesiąc, bez dopełnienia	3
%b	MMM	Skrócona nazwa miesiąca	Mar
%B	MMMM	Pełna nazwa miesiąca	March

Dzień i dzień tygodnia

W LDML dd to dzień miesiąca i DDD to dzień roku.

strftime	LDML	Pole	Renders as
%d	dd	Dzień miesiąca, dopełniony zerami	09
%-d	d	Dzień miesiąca, bez dopełnienia	9
%e		Dzień miesiąca, dopełniony spacją	9
%j	DDD	Dzień roku, 001–366	068
%a	EEE	Skrócona nazwa dnia tygodnia	Mon
%A	EEEE	Pełna nazwa dnia tygodnia	Monday
%u		Dzień tygodnia jako liczba, poniedziałek to 1%w numeruje te same dni od niedzieli jako 0.	1
%V	ww	Numer tygodnia ISO, tygodnie zaczynające się poniedziałek	11

Czas

strftime	LDML	Pole	Renders as
%H	HH	Godzina na zegarze 24-godzinnym	14
%-H	H	Godzina, bez dopełnienia	14
%I	hh	Godzina na zegarze 12-godzinnym	02
%M	mm	Minuta	05
%S	ss	Sekunda	07
%3N	SSS	Milisekundy	000
%p	a	AM lub PM	PM
%s		Uniksowa sygnatura czasowa — sekundy od 1970-01-01 UTC	1773065107

Strefa czasowa

Offset to liczba; nazwa strefy to reguła. Tylko nazwa przetrwa zmianę DST.

strftime	LDML	Pole	Renders as
%z	ZZ	Offset UTC, bez dwukropka	+0000
%:z	XXX	Offset UTC z dwukropkiem, jak chce ISO 8601	+00:00
%Z	zzz	Skrót strefy czasowejSkróty nie są unikalne — CST jest co najmniej trzema różnymi strefami.	UTC

Typowe kombinacje

Zbudowany z tokenów powyżej — nie potrzebna żadna biblioteka.

strftime	LDML	Pole	Renders as
%F	yyyy-MM-dd	Data ISO	2026-03-09
%T	HH:mm:ss	24-godzinny czas	14:05:07
%FT%T%:z	yyyy-MM-dd'T'HH:mm:ssXXX	Pełna sygnatura czasowa ISO 8601Format do przechowywania. Sortuje się jako tekst, jednoznaczny o offsetie.	2026-03-09T14:05:07+00:00
%a, %d %b %Y %T %z	EEE, dd MMM yyyy HH:mm:ss ZZ	RFC 2822 — nagłówki e-mail i starszy HTTP	Mon, 09 Mar 2026 14:05:07 +0000
%m/%d/%Y	MM/dd/yyyy	Konwencja USA, miesiąc najpierw	03/09/2026
%d.%m.%Y	dd.MM.yyyy	Konwencja europejska, dzień najpierw	09.03.2026
%%	''	Dosłowny znak procent	%

Częste pytania

Jaka jest różnica między yyyy i YYYY?

W LDML yyyy to rok kalendarzowy, a YYYY to rok numerowania tygodnia ISO. Różnią się przez kilka dni każdego stycznia: 2027-01-01 przypada w tygodniu ISO 53 z 2026, więc YYYY czyta 2026 tam. Użycie YYYY przez przypadek produkuje błąd, który pojawia się raz w roku, a następnie znika, dlatego tak trudno go złapać.

Dlaczego mój miesiąc pojawia się jako minuty?

Ponieważ jesteś w dialekcie LDML i używałeś mm zamiast MM. LDML jest wrażliwy na wielkość liter: M to miesiąc, m to minuta, D to dzień roku, d to dzień miesiąca. strftime ma tę samą pułapkę w innym miejscu — %M to minuty a %m to miesiąc.

Jak uzyskać numerowane dopełnione versus niedopełnione?

W strftime rozszerzenie GNU %-d usuwa dopełnienie, więc %d to 09 a %-d to 9. W LDML liczba liter ustawia szerokość bezpośrednio: d to 9 a dd to 09. Żaden nie jest przenośny — %-d nie istnieje na każdej platformie.

Który format powinienem przechowywać daty?

ISO 8601 z wyraźnym offsetem — 2026-03-09T14:05:07+00:00. Sortuje się poprawnie jako tekst, jest jednoznaczny o offsetie, i każdy język go analizuje. Przechowuj to i formatuj do wyświetlenia w ostatniej możliwej chwili; przechowywana data lokalna bez offsetu to bezpowrotna strata informacji.

Tokeny formatu daty

Rok#

Miesiąc#

Dzień i dzień tygodnia#

Czas#

Strefa czasowa#

Typowe kombinacje#