---
title: Date
slug: Web/JavaScript/Reference/Global_Objects/Date
tags:
  - Date
  - JavaScript
translation_of: Web/JavaScript/Reference/Global_Objects/Date
original_slug: Web/JavaScript/Referencia/Objetos_globales/Date
---
<div>{{JSRef("Objetos_globales", "Date")}}</div>

<h2 id="Resumen" name="Resumen">Resumen</h2>

<p>Permite trabajar con fechas y horas.</p>

<h2 id="Se_Crea_Con" name="Se_Crea_Con">El constructor</h2>

<p>El constructor <code>Date</code>:</p>

<pre class="brush: js">new Date()
new Date(<em>milisegundos</em>)
new Date(<em>cadenaFecha</em>)
new Date(<em>año_num</em>,<em>mes_num</em>,<em>dia_num</em>
        [,<em>hor_num</em>,<em>min_num</em>,<em>seg_num</em>,<em>mils_num</em>])
</pre>

<h3 id="Par.C3.A1metros" name="Par.C3.A1metros">Parámetros</h3>

<dl>
 <dt><code>milisegundos</code></dt>
 <dd>Valor entero que representa el número de milisegundos desde las 00:00:00 UTC del 1 de enero de 1970.</dd>
</dl>

<dl>
 <dt><code>cadenaFecha</code></dt>
 <dd>Valor de tipo cadena que representa una fecha. La cadena debería estar en un formato reconocido por el método {{jsxref("Date.parse()")}}.</dd>
</dl>

<dl>
 <dt><code>año_num, mes_num, dia_num</code></dt>
 <dd>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.</dd>
</dl>

<dl>
 <dt><code>hor_num, min_num, seg_num, mils_num</code></dt>
 <dd>Valores enteros que representan las partes de una hora completa.</dd>
</dl>

<h2 id="Descripci.C3.B3n" name="Descripci.C3.B3n">Descripción</h2>

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

<p><span style="font-size: 14.3999996185303px; line-height: 16.7999992370605px;">Si proporciona algun</span><span style="font-size: 14.3999996185303px; line-height: 16.7999992370605px;">os argumentos, debe proporcionar al menos 2 argumentos.</span> Los argumentos vacíos se establecen a 0 (ó 1 si falta el día). </p>

<p>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.</p>

<p>El objeto <code>Date</code> proporciona un comportamiento uniforme entre plataformas.</p>

<p>El objeto <code>Date</code> 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.</p>

<p>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 {{jsxref("Date.prototype.getFullYear()")}}, {{jsxref("Date.prototype.setFullYear()")}}, {{jsxref("Date.prototype.getUTCFullYear()")}}, y {{jsxref("Date.prototype.setUTCFullYear()")}}.</p>

<p>El siguiente ejemplo devuelve el tiempo transcurrido entre <code>horaA</code> y <code>horaB</code> en milisegundos.</p>

<pre class="eval">horaA = new Date();
// Sentencias que realizan alguna acción.
horaB = new Date();
diferenciaHoras = horaB - horaA;
</pre>

<h2 id="Propiedades" name="Propiedades">Propiedades</h2>

<dl>
 <dt>{{jsxref("Date.prototype")}}</dt>
 <dd>Permite añadir propiedades a un objeto <code>Date</code>.</dd>
</dl>

<p>{{ jsOverrides("Function", "properties", "prototype") }}</p>

<h2 id="M.C3.A9todos_Est.C3.A1ticos" name="M.C3.A9todos_Est.C3.A1ticos">Métodos</h2>

<dl>
 <dt>{{jsxref("Date.now()")}}</dt>
 <dd>Devuelve el valor numérico correspondiente a la hora actual.</dd>
</dl>

<dl>
 <dt>{{jsxref("Date.parse()")}}</dt>
 <dd>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.</dd>
</dl>

<dl>
 <dt>{{jsxref("Date.UTC()")}}</dt>
 <dd>Acepta los mismos parámetros que la forma más larga del constructor, y devuelve el número de milisegundos en un objeto <code>Date</code> desde el 1 de enero de 1970, hora universal 00:00:00.</dd>
</dl>

<h2 id="M.C3.A9todos" name="M.C3.A9todos">Instancias de  <code>Date</code></h2>

<h3 id="Métodos">Métodos</h3>

<p>{{ page("/es/docs/Web/JavaScript/Referencia/Objetos_globales/Date/prototype", "M.C3.A9todos") }}</p>

<h2 id="Ejemplos" name="Ejemplos">Ejemplos</h2>

<h3 id="Ejemplo:_Diversas_maneras_de_asignar_fechas" name="Ejemplo:_Diversas_maneras_de_asignar_fechas">Ejemplo: Diversas maneras de asignar fechas</h3>

<p>Los ejemplos siguientes muestran diversos modos de asignar fechas:</p>

<pre class="brush: js">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);
</pre>

<h3 id="Ejemplo:_Calcular_el_tiempo_transcurrido" name="Ejemplo:_Calcular_el_tiempo_transcurrido">Ejemplo: Calcular el tiempo transcurrido</h3>

<p>Los siguientes ejemplos muestran como determinar el tiempo transcurrido entre dos fechas:</p>

<pre class="brush: js">// 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
</pre>

<pre class="brush: js">// 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
</pre>