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.

Properties inherited from Function:

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

Date.prototype.getDate()
Devuelve el día del mes de la fecha especificada según la hora local.
Date.prototype.getDay()
Devuelve el día de la semana de la fecha especificada según la hora local.
Date.prototype.getFullYear()
Devuelve el año de la fecha especificada según la hora local.
Date.prototype.getHours()
Devuelve la hora de la fecha especificada según la hora local.
Date.prototype.getMilliseconds()
Devuelve los milisegundos de la fecha especificada según la hora local.
Date.prototype.getMinutes()
Devuelve los minutos de la fecha especificada según la hora local.
Date.prototype.getMonth()
Devuelve el mes de la fecha especificada según la hora local.
Date.prototype.getSeconds()
Devuelve los segundos de la fecha especificada según la hora local.
Date.prototype.getTime()
Devuelve el valor numérico correspondiente a la hora especificada según la hora universal.
Date.prototype.getTimezoneOffset()
Devuelve la diferencia horaria en minutos para la zona geográfica actual.
Date.prototype.getUTCDate()
Devuelve el día del mes de la fecha especificada según la hora universal.
Date.prototype.getUTCDay()
Devuelve el día de la semana de la fecha especificada según la hora universal.
Date.prototype.getUTCFullYear()
Devuelve el día el año de la fecha especificada según la hora universal.
Date.prototype.getUTCHours()
Devuelve las horas de la fecha especificada según la hora universal.
Date.prototype.getUTCMilliseconds()
Devuelve los milisegundos de la fecha especificada según la hora universal.
Date.prototype.getUTCMinutes()
Devuelve los minutos de la fecha especificada según la hora universal.
Date.prototype.getUTCMonth()
Devuelve el mes de la fecha especificada según la hora universal.
Date.prototype.getUTCSeconds()
Devuelve los segundos de la fecha especificada según la hora universal.
Date.prototype.getYear()
Devuelve el año de la fecha especificada según la hora local. Use Date.prototype.getFullYear() a cambio.
Date.prototype.setDate()
Establece el día del mes de la fecha especificada según la hora local.
Date.prototype.setFullYear()
Establece el año completo de la fecha especificada según la hora local.
Date.prototype.setHours()
Establece las horas de la fecha especificada según la hora local.
Date.prototype.setMilliseconds()
Establece los milisegundos de la fecha especificada según la hora local.
Date.prototype.setMinutes()
Establece los minutos de la fecha especificada según la hora local.
Date.prototype.setMonth()
Establece el mes de la fecha especificada según la hora local.
Date.prototype.setSeconds()
Establece los segundos de la fecha especificada según la hora local.
Date.prototype.setTime()
Establece el valor del objeto Date según la hora local.
Date.prototype.setUTCDate()
Establece el día del mes de la fecha especificada según la hora universal.
Date.prototype.setUTCFullYear()
Establece el año completo de la fecha especificada según la hora universal.
Date.prototype.setUTCHours()
Establece la hora de la fecha especificada según la hora universal.
Date.prototype.setUTCMilliseconds()
Establece los milisegundos de la fecha especificada según la hora universal..
Date.prototype.setUTCMinutes()
Establece los minutos de la fecha especificada según la hora universal..
Date.prototype.setUTCMonth()
Establece el mes de la fecha especificada según la hora universal.
Date.prototype.setUTCSeconds()
Establece los segundos de la fecha especificada según la hora universal..
Date.prototype.setYear ()
Establece el año de la fecha especificada según la hora local. Use Date.prototype.setFullYear() a cambio.
Date.prototype.toGMTString()
Convierte una fecha en una cadena, usando las convenciones de Internet GMT. Utilice Date.prototype.toUTCString() a cambio.
Date.prototype.toLocaleString()
Convierte una fecha en una cadena, usando las reglas de la localización actual. Sobreescribe el método Object.toLocaleString().
Date.prototype.toLocaleDateString()
Devuelve la porción fecha (sin la hora) de una fecha como una cadena, usando las reglas de la localización actual.
Date.prototype.toLocaleTimeString()
Devuelve la porción hora (sin la fecha) de una fecha como una cadena, siguiendo las reglas de la localización actual.
Date.prototype.toSource()
Devuelve un literal que representa al objeto Date especificado; puede usar este valor para crear un nuevo objeto. Sobreescribe el método Object.toSource().
Date.prototype.toString()
Devuelve una cadena representando el objeto Date especificado. Sobreescribe el método Object.toString().
Date.prototype.toUTCString()
Convierte una fecha en una cadena, usando las reglas horarias universales.
Date.prototype.valueOf()
Devuelve el valor primitivo de un objeto Date. Sobreescribe el método Object.valueOf().

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

Etiquetas y colaboradores del documento

Etiquetas: 
Contributors to this page: Eduardo_66, teoli, Talisker, Mgjbot, Sheppy
Última actualización por: Eduardo_66,
Ocultar la barra lateral