Compartilhar via


Método de UTC

Retorna o número de milissegundos entre meia-noite, 1º de janeiro de 1970, Hora Universal Coordenada (UTC) (ou GMT) e a data fornecida.

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

Argumentos

  • year
    Obrigatório. A designação de ano completo é necessária para a precisão de século entre data. Se ano está entre 0 e 99 é usado, em seguida, ano é assumido como 1900 + ano.

  • mês
    Obrigatório. O mês como um número inteiro entre 0 e 11 (janeiro a dezembro).

  • day
    Obrigatório. A data como um número inteiro entre 1 e 31.

  • hours
    Opcional. Deve ser fornecido se minutos for fornecida. Um inteiro de 0 a 23 (meia-noite às 11 horas) que especifica a hora.

  • minutos
    Opcional. Deve ser fornecido se segundos for fornecida. Um inteiro de 0 a 59 que especifica os minutos.

  • segundos
    Opcional. Deve ser fornecido se milissegundos for fornecida. Um inteiro de 0 a 59 que especifica os segundos.

  • ms
    Opcional. Um inteiro de 0 a 999 que especifica o tipo de milissegundos.

Comentários

O UTC método retorna o número de milissegundos entre meia-noite, 1º de janeiro de 1970 UTC e a data fornecida. O valor de retorno pode ser usado na setTime método e na Date construtor do objeto. Se o valor de um argumento é maior do que o seu intervalo ou é um número negativo, outros valores armazenados são modificados de acordo. Por exemplo, se você especificar 150 segundos, o JScript redefine esse número como dois minutos e 30 segundos.

A diferença entre a UTC método e o Date Construtor de objeto que aceite uma data é que o UTC método pressupõe UTC e o Date supõe que o construtor do objeto hora local.

O UTC método é um método estático. Portanto, um Date objeto não precisa ser criada antes que ele pode ser usado.

Exemplo

O exemplo a seguir ilustra o uso de UTC método.

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

Versão 1

Se aplica A:

Objeto Date

Consulte também

Referência

Método de setTime