Seleccionar página

Referencia de ECMAScript 5.1 – Objeto Date

Índice

Date() | Date.prototype | Date.now() | Date.parse() | Date.UTC() | dat.getDate() | dat.getDay() | dat.getFullYear() | dat.getHours() | dat.getMilliseconds() | dat.getMinutes() | dat.getMonth() | dat.getSeconds() | dat.getTime() | dat.getTimezoneOffset() | dat.getUTCDate() | dat.getUTCDay() | dat.getUTCFullYear() | dat.getUTCHours() | dat.getUTCMilliseconds() | dat.getUTCMinutes() | dat.getUTCMonth() | dat.getUTCSeconds() | dat.getYear() | dat.setDate() | dat.setFullYear() | dat.setHours() | dat.setMilliseconds() | dat.setMinutes() | dat.setMonth() | dat.setSeconds() | dat.setTime() | dat.setUTCDate() | dat.setUTCFullYear() | dat.setUTCHours() | dat.setUTCMilliseconds() | dat.setUTCMinutes() | dat.setUTCMonth() | dat.setUTCSeconds() | dat.setYear() | dat.toDateString() | dat.toGMTString() | dat.toISOString() | dat.toJSON() | dat.toLocaleDateString() | dat.toLocaleTimeString() | dat.toTimeString() | dat.toUTCString()


Date()

Función constructora de los objetos de tipo Date

Sintaxis

var fecha = new Date()
var fecha = new Date(fecha2)
var fecha = new Date(año, mes, dia[, hora[, minutos[, segundos[,ms]]]])

Si no se pasa ningún parámetro el objeto Date se inicializa con la hora actual (UTC).

fecha2

Si es un valor numérico representa el número de milisegundos que hay entre la fecha especificada y las 00:00 h del 1 de enero de 1970 en el formato de horario universal coordinado. Si es una cadena se analiza según las reglas de Cadenas de fecha y hora de JavaScript. Si el número es NaN, el objeto no representa un instante específico de tiempo, pero deberá ser inicializado antes de poder ser utilizado.

año

Año completo con cuatro dígitos.

mes

Número del mes comprendido entre 0 y 11 (de enero a diciembre). Nota: es muy habitual indicar el mes empezando en 1, pero en Javascript se empieza en 0, lo cual es fuente de algunas confusiones.

dia

Número del día del mes, es decir, un valor entero comprendido entre 1 y 31.

hora

Opcional. Entero comprendido entre 0 y 23 que especifica la hora. Se debe proporcionar si se proporciona minutos.

minutos

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

segundos

Opcional. Entero comprendido entre 0 y 59 que especifica los segundos. Se debe proporcionar si se proporciona ms.

ms

Opcional. Entero comprendido entre 0 y 999 que especifica los milisegundos.

Si el valor de algún argumento es mayor que el intervalo definido o es un número negativo, los demás valores almacenados se modifican en consecuencia. Por ejemplo, si se especificas 150 segundos, JavaScript vuelve a definir ese número como 2 minutos y 30 segundos.

var fecha = Date()
var fecha = Date(fecha2)
var fecha = Date(anno, mes, dia[, hora[, minutos[, segundos[,ms]]]])

La función constructora Date() puede ser invocada como una función devolviendo una cadena con la fecha y hora actual y no es equivalente a llamar a new Date().


Date.prototype

prototipo de los objetos del tipo Date.

Sintaxis

Date.prototype

El prototipo incluye todas las propiedades y métodos que heredarán los objetos del tipo Date.

Si al objeto prototype se le añade o modifican propiedades o métodos, todos los objetos creados a partir del tipo Date tendrán estos nuevos miembros, incluso los creados con anterioridad a la modificación del prototipo.

ECMA-262

Date.now()

Obtiene el valor numérico de la fecha y hora actuales.

Sintaxis

Date.now()

Devuelve el número de milisegundos que hay entre la medianoche del 1 de enero de 1970 y la fecha y hora actuales.

Ejemplo

var inicio = Date.now();
for (var cont = 0; cont < 10000; cont++) {
}
var fin = Date.now() - inicio;
console.log('Se ha tardado %d milisegundos en ejecutar 10.000 veces el bucle', fin);

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262 Edición 5

Date.parse()

Analiza una cadena que contiene una fecha y devuelve la representación numérica de esa fecha.

Sintaxis

Date.parse(cadenafecha)

