Date

Resumen

Permite trabajar con fechas y horas.

El constructor

El constructor Date:

new Date()
new Date(milisegundos)
new Date(
cadenaFecha)
new Date(
año_num,
mes_num,
dia_num
        [,
hor_num,
min_num,
seg_num,
mils_num])

Parámetros

milisegundos

Valor entero que representa el número de milisegundos desde las 00:00:00 UTC del 1 de enero de 1970.

cadenaFecha

Valor de tipo cadena que representa una fecha. La cadena debería estar en un formato reconocido por el método Date.parse().

año_num, mes_num, dia_num

Valores enteros con las representaciones de las partes de una fecha. Como valor entero, el mes se representa de 0 a 11, con 0=enero and 11=diciembre.

hor_num, min_num, seg_num, mils_num

Valores enteros que representan las partes de una hora completa.

Descripción

Si no proporciona argumentos, el constructor crea un objeto Date con la hora y fecha de hoy según la hora local.

Si proporciona algunos argumentos, debe proporcionar al menos 2 argumentos. Los argumentos vacíos se establecen a 0 (ó 1 si falta el día). 

La fecha se mide en milisegundos desde la media noche exacta del 01 de enero de 1970 en formato UTC. Un día contiene 86.400.000 milisegundos. El rango del objeto Date va desde -100,000,000 días hasta 100,000,000 días respecto del 01 de enero de 1970 UTC.

El objeto Date proporciona un comportamiento uniforme entre plataformas.

El objeto Date soporta métodos UTC (universales), además de métodos horarios locales. UTC, también conocido como Greenwich Mean Time (GMT), se refiere a la hora según el Estádar Horario Mundial (World Time Standard). La hora local es la hora establecida por el ordenador donde se ejecuta JavaScript.

Por compatibilidad con los cálculos del nuevo milenio (en otras palabras, para tener en cuenta el efecto 2000), debería especificar siempre el año completo; por ejemplo, utilice 1998, y no 98. Para ayudarle a especificar el año completo, JavaScript incluye los métodos Date.prototype.getFullYear(), Date.prototype.setFullYear(), Date.prototype.getUTCFullYear(), y Date.prototype.setUTCFullYear().

El siguiente ejemplo devuelve el tiempo transcurrido entre horaA y horaB en milisegundos.

horaA = new Date();
// Sentencias que realizan alguna acción.
horaB = new Date();
diferenciaHoras = horaB - horaA;

Propiedades

For proprietades available on Date instances, see Proprietades of Date instances.

Date.prototype

Permite añadir propiedades a un objeto Date.

Métodos

For m.c3.a9todos available on Date instances, see M.c3.a9todos of Date instances.

Date.now()

Devuelve el valor numérico correspondiente a la hora actual.

Date.parse()

Transforma una cadena que representa una fecha, y devuelve el número de milisegundos desde el 1 de enero de 1970, hora local 00:00:00.

Date.UTC()

Acepta los mismos parámetros que la forma más larga del constructor, y devuelve el número de milisegundos en un objeto Date desde el 1 de enero de 1970, hora universal 00:00:00.

Instancias de  Date

Métodos

Ejemplos

Ejemplo: Diversas maneras de asignar fechas

Los ejemplos siguientes muestran diversos modos de asignar fechas:

hoy = new Date();
cumpleanos = new Date("December 17, 1995 03:24:00");
cumpleanos = new Date(1995,11,17);
cumpleanos = new Date(1995,11,17,3,24,0);

Ejemplo: Calcular el tiempo transcurrido

Los siguientes ejemplos muestran como determinar el tiempo transcurrido entre dos fechas:

// usando métodos estáticos
var inicio = Date.now();
// el evento cuyo tiempo ha transcurrido aquí:
hacerAlgoPorAlgunTiempo();
var fin = Date.now();
var transcurso = fin - inicio; // tiempo en milisegundos

// si tiene objetos Date
var inicio = new Date();
// el evento cuyo tiempo ha transcurrido aquí:
hacerAlgoPorAlgunTiempo();
var fin = new Date();
var transcurso = fin.getTime() - inicio.getTime(); // tiempo en milisegundos