Aprendamos un nuevo objeto incorporado de JS: Date. Este objeto almacena la fecha, la hora, y brinda métodos para administrarlas.
Por ejemplo, podemos usarlo para almacenar horas de creación o modificación, medir tiempo, o simplemente mostrar en pantalla la fecha actual.
Creación
Para crear un nuevo objeto Date se lo instancia con new Date() junto con uno de los siguientes argumentos:
new Date()-
Sin argumentos – crea un objeto
Datepara la fecha y la hora actuales:let now = new Date(); alert( now ); // muestra en pantalla la fecha y la hora actuales new Date(milliseconds)-
Crea un objeto
Datecon la cantidad de tiempo igual al número de milisegundos (1/1000 de un segundo) transcurrido a partir del 1° de enero de 1970 UTC+0.// 0 significa 01.01.1970 UTC+0 let Jan01_1970 = new Date(0); alert( Jan01_1970 ); // ahora se le agregan 24 horas, se obtiene 02.01.1970 UTC+0 let Jan02_1970 = new Date(24 * 3600 * 1000); alert( Jan02_1970 );Un timestamp es un número entero que representa la cantidad de milisegundos transcurridos desde el inicio de 1970.
Este timestamp es una representación numérica liviana de una fecha. Es posible crear una fecha a partir de un timestamp usando
new Date(timestamp), y convertir el objetoDateactual a un timestamp utilizando el métododate.getTime()(ver abajo).Las fechas anteriores a 01.01.1970 tienen timestamps negativos, por ejemplo:
// 31 Dec 1969 let Dec31_1969 = new Date(-24 * 3600 * 1000); alert( Dec31_1969 ); new Date(datestring)-
Si se pasa un único argumento, y es de tipo string, entonces es analizado y convertido a fecha automáticamente. El algoritmo es el mismo que el que utiliza
Date.parse, lo veremos mas en detalle luego.let date = new Date("2017-01-26"); alert(date); // La hora no está definida, por lo que se asume que es la medianoche GMT (0 hs. de la fecha) y // se ajusta de acuerdo al huso horario de la zona geográfica en la que está ejecutándose el código. // Por consiguiente, el resultado podría ser // Thu Jan 26 2017 11:00:00 GMT+1100 (Hora Estándar del Este de Australia) // o // Wed Jan 25 2017 16:00:00 GMT-0800 (Hora Estándar del Pacífico) new Date(año, mes, fecha, horas, minutos, segundos, ms)-
Crea una fecha con los componentes pasados como argumentos en la zona horaria local. Sólo los primeros dos parámetros son obligatorios.
- El
añodebería tener 4 dígitos. Por compatibilidad, aquí 2 dígitos serán considerados ‘19xx’, pero 4 dígitos es lo firmemente sugerido. - La cuenta del
mescomienza desde el0(enero), y termina en el11(diciembre). - El parámetro
fechaefectivamente es el día del mes, si está ausente se asume su valor en1. - Si los parámetros
horas/minutos/segundos/msestán ausentes, se asumen sus valores iguales a0.
Por ejemplo:
new Date(2011, 0, 1, 0, 0, 0, 0); // 1 Jan 2011, 00:00:00 new Date(2011, 0, 1); // Igual que la línea de arriba, sólo que a los últimos 4 parámetros se les asigna '0' por defecto.La precisión máxima es de 1 ms (1/1000 de segundo):
let date = new Date(2011, 0, 1, 2, 3, 4, 567); alert( date ); // 1.01.2011, 02:03:04.567 - El
Acceso a los componentes de la fecha
Existen métodos que sirven para obtener el año, el mes, y los demás componentes a partir de un objeto de tipo Date:
- getFullYear()
- Devuelve el año (4 dígitos)
- getMonth()
- Devuelve el mes, de 0 a 11.
- getDate()
- Devuelve el día del mes desde 1 a 31. Nótese que el nombre del método no es muy intuitivo.
- getHours(), getMinutes(), getSeconds(), getMilliseconds()
- Devuelve los componentes del horario correspondientes.
getYear(), sino getFullYear()Algunos motores de JavaScript poseen implementado un método no estándar llamado getYear(). Este método actualmente está obsoleto. A veces devuelve un año de 2 dígitos. Por favor, nunca lo uses. Usa getFullYear() para obtener el año.
Además, podemos obtener un día de la semana:
- getDay()
- Devuelve el día de la semana, partiendo de
0(Domingo) hasta6(Sábado). El primer día siempre es el Domingo. Por más que en algunos países no sea así, no se puede modificar.
Todos los métodos mencionados anteriormente devuelven los componentes correspondientes a la zona horaria local.
También existen sus contrapartes UTC, que devuelven el día, mes, año, y demás componentes, para la zona horaria UTC+0: getUTCFullYear(), getUTCMonth(), getUTCDay(). Solo debemos agregarle el "UTC" justo después de "get".
Si tu zona horaria está desplazada respecto de UTC el código de abajo va a mostrar horas diferentes:
// fecha actual
let date = new Date();
// la hora en tu zona horaria actual
alert( date.getHours() );
// la hora respecto de la zona horaria UTC+0 (Hora de Londres sin horario de verano)
alert( date.getUTCHours() );
Además de los anteriormente mencionados, hay dos métodos especiales que no poseen una variante de UTC:
- getTime()
-
Devuelve el timestamp para una fecha determinada – cantidad de milisegundos transcurridos a partir del 1° de Enero de 1970 UTC+0.
- getTimezoneOffset()
-
Devuelve la diferencia entre UTC y el huso horario de la zona actual, en minutos:
// Si estás en la zona horaria UTC-1, devuelve 60 // Si estás en la zona horaria UTC+3, devuelve -180 alert( new Date().getTimezoneOffset() );
Estableciendo los componentes de la fecha
Los siguientes métodos permiten establecer los componentes de fecha y hora:
setFullYear(year, [month], [date])setMonth(month, [date])setDate(date)setHours(hour, [min], [sec], [ms])setMinutes(min, [sec], [ms])setSeconds(sec, [ms])setMilliseconds(ms)setTime(milliseconds)(Establece la cantidad de segundos transcurridos desde 01.01.1970 GMT+0)
A excepción de setTime(), todos los demás métodos poseen una variante UTC, por ejemplo: setUTCHours().
Como podemos ver, algunos métodos nos permiten fijar varios componentes al mismo tiempo, por ej. setHours. Los componentes que no son mencionados no se modifican.
Por ejemplo:
let today = new Date();
today.setHours(0);
alert(today); // Sigue siendo el día de hoy, pero con la hora cambiada a 0.
today.setHours(0, 0, 0, 0);
alert(today); // Sigue siendo la fecha de hoy, pero ahora en formato 00:00:00 en punto.
Autocorrección
La autocorrección es una característica muy útil de los objetos Date. Podemos fijar valores fuera de rango, y se ajustarán automáticamente.
Por ejemplo:
let date = new Date(2013, 0, 32); // ¿32 de Enero 2013?
alert(date); // ¡Se autocorrigió al 1° de Febrero de 2013!
Los componentes de la fecha que están fuera de rango se distribuyen automáticamente.
Por ejemplo, supongamos que necesitamos incrementar la fecha “28 Feb 2016” en 2 días. El resultado puede ser “2 Mar” o “1 Mar” dependiendo de si es año bisiesto. Afortunadamente, no tenemos de qué preocuparnos. Sólo debemos agregarle los 2 días y el objeto Date se encargará del resto:
let date = new Date(2016, 1, 28);
date.setDate(date.getDate() + 2);
alert( date ); // 1 Mar 2016
Esta característica se usa frecuentemente para obtener la fecha, a partir de un período de tiempo específico. Por ejemplo, supongamos que queremos obtener “la fecha de hoy pero transcurridos 70 segundos a partir de este preciso instante.”
let date = new Date();
date.setSeconds(date.getSeconds() + 70);
alert( date ); // Se muestra la fecha correcta.
También podemos fijar valores en 0 o incluso valores negativos. Por ejemplo:
let date = new Date(2016, 0, 2); // 2 Jan 2016
date.setDate(1); // Fija '1' día del mes
alert( date );
date.setDate(0); // el día mínimo es 1, entonces asume el último día del mes anterior
alert( date ); // 31 Dec 2015
Conversión de fechas a números y diferencia entre fechas.
Cuando convertimos un objeto Date a número toma el valor del timestamp actual, al igual que el método date.getTime():
let date = new Date();
alert(+date); // devuelve el número de milisegundos, al igual que date.getTime()
El efecto secundario importante: las fechas pueden ser restadas, el resultado es su diferencia en ms.
Esto puede ser usado para medición de tiempo:
let start = new Date(); // comienza a medir el tiempo (valor inicial)
// la función hace su trabajo
for (let i = 0; i < 100000; i++) {
let doSomething = i * i * i;
}
let end = new Date(); // termina de medir el tiempo (valor final)
alert(`El tiempo transcurrido es de ${end - start} ms`);
Date.now()
Si lo único que queremos es medir el tiempo transcurrido, no es necesario utilizar el objeto Date.
Podemos utilizar el método especial Date.now() que nos devuelve el timestamp actual.
Es el equivalente semántico a new Date().getTime(), pero no crea una instancia intermediaria del objeto Date. De esta manera, el proceso es mas rápido y, por consiguiente, no afecta a la recolección de basura.
Mayormente se utiliza por conveniencia o cuando la performance del código es fundamental, como por ejemplo en juegos de JavaScript u otras aplicaciones específicas.
Por lo tanto, es mejor hacerlo de esta manera:
let start = Date.now(); // milisegundos transcurridos a partir del 1° de Enero de 1970
// la función realiza su trabajo
for (let i = 0; i < 100000; i++) {
let doSomething = i * i * i;
}
let end = Date.now(); // listo
alert( `El bucle tardó ${end - start} ms` ); // restamos números en lugar de fechas