Date

Crea una instància de tipus Date de JavaScript, que representa un únic moment en el temps. Els objectes de tipus Date es basen en un valor de temps que mesura el nombre de milisegons que han passat des de l'u de gener de 1970 UTC.

new Date();
new Date(valor);
new Date(dataString);
new Date(any, mes[, dia[, hora[, minuts[, segons[, milisegons]]]]]);

valor

Nombre sencer que representa el nombre de milisegons des de l'1 de gener de 1970 00:00:00 UTC (Època UNIX).

dataString

Valor String que representa una data. La String ha d'estar en un format reconegut pel mètode Date.parse() (en-US) (Marques de temps RFC 2822 compatibles amb el IETF o bé una versió de la ISO8601).

any

Valor sencer que representa un any. Els valors des de 0 a 99 representen els anys des de 1900 a 1999. Vegeu l'exemple a continuació.

mes

Valor sencer que representa un mes, començant per zero com a gener i acabant amb 11 com a desembre.

dia

Opcional. Valor sencer que representa el dia del mes.

hora

Opcional. Valor sencer que representa l'hora del dia.

minut

Opcional. Valor sencer que representa els minuts d'un segment de temps.

segon

Opcional. Valor sencer que representa els segons d'un segment de temps.

milisegons

Opcional. Valor sencer que representa els milisegons d'un segment de temps.

• Si no es proporciona cap argument, el constructor crea un objecte de JavaScript de tipus Date i l'inicialitza amb l'hora actual proporcionada pel sistema.
• Si es proporcionen al menys dos arguments, els arguments no proporcionats es consideren o bé 1 (si no s'especifica el dia) o bé 0 per a tots els altres.
• L'hora de JavaScript es basa en els milisegons que han passat des de la mitja nit de l'1 de gener de 1970 UTC. Un dia té 86.400.000 milisegons. El rang de l'objecte de JavaScript Date és de -100.000.000 dies a 100.000.000 dies relatius a l'1 de gener de 1970 UTC.
• L'objecte de JavaScript Date proporciona el mateix comportament a totes les plataformes on s'utilitzi. El valor de temps es pot passar entre sistemes per a representar el mateix moment del temps i si s'utilitza per a crear un objecte que contingui l'hora local, aquest objecte representarà l'equivalent al temps local.
• Alguns dels mètodes de l'objecte de JavaScript Date soporten temps en UTC (universal) i temps local. UTC, també conegut com a Greenwhich Mean Time (GMT), fa referència al temps marcat pel World Time Standard. El temps local és el temps proporcionat per l'ordinador on s'executa el JavaScript.
• Si s'invoca la funció de JavaScript Date com una funció (és a dir, sense l'operador new (en-US)), aquesta retornarà una string representant la data i hora actual.

Date.prototype (en-US)

Permet afegir propietats a l'objecte de JavaScript Date.

Date.length

El valor de Date.length és 7. Aquest és el nombre de arguments que el constructor accepta.

Date.now()

Retorna el valor numèric corresponent al temps actual - el nombre de milisegons que han passat des de l'1 de gener de 1970 00:00:00 UTC.

Date.parse() (en-US)

Interpreta un string que representa una data i retorna el nombre de milisegons des de l'1 de gener de 1970 00:00:00 UTC.

Date.UTC()

Accepta els mateixos paràmetres que el constructor (és a dir, de 2 a 7) i retorna le nombre de milisegons des de l'1 de gener de 1970 00:00:00 UTC.

Totes les instàncies de Date hereten de Date.prototype (en-US). L'objecte prototipus del constructor Date pot ser modificat per a afectar a totes les instàncies de Date.

Els següents exemples mostren diverses maneres de crear dates a JavaScript:

var today = new Date();
var birthday = new Date('December 17, 1995 03:24:00');
var birthday = new Date('1995-12-17T03:24:00');
var birthday = new Date(1995, 11, 17);
var birthday = new Date(1995, 11, 17, 3, 24, 0);

Per a crear i obtindre dates entre els anys 0 i 99 es recomana emprar els mètodes Date.prototype.setFullYear() i Date.prototype.getFullYear().

var date = new Date(98, 1); // Sun Feb 01 1998 00:00:00 GMT+0000 (GMT)

// Deprecated method, 98 maps to 1998 here as well
date.setYear(98);           // Sun Feb 01 1998 00:00:00 GMT+0000 (GMT)

date.setFullYear(98);       // Sat Feb 01 0098 00:00:00 GMT+0000 (BST)

Els exemples següents mostren com determinar el temps passat entre dues dates a JavaScript:

// utilitzant objectes Date
var start = Date.now();

// L'event a cronometra va aquí:
doSomethingForALongTime();
var end = Date.now();
var elapsed = end - start; // temps transcorregut en milisegons

// utilitzant mètodes que formen part del sistema
var start = new Date();

// the event to time goes here:
doSomethingForALongTime();
var end = new Date();
var elapsed = end.getTime() - start.getTime(); // temps transcorregut en milisegons

// cronometra una funció i retorna el que retorni
function printElapsedTime(fTest) {
  var nStartTime = Date.now(),
      vReturn = fTest(),
      nEndTime = Date.now();

  console.log('Temps transcorregut: ' + String(nEndTime - nStartTime) + ' miliseconds');
  return vReturn;
}

yourFunctionReturn = printElapsedTime(yourFunction);

• 4/2012 punts essencials de Yaffle sobre problemes de compatibilitat amb navegadors dels mètodes toISOString/fromISOString/Native Date.parse
• 3/14/2012 blog de danvk Comparant FF/IE/Chrome en l'interpretació de dates com a strings

Internet Explorer 8 no suporta el format de dates ISO8601.