Permite el almacenamiento básico y la recuperación de fechas y horas.

objetoFecha = new Date()
objetoFecha = new Date(valorFecha)
objetoFecha = new Date(año, mes, día[, horas[, minutos[, segundos[,ms]]]]) 

Argumentos

objetoFecha

Requerido. El nombre de la variable al que se asigna el objeto Date.

valorFecha

Requerido. Si es un valor numérico, valorFecha representa el número de milisegundos en Horario universal coordinado entre la fecha especificada y la medianoche del 1 de enero de 1970. Si es una cadena, valorFecha se procesa de acuerdo con las reglas en el método parse. El argumento valorFecha puede ser también un valor VT_DATE como los devueltos por algunos objetos ActiveX®.

año

Requerido. El año completo, por ejemplo 1976 (y no 76).

mes

Requerido. El mes como un entero entre 0 y 11 (de Enero a Diciembre).

día

Requerido. La fecha como un valor entero entre 1 y 31.

horas

Opcional. Se debe proporcionar si se proporciona minutos. Un entero entre 0 y 23 (medianoche a 11 p.m.) que especifica la hora.

minutos

Opcional. Se debe proporcionar si se proporciona segundos. Un entero entre 0 y 59 que especifica los minutos.

segundos

Opcional. Se debe proporcionar si se proporciona milisegundos. Un entero desde 0 hasta 59 que especifica los segundos.

ms

Opcional. Un entero entre 0 y 999 que especifica los milisegundos.

Comentarios

Un objeto Date que contiene un número que representa un instante de tiempo concreto en milisegundos. Si el valor de un argumento es mayor que su intervalo o si es un número negativo, los demás valores almacenados se modifican según sea el caso. Por ejemplo, si especifica 150 segundos, JScript vuelve a definir ese número como dos minutos y 30 segundos.

Si el número es NaN, el objeto no representa un momento específico de tiempo. Si no pasa parámetros al objeto Date, se inicia con la hora actual (UTC). Se le debe asignar un valor al objeto antes de poder usarlo.

El intervalo de fechas que es posible representar en un objeto Date es aproximadamente 285.616 años antes o después del 1 de enero de 1970.

El objeto Date tiene dos métodos estáticos que se llaman sin crear un objeto Date. Son parse y UTC.

Error

El siguiente método muestra el uso del objeto Date.

function DateDemo(){
   var d, s = "La fecha de hoy es: ";           //Declara las variables.
   d = new Date();                           //Crea objeto Date.
   s += (d.getMonth() + 1) + "/";            //Obtiene el mes
   s += d.getDate() + "/";                   //Obtiene el día
   s += d.getYear();                         //Obtiene el año.
   return(s);                                //Devuelve la fecha.
}

Propiedades

Propiedad constructor | Propiedad prototype

Métodos

Método getDate | Método getDay | Método getFullYear | Método getHours | Método getMilliseconds | Método getMinutes | Método getMonth | Método getSeconds | Método getTime | Método getTimezoneOffset | Método getUTCDate | Método getUTCDay | Método getUTCFullYear | Método getUTCHours | Método getUTCMilliseconds | Método getUTCMinutes | Método getUTCMonth | Método getUTCSeconds | Método getVarDate | Método getYear | Método setDate | Método setFullYear | Método setHours | Método setMilliseconds | Método setMinutes | Método setMonth | Método setSeconds | Método setTime | Método setUTCDate | Método setUTCFullYear | Método setUTCHours | Método setUTCMilliseconds | Método setUTCMinutes | Método setUTCMonth | Método setUTCSeconds | Método setYear | Método toGMTString | Método toLocaleString | Método toUTCString | Método toString | Método valueOf | Método parse | Método UTC

Requisitos

Versión 1

Consulte también

Operador new | Instrucción var