Share via


Metodo UTC

Restituisce il numero di millisecondi che intercorrono tra la mezzanotte dell'1 gennaio 1970, data espressa in formato UTC o GMT, e la data specificata.

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

Argomenti

  • year
    Obbligatoria. La designazione completa dell'anno è necessaria per garantire che le date a cavallo di due secoli vengano restituite nel modo corretto. Se per year viene specificato un valore compreso tra 0 e 99, il valore dell'argomento year verrà interpretato come 1900 + year.

  • month
    Obbligatoria. Numero intero compreso tra 0 e 11, da gennaio a dicembre, che rappresenta il mese.

  • day
    Obbligatoria. Numero intero compreso tra 1 e 31 che rappresenta il giorno.

  • hours
    Facoltativo. Obbligatorio se viene specificato l'argomento minutes. Numero intero compreso tra 0 e 23, da mezzanotte alle 23, che rappresenta l'ora.

  • minutes
    Facoltativo. Obbligatorio se viene specificato l'argomento seconds. Numero intero compreso tra 0 e 59 che rappresenta i minuti.

  • seconds
    Facoltativo. Obbligatorio se viene specificato l'argomento milliseconds. Numero intero compreso tra 0 e 59 che rappresenta i secondi.

  • ms
    Facoltativo. Numero intero compreso tra 0 e 999 che rappresenta i millisecondi.

Note

Mediante il metodo UTC viene restituito il numero di millisecondi tra la mezzanotte dell'1 gennaio 1970 espressa in formato UTC e la data specificata. Il valore restituito può essere utilizzato nel metodo setTime e nel costruttore dell'oggetto Date. Se il valore di un argomento è maggiore del relativo intervallo o è un numero negativo, gli altri valori memorizzati verranno modificati di conseguenza. Se si specifica 150 secondi, ad esempio, il numero verrà convertito in due minuti e 30 secondi.

Il metodo UTC e il costruttore dell'oggetto Date che accetta una data si differenziano per il fatto che il metodo UTC presuppone il formato UTC e il costruttore dell'oggetto Date presuppone l'ora locale.

Il metodo UTC è un metodo statico. Non è quindi necessario creare un oggetto Date prima di poterlo utilizzare.

Esempio

Nell'esempio seguente viene illustrato l'utilizzo del metodo 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);
}

Requisiti

Versione 1

Si applica a:

Oggetto Date

Vedere anche

Riferimenti

Metodo setTime