Date (Objeto)

Artículo
08/10/2011

Objeto que permite el almacenamiento básico y la recuperación de fechas y horas. El constructor Date presenta dos formas.

function Date( [dateVal : { Number | String | System.DateTime } ] )
function Date( year : int, month : int, date : int[, hours : int [, minutes : int [, seconds : int [, ms : int]]]] )

Argumentos

dateVal
Opcional. Si es un valor numérico, dateVal representa el número de milisegundos en formato Horario universal coordinado que hay entre la fecha especificada y la medianoche del 1 de enero de 1970. Si una cadena, dateVal se analiza según las reglas del método parse. dateVal puede ser también un valor de fecha .NET.
year
Obligatorio. El año completo, por ejemplo 1976 (no 76).
month
Obligatorio. Mes como un entero comprendido entre 0 y 11 (de enero a diciembre).
date
Obligatorio. Fecha como un valor entero comprendido entre 1 y 31.
hours
Opcional. Se debe proporcionar si se proporciona el argumento minutes. Entero comprendido entre 0 y 23 (desde medianoche a las 11 p.m.) que especifica la hora.
minutes
Opcional. Se debe proporcionar si se proporciona el argumento seconds. Entero comprendido entre 0 y 59 que especifica los minutos.
seconds
Opcional. Se debe proporcionar si se proporciona el argumento milliseconds. Entero comprendido entre 0 y 59 que especifica los segundos.
ms
Opcional. Entero comprendido entre 0 y 999 que especifica los milisegundos.

Comentarios

Un objeto Date 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 es un número negativo, los demás valores almacenados se modifican consecuentemente. Por ejemplo, si se especifican 150 segundos, JScript vuelve a definir ese número como dos minutos y 30 segundos.

Si el número es NaN, el objeto no representará un momento específico de tiempo. Si no se pasan parámetros al constructor Date, se inicializará con la hora actual (UTC). Se deberá inicializar una variable de tipo Date para poder utilizarlo.

El intervalo de fechas que se puede representar en un objeto Date abarca el período comprendido, aproximadamente, entre los 285.616 años antes y después del 1 de enero de 1970.

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

Si se llama al constructor Date sin el operador new, el objeto Date que se devuelva contendrá la fecha actual independientemente de los argumentos pasados al constructor.

Nota

El objeto Date interopera con el tipo de datos System.DateTime de .NET Framework en JScript. Sin embargo, otros lenguajes CLS (Common Language Specification, Especificación común de lenguajes) no pueden utilizar el objeto Date porque sólo lo proporciona JScript; no deriva de un tipo de .NET Framework. Por consiguiente, al anotar los parámetros y los tipos de valor devueltos de los métodos conformes a CLS, asegúrese de utilizar el tipo de datos System.DateTime en lugar del objeto Date. Sin embargo, puede utilizar el objeto Date para anotar el tipo de identificadores que no sean parámetros ni tipos de valor devueltos. Para obtener más información, vea Escribir código conforme a CLS.

Para obtener más información sobre cómo usar el objeto Date y los métodos relacionados, vea Cálculos de fecha y hora.

Ejemplo

El siguiente ejemplo utiliza el objeto Date:

var s : String = "Today's date is: ";   // Declare variables.
var d : Date = new Date();              // Create Date object with today's date.
s += (d.getMonth() + 1) + "/";          // Get month
s += d.getDate() + "/";                 // Get day
s += d.getYear();                       // Get year.
print(s);                               // Print date.

Si este programa se hubiese ejecutado el 26 de enero de 1992, el resultado habría sido: