Riferimento rapido

Cheat Sheet Moment.js

Una guida completa per Moment.js: parsing di date, token di formattazione, manipolazione, formati localizzati e alternative moderne.

· Pubblicato

Moment.js e una storica libreria JavaScript per il parsing, la validazione, la modifica e la formattazione di date.

Parsing e Creazione di Date

// Timestamp corrente
const now = moment();

// Parsing con stringa di formato esplicita
const m = moment('2026-10-25', 'YYYY-MM-DD');

// Parsing timestamp Unix (secondi vs millisecondi)
moment.unix(1730000000); // da secondi
moment(1730000000000);   // da millisecondi

// Verifica validita
m.isValid(); // -> true

Token di Formattazione

m.format();                  // "2026-10-25T00:00:00+08:00" (// Formato ISO 8601)
m.format('dddd');            // "Sunday"
m.format('MMM Do YY');       // "Oct 25th 26"
m.fromNow();                 // "// Tempo relativo (es. 3 ore fa)"
m.calendar();                // "// Formato calendario"

Tabella dei Token di Data

Token Intervallo di Output Descrizione
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

Tabella dei Token di Ora

Token Intervallo di Output Descrizione
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

Manipolazione delle Date

Gli oggetti Moment sono mutabili. Le operazioni modificano l'istanza direttamente:

// Aggiunta e sottrazione
moment().add(7, 'days');
moment().subtract(1, 'month');

// Impostazione ai confini dell'unita
moment().startOf('day');  // 00:00:00.000 oggi
moment().endOf('month');  // 23:59:59.999 ultimo giorno del mese

// Clonazione per evitare modifiche involontarie
const original = moment();
const nextWeek = original.clone().add(7, 'days');

Formati Predefiniti Localizzati

Formato Esempio di Output
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

Alternative Moderne

Moment.js e in modalita di sola manutenzione. Alternative moderne consigliate:

  • date-fns: Funzioni immutabili, modulari e compatibili con tree-shaking.
  • Day.js: Libreria leggera da 2KB con API compatibile con Moment.
  • Luxon: Libreria moderna creata dagli autori di Moment basata su Intl.
  • Native Intl.DateTimeFormat: Integrata nativamente nei browser e in Node.js senza dipendenze.

Riferimenti

Argomenti correlati