Hora de la cita

JavaScript tiene un objeto integrado, Date, que almacena la fecha y la hora y proporciona métodos para gestionarlas.

Creación

Un objeto Date es una instancia de la clase Date. Se puede crear sin pasar ningún argumento a la función constructora. Esto da como resultado un objeto Date que representa la fecha y la hora actuales:

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 de Unix (número)

Si se pasa un número, se interpretará como un timestamp. Un timestamp es un número entero que representa la cantidad de milisegundos transcurridos desde el 1 de enero de 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)

Se podría esperar que new Date(0) genere el objeto de fecha «más temprano», pero JavaScript convertirá la fecha a tu zona horaria local, lo que significa que solo quienes tengan una zona horaria GMT / con UTC+0 obtendrán realmente el valor de la época de Unix.

Timestamp ISO 8601 (string)

Puedes pasar un valor de tipo string que represente una fecha al constructor de Date. El único formato coherente entre implementaciones es la versión simplificada de los denominados strings de timestamp ISO 8601, reconocidos y estandarizados internacionalmente.

Un momento concreto en UTC tiene este aspecto:

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

Donde se aplican las siguientes sustituciones:

La letra Z literal indica UTC (sin zona horaria, sin horario de verano).

Como la mayoría de los componentes tienen valores predeterminados, es válido omitir partes al final:

YYYY-MM-DD

El valor predeterminado es una hora de 00:00:00.000

Si el timestamp no termina en Z, y no termina con +HH:mm o -HH:mm (lo que indica un desplazamiento de zona horaria), por motivos históricos se aplica lo siguiente:

Cuando no hay desplazamiento de zona horaria, los formatos que solo incluyen la fecha se interpretan como una hora UTC, y los formatos de fecha y hora se interpretan como una hora local. La interpretación como hora UTC se debe a un error histórico de la especificación que no era coherente con ISO 8601, pero que no se pudo cambiar debido a la compatibilidad web. Consulta Broken Parser – A Web Reality Issue.

Objeto Date

También se puede usar un objeto de fecha existente como argumento del constructor. Esto crea una copia del objeto Date existente con la misma fecha y hora.

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

Proporcionar valores individuales de los componentes de fecha y hora

Se puede crear una fecha que represente una fecha pasando tres números. Se puede crear una fecha que represente una fecha y una hora pasando seis números.

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.

El segundo valor es el month, que empieza en 0 para enero y llega hasta 11 para diciembre.

Date.parse()

Es posible que encuentres menciones o referencias a una función de parseo de fechas, Date.parse. Como esta función solo tiene unas pocas invariantes (verdades) y el resto de la implementación no está especificada (y por tanto no es estándar), no deberías usarla.

Acceder a los componentes de Date

Hay varios métodos en los objetos de fecha que devuelven los componentes de la fecha:

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).

Cada uno de ellos tiene una variante set correspondiente (por ejemplo, setFullYear) para actualizar el valor. Cualquier valor que se desborde pasa al componente siguiente:

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)

Existen variantes UTC de todos los métodos que ignoran la zona horaria local.

Convertir desde una fecha

Los objetos de fecha tienen un método getTime() que devuelve el timestamp UNIX en milisegundos, es decir, la cantidad de milisegundos transcurridos desde la medianoche del 1 de enero de 1970, UTC. Además, hay un método toISOString() disponible para convertir un objeto de fecha a un string de timestamp ISO 8601.

Comparar fechas

El mayor que (>), el mayor o igual que (>=), el menor que (<) y el menor o igual que (<=) se pueden usar directamente entre dos fechas o entre una fecha y un número. Esto funciona porque JavaScript intentará convertir la fecha a un tipo primitivo.

Las fechas no se pueden comparar usando igualdad (== y ===), pero el resultado de .getTime() sí.