Compartir a través de


UTC (Método)

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
    Obligatorio. 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 de year es 1900 +year.

  • month
    Obligatorio. Mes como un entero comprendido entre 0 y 11 (de enero a diciembre).

  • day
    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

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.

Ejemplo

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

function DaysBetweenDateAndNow(yr, mo, dy)
{
    // Determine the milliseconds per day.
    var MinMilli = 1000 * 60
    var HrMilli = MinMilli * 60
    var DyMilli = HrMilli * 24

    // Determine today's UTC year, month, and day.
    var d = new Date();
    var yeartoday = d.getUTCFullYear();
    var monthtoday = d.getUTCMonth();
    var dayofmonthtoday = d.getUTCDate();
    
    // Get the milliseconds since 1/1/1970 UTC.
    var t1 = Date.UTC(yr, mo - 1, dy)
    var t2 = Date.UTC(yeartoday, monthtoday, dayofmonthtoday);
   
    // Determine the difference in days.
    var days = (t1 - t2) / DyMilli;
   
    return(days);
}

Requisitos

Versión 1

Se aplica a:

Date (Objeto)

Vea también

Referencia

setTime (Método)