Moment.js to klasyczna biblioteka JavaScript do analizowania, sprawdzania poprawności, modyfikowania i formatowania dat.
Parsowanie i Tworzenie Dat
// Aktualny punkt w czasie
const now = moment();
// Parsowanie ze zdefiniowanym formatem
const m = moment('2026-10-25', 'YYYY-MM-DD');
// Parsowanie znacznika czasu Unix (sekundy vs milisekundy)
moment.unix(1730000000); // z sekund
moment(1730000000000); // z milisekund
// Sprawdzenie poprawności
m.isValid(); // -> true
Tokeny Formatowania
m.format(); // "2026-10-25T00:00:00+08:00" (// Standardowy format ISO 8601)
m.format('dddd'); // "Sunday"
m.format('MMM Do YY'); // "Oct 25th 26"
m.fromNow(); // "// Czas względny (np. 3 godziny temu)"
m.calendar(); // "// Format kalendarza"
Tabela Tokenów Daty
| Token | Zakres Wyjściowy | Opis |
|---|---|---|
YYYY |
2026 |
4-digit year |
YY |
26 |
2-digit year |
MM |
01..12 |
2-digit month |
MMM |
Jan..Dec |
Short month name |
MMMM |
January..December |
Full month name |
DD |
01..31 |
2-digit day of month |
Do |
1st..31st |
Day of month with ordinal |
d |
0..6 |
Day of week (0 is Sunday) |
ddd |
Sun..Sat |
Short day of week |
dddd |
Sunday..Saturday |
Full day of week |
Q |
1..4 |
Quarter of the year |
Tabela Tokenów Czasu
| Token | Zakres Wyjściowy | Opis |
|---|---|---|
HH |
00..23 |
24-hour hour (2-digit) |
H |
0..23 |
24-hour hour (1-digit) |
hh |
01..12 |
12-hour hour (2-digit) |
mm |
00..59 |
Minute (2-digit) |
ss |
00..59 |
Second (2-digit) |
SSS |
000..999 |
Milliseconds (3-digit) |
A |
AM / PM |
Uppercase meridiem |
a |
am / pm |
Lowercase meridiem |
Z |
+08:00 |
Difference from UTC |
Modyfikowanie Dat
Obiekty Moment są modyfikowalne (mutable). Działania modyfikują instancję bezpośrednio:
// Dodawanie i odejmowanie
moment().add(7, 'days');
moment().subtract(1, 'month');
// Ustawianie początku lub końca jednostki
moment().startOf('day'); // 00:00:00.000 dzisiaj
moment().endOf('month'); // 23:59:59.999 ostatni dzień miesiąca
// Klonowanie w celu uniknięcia niezamierzonej mutacji
const original = moment();
const nextWeek = original.clone().add(7, 'days');
Predefiniowane Formaty Lokalne
| Format | Przykładowy Wynik |
|---|---|
LT |
8:30 PM |
LTS |
8:30:25 PM |
L |
10/25/2026 |
LL |
October 25, 2026 |
LLL |
October 25, 2026 8:30 PM |
LLLL |
Sunday, October 25, 2026 8:30 PM |
Nowoczesne Alternatywy
Moment.js znajduje się w trybie utrzymania. Zalecane nowoczesne zamienniki:
- date-fns: Niemodyfikowalne, modułowe funkcje obsługujące tree-shaking.
- Day.js: Lekka biblioteka 2KB o API kompatybilnym z Moment.
- Luxon: Nowoczesna biblioteka autorów Moment oparta na standardzie Intl.
- Native
Intl.DateTimeFormat: Natywnie wbudowane API w przeglądarkach i Node.js bez zewnętrznych zależności.