Condividi tramite


Metodo UTC

Aggiornamento: novembre 2007

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
    Obbligatorio. 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
    Obbligatorio. Numero intero compreso tra 0 e 11, da gennaio a dicembre, che rappresenta il mese.

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

Nota:

Se il valore di year è compreso tra 0 e 99, per l'anno specificare 1900 + year.

Esempio

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

Requisiti

Versione 1

Si applica a:

Oggetto Date

Vedere anche

Riferimenti

Metodo setTime