UTC (Método)

Artículo
10/07/2008

Actualización: noviembre 2007

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

function UTC(year : Number , month : Number , day : Number [, hours : Number [, minutes : Number [, seconds : Number [,ms : Number]]]]) : Number

Argumentos

year
Necesario. Es necesario el formato de año con cuatro dígitos para la precisión de las fechas de cambio de siglo. Si se utiliza un valor de year comprendido entre 0 y 99, se supone que el auténtico valor es 1900 + year.
month
Necesario. Mes como un entero comprendido entre 0 y 11 (de enero a diciembre).
day
Necesario. 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

El método 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 utilizar en el método setTime y en el constructor del objeto Date. 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.

La diferencia entre el método UTC y el constructor del objeto Date que acepta una fecha es que el primero supone la hora universal coordinada y el segundo supone la hora local.

El método UTC es un método estático. Por tanto, para poderse utilizar, no es necesario crear previamente un objeto Date.

Nota:
Si el valor de year está comprendido entre 0 y 99, utilice 1900 + year para el año.

Ejemplo

En el siguiente ejemplo se muestra el uso del método UTC.

function DaysBetweenDateAndNow(yr, mo, dy){
   var d, r, t1, t2, t3;            //Declare variables.
   var MinMilli = 1000 * 60         //Initialize variables.
   var HrMilli = MinMilli * 60
   var DyMilli = HrMilli * 24
   t1 = Date.UTC(yr, mo - 1, dy)    //Get milliseconds since 1/1/1970.
   d = new Date();                  //Create Date object.
   t2 = d.getTime();                //Get current time.
   if (t2 >= t1) 
      t3 = t2 - t1;
   else
      t3 = t1 - t2;
   r = Math.round(t3 / DyMilli);
   return(r);                       //Return difference.
}