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.
}