Orario dell'appuntamento

JavaScript ha un oggetto integrato, Date, che memorizza data ed ora e fornisce metodi per gestirle.

Creazione

Un oggetto Date è un'istanza della classe Date. Si può creare senza passare alcun argomento alla funzione costruttrice. Il risultato è un oggetto Date che rappresenta la data e l'ora attuali:

const now = new Date();
// => Thu Apr 14 2022 11:46:08 GMT+0530 (India Standard Time)
// Shows current day, date and time (in your time zone).

Timestamp Unix (numero)

Se si passa un numero, questo viene interpretato come timestamp. Un timestamp è un numero intero che rappresenta il numero di millisecondi trascorsi dal 1º gennaio 1970 UTC+0.

const epoch = new Date(0);
// Thu Jan 01 1970 01:00:00 GMT+0100 (Central European Standard Time)

const another = new Date(1749508766627);
// Tue Jun 10 2025 00:39:26 GMT+0200 (Central European Summer Time)

Ci si potrebbe aspettare che new Date(0) generi l'oggetto data «più antico», ma JavaScript converte la data nel tuo fuso orario locale: significa che solo chi si trova in un fuso GMT / UTC+0 otterrà davvero il valore dell'epoca Unix.

Timestamp ISO 8601 (stringa)

Puoi passare alla funzione costruttrice Date una stringa che rappresenta una data. L'unico formato coerente tra le varie implementazioni è la versione semplificata delle cosiddette stringhe di timestamp ISO 8601, riconosciute e standardizzate a livello internazionale.

Un istante nel tempo in UTC si scrive così:

YYYY-MM-DDTHH:mm:ss.mssZ
YYYYMMDDTHHmmss.mssZ

Dove valgono le seguenti sostituzioni:

La lettera Z indica UTC (nessun fuso orario, nessuna ora legale).

Dato che la maggior parte dei componenti ha un valore predefinito, è valido omettere le parti finali:

YYYY-MM-DD

Il valore predefinito è l'ora 00:00:00.000

Se il timestamp non termina con Z e non termina con +HH:mm o -HH:mm (che indicano uno scostamento di fuso orario), per ragioni storiche vale quanto segue:

Quando lo scostamento di fuso orario è assente, le forme che contengono solo la data vengono interpretate come ora UTC, mentre quelle che contengono data ed ora vengono interpretate come ora locale. L'interpretazione come ora UTC è dovuta a un errore storico della specifica, non coerente con ISO 8601, che non è stato possibile correggere per via della compatibilità con il web. Vedi Broken Parser – A Web Reality Issue.

Oggetto Date

Anche un oggetto data esistente può essere usato come argomento della funzione costruttrice. In questo modo si crea una copia dell'oggetto Date esistente, con la stessa data ed ora.

const t1 = new Date();
const t2 = new Date(t1);
// Values of t1 and t2 will be the same.

Fornire i singoli valori dei componenti di data ed ora

Un oggetto data che rappresenta una data si crea passando tre numeri. Un oggetto data che rappresenta una data ed un'ora si crea passando 6 numeri.

const date1 = new Date(95, 11, 17);
// Creates Date for Dec 17 1995 00:00 if your local timezone is equivalent to UTC.

const date2 = new Date(2013, 12, 5, 13, 24, 0);
// Creates Date for Jan 5 2014 13:24 if your local timezone is equivalent to UTC.

Il secondo valore è il month, che parte da 0 per gennaio e arriva a 11 per dicembre.

Date.parse()

Potresti imbatterti in riferimenti a una funzione di analisi delle date, Date.parse. Dato che per questa funzione esistono solo poche invarianti (verità) e che il resto dell'implementazione non è specificato (e quindi non è standard), è meglio non usarla.

Accedere ai componenti di Date

Gli oggetti data hanno vari metodi che restituiscono i componenti della data:

getFullYear(); // Get the year (4 digits)
getMonth(); // Get the month, from 0 to 11.
getDate(); // Get the day of month, from 1 to 31.
getHours(); // Get the hour in a 24 clock, from 0 to 23
getMinutes(); // Get the minutes, from 0 to 59
getSeconds(); // Get the seconds, from 0 to 59
getMilliseconds(); // Get the milliseconds, from 0 and 999
getDay(); // Get the day of week, from 0 (Sunday) to 6 (Saturday).

Ognuno di questi ha una variante set corrispondente (ad esempio setFullYear) per aggiornare il valore. Ogni valore che va oltre il limite si riporta sul componente successivo:

const date = new Date('2025-02-28T12:42:00Z');
// => Fri Feb 28 2025 13:42:00 GMT+0100 (Central European Standard Time)

date.setDate(29);
// there was no February 29th in 2025.

date.getDate();
// => 1

date.toString();
// => Sat Mar 01 2025 13:42:00 GMT+0100 (Central European Standard Time)

Per tutti i metodi esistono varianti UTC che ignorano il fuso orario locale.

Convertire da una data

Gli oggetti data hanno un metodo getTime() che restituisce il timestamp UNIX in millisecondi, cioè il numero di millisecondi trascorsi dalla mezzanotte del 1º gennaio 1970 UTC. Inoltre è disponibile un metodo toISOString() per convertire un oggetto data in una stringa di timestamp ISO 8601.

Confrontare le date

Gli operatori maggiore di (>), maggiore o uguale (>=), minore di (<) e minore o uguale (<=) si possono usare direttamente tra due date, oppure tra una data ed un numero. Funziona perché JavaScript prova a convertire la data in un primitivo.

Le date non si possono confrontare con gli operatori di uguaglianza (== e ===), ma il risultato di .getTime() sì.