cadenafecha

Cadena con formato fecha con la siguiente estructura:

YYYY-MM-DDTHH:mm:ss.sssZ

Donde los campos son los siguientes:

campo contenido
YYYY cuatro dígitos del año, de 0000 a 9999.
- guión (-) de separación.
MM dos dígitos del mes, de 01 (enero) a 12 (diciembre).
- guión (-) de separación.
DD dos dígitos para el día del mes, de 01 a 31.
T letra T que indica que se inicia la sección de la hora (Time).
HH dos dígitos para las horas, de 00 a 24.
: dos puntos (`:') de separación.
mm dos dígitos para los minutos, de 00 a 59.
: dos puntos (`:') de separación
ss dos digitos para los segundos, de 00 a 59.
. un punto (.) de separación.
sss tres dígitos para los milisegundos.
Z zona horaria, siendo Z para UTC o la diferencia negativa o positiva en horas y minutos con signo y el formato +00:00

Se aceptan formas parciales de fecha como:

  • YYYY
  • YYYY-MM
  • YYYY-MM-DD

Las formas de fecha y hora debe tener siempre una parte de fecha como las anteriores seguida de cualquiera de las siguientes formas de hora:

  • THH:mm
  • THH:mm:ss
  • THH:mm:ss.sss

Devuelve el número de milisegundos transcurridos entre esa fecha y la medianoche del 1 de enero de 1970.

Ejemplo

var numFecha = Date.parse('1792-10-12');
var fecha = new Date(numFecha);

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

Date.UTC()

Devuelve el número de milisegundos transcurrido entre la medianoche del 1 de enero de 1970 según el horario universal coordinado (UTC) (o GMT) y la fecha especificada.

Sintaxis

Date.UTC(año, mes, dia[, hora[, minutos[, segundos[,ms]]]])

año

Año completo con cuatro dígitos.

mes

Número del mes comprendido entre 0 y 11 (de enero a diciembre). Nota: es muy habitual indicar el mes empezando en 1, pero en Javascript se empieza en 0, lo cual es fuente de algunas confusiones.

dia

Número del día del mes, es decir, un valor entero comprendido entre 1 y 31.

houra

Opcional. Entero comprendido entre 0 y 23 que especifica la hora. Se debe proporcionar si se proporciona minutos.

minutos

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

segundos

Opcional. Entero comprendido entre 0 y 59 que especifica los segundos. Se debe proporcionar si se proporciona ms.

ms

Opcional. Entero comprendido entre 0 y 999 que especifica los milisegundos.

Si el valor de algún argumento es mayor que el intervalo definido o es un número negativo, los demás valores almacenados se modifican en consecuencia. Por ejemplo, si se especifica 150 segundos, JavaScript vuelve a definir ese número como 2 minutos y 30 segundos.

La función Date.UTC devuelve el número de milisegundos transcurridos entre la medianoche del 1 de enero de 1970 UTC y la fecha proporcionada. Este valor devuelto se puede usar en el método setTime() y en el constructor del objeto Date.

Ejemplo

var fecha = new Date(Date.UTC(1492, 9, 12));

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.getDate()

Obtiene el valor del día del mes usando la hora local.

Sintaxis

objeto.getDate()

dat

Objeto de tipo Date del que queremos obtener el día del mes.

Devuelve el valor del día del mes de la fecha, utilizando la diferencia horaria local.

Ejemplo

var dat = new Date();
var dia = dat.getDay();

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.getDay()

Devuelve el día de la semana usando la hora local.

Sintaxis

dat.getDay()

dat

Objeto de tipo Date del que queremos obtener el día de la semana.

Devuelve el día de la semana de la fecha utilizando la diferencia horaria local, siendo 0 el domingo, 1 lunes, 2 martes, 3 miércoles, 4 jueves, 5 viernes y 6 el sábado.

Ejemplo

var dat = new Date();
var diasemana = dat.getDay();

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.getFullYear()

Devuelve el valor del año usando la hora local.

Sintaxis

dat.getFullYear()

dat

Objeto de tipo Date del que queremos obtener el año.

Devuelve el valor del año de la fecha, utilizando la diferencia horaria local.

Ejemplo

var dat = new Date();
var mes = dat.getFullYear();

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.getHours()

Devuelve el valor de las horas usando la hora local.

Sintaxis

dat.getHours()

dat

Objeto de tipo Date del que queremos obtener la hora.

Devuelve el valor correspondiente a las horas de la fecha y hora, utilizando la diferencia horaria local.

Ejemplo

var dat = new Date();
var hora = dat.getHours();

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.getMilliseconds()

Devuelve el valor de los milisegundos usando la hora local.

Sintaxis

dat.getMilliseconds()

dat

Objeto de tipo Date del que queremos obtener los milisegundos.

Devuelve el valor de los milisegundos de la fecha y hora, utilizando la diferencia horaria local.

Ejemplo

var dat = new Date();
var ms = dat.getMilliseconds();

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.getMinutes()

Devuelve el valor de los minutos usando la hora local.

Sintaxis

dat.getMinutes()

dat

Objeto de tipo Date del que queremos obtener los minutos.

Devuelve el valor de los minutos de la fecha y hora, utilizando la diferencia horaria local.

Ejemplo

var dat = new Date();
var minutos = dat.getMinutes();

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.getMonth()

Devuelve el valor del mes usando la hora local.

Sintaxis

dat.getMonth()

dat

Objeto de tipo Date del que queremos obtener el mes.

Devuelve el valor del mes de esa fecha, utilizando la diferencia horaria local, empezando en 0 (enero) hasta 11 (diciembre).

Ejemplo

var dat = new Date();
var mes = dat.getMoth();

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.getSeconds()

Devuelve el valor de los segundos usando la hora local.

Sintaxis

dat.getSecods()

dat

Objeto de tipo Date del que queremos obtener los segundos.

Devuelve el valor de los segundos de la fecha y hora, utilizando la diferencia horaria local.

Ejemplo

var dat = new Date();
var segundos = dat.getSeconds();

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.getTime()

Devuelve el valor de tiempo en un objeto Date en milisegundos desde la medianoche del 1 de enero de 1970.

Sintaxis

dat.getTime()

dat

Objeto de tipo Date del que queremos obtener su representación numérica.

Obtiene el valor numérico de un objeto Date, de forma independiente de la zona horaria, que corresponde al valor en milisegundos desde la medianoche del 1 de enero de 1970. Si es un valor positivo es una fecha posterior y si es un valor negativo será una fecha anterior al 1 de enero de 1970.

Ejemplo

var dat = new Date();
var numfecha = dat.getTime();

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.getTimezoneOffset()

Devuelve la diferencia en minutos entre la hora del equipo host y la hora universal coordinada (UTC).

Sintaxis

dat.getTimezoneOffset()

dat

Objeto de tipo Date del que queremos obtener su diferencia horaria con la Hora Universal Coordinada (hora UTC).

Devuelve el número de minutos entre la hora del equipo actual y el valor de UTC.

Ejemplo

var dat = new Date();
var horas = dat.getTimezoneOffset() / 60;

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.getUTCDate()

Devuelve el valor del día del mes usando la hora UTC.

Sintaxis

objeto.getUTCDate()

dat

Objeto de tipo Date del que queremos obtener el día del mes.

Devuelve el valor del día del mes de la fecha, utilizando la Hora Universal Coordinada (hora UTC).

Ejemplo

var dat = new Date();
var dia = dat.getUTCDay();

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.getUTCDay()

Devuelve el día de la semana usando la hora UTC.

Sintaxis

dat.getUTCDay()

dat

Objeto de tipo Date del que queremos obtener el día de la semana.

Devuelve el día de la semana de la fecha utilizando la Hora Universal Coordinada (hora UTC), siendo 0 el domingo, 1 lunes, 2 martes, 3 miércoles, 4 jueves, 5 viernes y 6 el sábado.

Ejemplo

var dat = new Date();
var diasemana = dat.getUTCDay();

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.getUTCFullYear()

Devuelve el valor del año usando la hora UTC.

Sintaxis

dat.getUTCFullYear()

dat

Objeto de tipo Date del que queremos obtener el año.

Devuelve el valor del año de la fecha, utilizando la Hora Universal Coordinada (hora UTC).

Ejemplo

var dat = new Date();
var mes = dat.getUTCFullYear();

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.getUTCHours()

Devuelve el valor de las horas usando la hora UTC.

Sintaxis

dat.getUTCHours()

dat

Objeto de tipo Date del que queremos obtener la hora.

Devuelve el valor correspondiente a las horas de la fecha y hora, utilizando la Hora Universal Coordinada (hora UTC).

Ejemplo

var dat = new Date();
var hora = dat.getUTCHours();

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.getUTCMilliseconds()

Devuelve el valor de los milisegundos usando la hora UTC.

Sintaxis

dat.getUTCMilliseconds()

dat

Objeto de tipo Date del que queremos obtener los milisegundos.

Devuelve el valor de los milisegundos de la fecha y hora, utilizando la Hora Universal Coordinada (hora UTC).

Ejemplo

var dat = new Date();
var ms = dat.getUTCMilliseconds();

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.getUTCMinutes()

Devuelve el valor de los minutos usando la hora UTC.

Sintaxis

dat.getUTCMinutes()

dat

Objeto de tipo Date del que queremos obtener los minutos.

Devuelve el valor de los minutos de la fecha y hora, utilizando la Hora Universal Coordinada (hora UTC).

Ejemplo

var dat = new Date();
var minutos = dat.getUTCMinutes();

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.getUTCMonth()

Devuelve el valor del mes usando la hora UTC.

Sintaxis

dat.getUTCMonth()

dat

Objeto de tipo Date del que queremos obtener el mes.

Devuelve el valor del mes de esa fecha, utilizando la Hora Universal Coordinada (hora UTC), empezando en 0 (enero) hasta 11 (diciembre).

Ejemplo

var dat = new Date();
var mes = dat.getUTCMoth();

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.getUTCSeconds()

Devuelve el valor de los segundos usando la hora UTC.

Sintaxis

dat.getUTCSecods()

dat

Objeto de tipo Date del que queremos obtener los segundos.

Devuelve el valor de los segundos de la fecha y hora, utilizando la Hora Universal Coordinada (hora UTC).

Ejemplo

var dat = new Date();
var segundos = dat.getUTCSeconds();

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.getYear()

Devuelve el valor de año (obsoleto).

Sintaxis

dat.getYear()

dat

Objeto de tipo Date del que queremos obtener el año.

Devuelve el valor del año de la fecha, utilizando la diferencia horaria local.

El método getYear() está obsoleto, ya que devuelve los años desde 1900 y, por ejemplo, para el año 2013 devolvería un valor 113. Se debe utilizar getFullYear() para obtener el valor del año de una fecha.

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.setDate()

Establece el valor del día del mes usando la hora local.

Sintaxis

objeto.setDate(dia)

dat

Objeto de tipo Date del que queremos obtener el día del mes.

dia

Nuevo día del mes de la fecha. Si es superior a los días del mes, se modificará el valor del mes e incluso del año, si fuera necesario. Si es un valor negativo se reduce la fecha con el numero de días con el valor indicado.

Establece el valor del día del mes de la fecha, utilizando la diferencia horaria local.

Ejemplo

var dat = new Date();
dat.setDay(1);

Las características de este miembro (tal y como la describe la función Object.setOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.setFullYear()

Establece el valor del año usando la hora local.

Sintaxis

dat.setFullYear(año[, mes[, dia])

dat

Objeto de tipo Date del que queremos establecer el año.

año

Año de la fecha.

mes

Opcional. Mes de la fecha, empezando por 0 (enero) y terminando en 11 (diciembre).

dia

Opciona. Día de la fecha.

Establece el valor del año de la fecha, utilizando la diferencia horaria local. Si algunos de los valores pasados como argumento es mayor que el intervalo del calendario o es negativo, se ajustará la fecha o se retrocederá según corresponda.

Ejemplo

var dat = new Date(0);
dat.setFullYear(2000, 0, 1);

Las características de este miembro (tal y como la describe la función Object.setOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.setHours()

Establece el valor de las horas usando la hora local.

Sintaxis

dat.setHours(horas[, minutos[, segundos[, milisegundos]]]) )

dat

Objeto de tipo Date del que queremos establecer la hora.

Establece el valor correspondiente a las horas de la fecha y hora, utilizando la diferencia horaria local.

horas

Nuevo número de las horas.

minutos

Opcional. Valor de los minutos.

segundos

Opcional. Valor de los segundos.

milisegundos

Opcional. Valor de los milisegundos.

Establece el valor del las horas, utilizando la diferencia horaria local. Si algunos de los valores pasados como argumento es mayor que el intervalo del calendario o es negativo, se ajustará la fecha o se retrocederá según corresponda.

Ejemplo

var dat = new Date();
dat.setHours(12,0,0);

Las características de este miembro (tal y como la describe la función Object.setOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.setMilliseconds()

Establece el valor de los milisegundos usando la hora local.

Sintaxis

dat.setMilliseconds(milisegundos)

dat

Objeto de tipo Date del que queremos establecer los milisegundos.

milisegundos

Valor de los milisegundos.

Establece el valor del los milisegundos, utilizando la diferencia horaria local. Si el valor supera 999 se modificará el valor de los segundos. Si es un número negativo se reducirá el número de milisegundos en la cantidad indicada.

Establece el valor de los milisegundos de la fecha y hora, utilizando la diferencia horaria local.

Ejemplo

var dat = new Date();
setMilliseconds(500);

Las características de este miembro (tal y como la describe la función Object.setOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.setMinutes()

Establece el valor de los minutos usando la hora local.

Sintaxis

dat.setMinutes(minutos)

dat

Objeto de tipo Date del que queremos establecer los minutos.

minutos

Valor de los minutos.

Establece el valor de los minutos de la fecha y hora, utilizando la diferencia horaria local. Si el valor supera 59 se modificará el valor de las horas. Si es un número negativo se reducirá el número de minutos en la cantidad indicada.

Ejemplo

var dat = new Date();
dat.setMinutes(30);

Las características de este miembro (tal y como la describe la función Object.setOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.setMonth()

Establece el valor del mes usando la hora local.

Sintaxis

dat.setMonth(mes)

dat

Objeto de tipo Date del que queremos establecer el mes.

mes

Mes de la fecha, empezando por 0 (enero) y terminando en 11 (diciembre).

Establece el valor del mes de esa fecha, utilizando la diferencia horaria local, empezando en 0 (enero) hasta 11 (diciembre). Si el valor supera 11 se modificará el valor de los años. Si es un número negativo se reducirá el número del mes en la cantidad indicada.

Ejemplo

var dat = new Date();
dat.setMoth(0);

Las características de este miembro (tal y como la describe la función Object.setOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.setSeconds()

Establece el valor de los segundos usando la hora local.

Sintaxis

dat.setSecods(segundos)

dat

Objeto de tipo Date del que queremos establecer los segundos.

segundos

Valor de los segundos.

Establece el valor de los segundos de la fecha y hora, utilizando la diferencia horaria local. Si el valor supera 59 se modificará el valor de los minutos. Si es un número negativo se reducirá el número de segundos en la cantidad indicada.

Ejemplo

var dat = new Date();
dat.setSeconds(10);

Las características de este miembro (tal y como la describe la función Object.setOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.setTime()

Establece el valor de fecha y hora en el objeto Date.

Sintaxis

dat.setTime(numfecha)

dat

Objeto de tipo Date del que queremos establecer su valor por medio de una fecha en valor numérico.

numfecha

Valor numérico de una fecha que corresponde al valor en milisegundos desde la medianoche del 1 de enero de 1970. Si es un valor positivo es una fecha posterior y si es un valor negativo será una fecha anterior al 1 de enero de 1970.

Establecer la fecha y la hora de forma independiente de la zona horaria.

Ejemplo

var dat = new Date();
var numfecha = dat.getTime();

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.setUTCDate()

Establece el valor del día del mes usando la hora UTC.

Sintaxis

objeto.setUTCDate(dia)

dat

Objeto de tipo Date del que queremos obtener el día del mes.

dia

Nuevo día del mes de la fecha. Si es superior a los días del mes, se modificará el valor del mes e incluso del año, si fuera necesario. Si es un valor negativo se reduce la fecha con el numero de días con el valor indicado.

Establece el valor del día del mes de la fechautilizando la Hora Universal Coordinada (hora UTC).

Ejemplo

var dat = new Date();
dat.setUTCDay(1);

Las características de este miembro (tal y como la describe la función Object.setOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.setUTCFullYear()

Establece el valor del año usando la hora UTC.

Sintaxis

dat.setUTCFullYear(año[, mes[, dia])

dat

Objeto de tipo Date del que queremos establecer el año.

año

Año de la fecha.

mes

Opcional. Mes de la fecha, empezando por 0 (enero) y terminando en 11 (diciembre).

dia

Opciona. Día de la fecha.

Establece el valor del año de la fecha, utilizando la Hora Universal Coordinada (hora UTC). Si algunos de los valores pasados como argumento es mayor que el intervalo del calendario o es negativo, se ajustará la fecha o se retrocederá según corresponda.

Ejemplo

var dat = new Date(0);
dat.setUTCFullYear(2000, 0, 1);

Las características de este miembro (tal y como la describe la función Object.setOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.setUTCHours()

Establece el valor de las horas usando la hora UTC.

Sintaxis

dat.setUTCHours(horas[, minutos[, segundos[, milisegundos]]]) )

dat

Objeto de tipo Date del que queremos establecer la hora.

Establece el valor correspondiente a las horas de la fecha y hora, utilizando la diferencia horaria local.

horas

Nuevo número de las horas.

minutos

Opcional. Valor de los minutos.

segundos

Opcional. Valor de los segundos.

milisegundos

Opcional. Valor de los milisegundos.

Establece el valor del las horas, utilizando la Hora Universal Coordinada (hora UTC). Si algunos de los valores pasados como argumento es mayor que el intervalo del calendario o es negativo, se ajustará la fecha o se retrocederá según corresponda.

Ejemplo

var dat = new Date();
dat.setUTCHours(12,0,0);

Las características de este miembro (tal y como la describe la función Object.setOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.setUTCMilliseconds()

Establece el valor de los milisegundos usando la hora UTC.

Sintaxis

dat.setUTCMilliseconds(milisegundos)

dat

Objeto de tipo Date del que queremos establecer los milisegundos.

milisegundos

Valor de los milisegundos.

Establece el valor del los milisegundos, utilizando la Hora Universal Coordinada (hora UTC). Si el valor supera 999 se modificará el valor de los segundos. Si es un número negativo se reducirá el número de milisegundos en la cantidad indicada.

Establece el valor de los milisegundos de la fecha y hora, utilizando la diferencia horaria local.

Ejemplo

var dat = new Date();
setUTCMilliseconds(500);

Las características de este miembro (tal y como la describe la función Object.setOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.setUTCMinutes()

Establece el valor de los minutos usando la hora UTC.

Sintaxis

dat.setUTCMinutes(minutos)

dat

Objeto de tipo Date del que queremos establecer los minutos.

minutos

Valor de los minutos.

Establece el valor de los minutos de la fecha y hora, utilizando la la Hora Universal Coordinada (hora UTC). Si el valor supera 59 se modificará el valor de las horas. Si es un número negativo se reducirá el número de minutos en la cantidad indicada.

Ejemplo

var dat = new Date();
dat.setUTCMinutes(30);

Las características de este miembro (tal y como la describe la función Object.setOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.setUTCMonth()

Establece el valor del mes usando la hora UTC.

Sintaxis

dat.setUTCMonth(mes)

dat

Objeto de tipo Date del que queremos establecer el mes.

mes

Mes de la fecha, empezando por 0 (enero) y terminando en 11 (diciembre).

Establece el valor del mes de esa fecha, utilizando la diferencia horaria local, empezando en 0 (enero) hasta 11 (diciembre). Si el valor supera 11 se modificará el valor de los años. Si es un número negativo se reducirá el número del mes en la cantidad indicada.

Ejemplo

var dat = new Date();
dat.setUTCMoth(0);

Las características de este miembro (tal y como la describe la función Object.setOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.setUTCSeconds()

Establece el valor de los segundos usando la hora UTC.

Sintaxis

dat.setUTCSecods(segundos)

dat

Objeto de tipo Date del que queremos establecer los segundos.

segundos

Valor de los segundos.

Establece el valor de los segundos de la fecha y hora, utilizando la Hora Universal Coordinada (hora UTC). Si el valor supera 59 se modificará el valor de los minutos. Si es un número negativo se reducirá el número de segundos en la cantidad indicada.

Ejemplo

var dat = new Date();
dat.setUTCSeconds(10);

Las características de este miembro (tal y como la describe la función Object.setOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.setYear()

Establece el valor de año usando la hora local.

Sintaxis

dat.setYear(años)

dat

Objeto de tipo Date del que queremos obtener el año.

años

Número de años desde 1900.

Establece el valor del año de la fecha, utilizando la diferencia horaria local.

El método setYear() está obsoleto, ya que trabaja con los años desde 1900 y, por ejemplo, para el año 2013 sería necesario pasar un valor de 113. Se debe utilizar setFullYear() para obtener el valor del año de una fecha.

Las características de este miembro (tal y como la describe la función Object.getOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.toDateString()

Devuelve una fecha como un valor alfanumérico.

Sintaxis

dat.toDateString()

dat

Objeto de tipo Date del que queremos obtener la representación de cadena.

Devuelve una cadena con la fecha del objeto Date, utilizando la diferencia horaria local. El formato concreto depende de la implementación de Javascript.

Ejemplo

var dat = new Date();
console.log(dat.toDateString());

Las características de este miembro (tal y como la describe la función Object.setOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.toGMTString()

Devuelve una fecha convertida en cadena utilizando la hora media de Greenwich (GMT).

Sintaxis

dat.toGMTString()

dat

Objeto de tipo Date del que queremos obtener la representación de cadena.

Este método es obsoleto, se debe utilizar toUTCString().

Las características de este miembro (tal y como la describe la función Object.setOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262

dat.toISOString()

Devuelve una fecha como un valor alfanumérico en formato ISO.

Sintaxis

dat.toISOString()

dat

Objeto de tipo Date del que queremos obtener la representación de cadena.

Devuelve una cadena con la fecha del objeto Date, utilizando la diferencia horaria local, con formato ISO. Se puede consultar este formato en la referencia de Date.parse().

Ejemplo

var dat = new Date();
console.log(dat.toISOString());

Las características de este miembro (tal y como la describe la función Object.setOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262 Edición 5

dat.toJSON()

Se utiliza para transformar datos de un tipo de objeto antes de la serialización JSON.

Sintaxis

dat.toJSON()

dat

Objeto de tipo Date del que queremos obtener la representación de cadena.

Devuelve una cadena con la fecha del objeto Date, utilizando la Hora Universal Coordinada (hora UTC), con formato ISO. Se puede consultar este formato en la referencia de Date.parse().

Este método es llamado por JSON.stringify() para convertir objetos tipo fecha a cadenas JSON, por lo que si se reescribe se está modificando también a este otro método.

Ejemplo

var dat = new Date();
console.log(dat.toJSON());

Las características de este miembro (tal y como la describe la función Object.setOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262 Edición 5

dat.toLocaleDateString()

Devuelve una fecha como un valor alfanumérico apropiado para la configuración regional actual del entorno host.

Sintaxis

dat.toLocaleDateString()

dat

Objeto de tipo Date del que queremos obtener la representación de cadena.

Devuelve una cadena con la fecha del objeto Date, utilizando la diferencia horaria local. El formato concreto depende de la implementación de Javascript y se ajustará a la configuración de la máquina local.

Ejemplo

var dat = new Date();
console.log(dat.toLocaleDateString());

Las características de este miembro (tal y como la describe la función Object.setOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262 Edición 3

dat.toLocaleTimeString()

Devuelve una hora como un valor alfanumérico apropiado para la configuración regional actual del entorno host.

Sintaxis

dat.toLocaleTimeString()

dat

Objeto de tipo Date del que queremos obtener la representación de cadena.

Devuelve una cadena con la hora del objeto Date, utilizando la diferencia horaria local. El formato concreto depende de la implementación de Javascript y se ajustará a la configuración de la máquina local.

Ejemplo

var dat = new Date();
console.log(dat.toLocaleTimeString());

Las características de este miembro (tal y como la describe la función Object.setOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262 Edición 3

dat.toTimeString()

Devuelve una hora como un valor alfanumérico.

Sintaxis

objeto.toTimeString()

dat

Objeto de tipo Date del que queremos obtener la representación de cadena.

Devuelve una cadena con la hora del objeto Date, utilizando la diferencia horaria local. El formato concreto depende de la implementación de Javascript.

Ejemplo

var dat = new Date();
console.log(dat.toTimeString());

Las características de este miembro (tal y como la describe la función Object.setOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262 Edición 3

dat.toUTCString()

Devuelve una fecha convertida en cadena usando la hora UTC.

Sintaxis

dat.toUTCString()

dat

Objeto de tipo Date del que queremos obtener la representación de cadena.

Devuelve una cadena con la fecha del objeto Date, utilizando la Hora Universal Coordinada (hora UTC). El formato concreto depende de la implementación de Javascript.

Ejemplo

var dat = new Date();
console.log(dat.toUTCString());

Las características de este miembro (tal y como la describe la función Object.setOwnPropertyDescriptor()) son:

{"writable": true, "enumerable": false, "configurable": true}
ECMA-262