UTC-Methode
Aktualisiert: November 2007
Gibt die Anzahl der Millisekunden zwischen Mitternacht des 1. Januar 1970 UTC (Universal Coordinated Time, koordinierte Weltzeit) oder GMT und dem angegebenen Datum zurück.
function UTC(year : Number , month : Number , day : Number [, hours : Number [, minutes : Number [, seconds : Number [,ms : Number]]]]) : Number
Argumente
year
Erforderlich. Die vollständige Jahresangabe ist für die Genauigkeit bei jahrhundertübergreifenden Datumsangaben erforderlich. Wird für year ein Wert zwischen 0 und 99 verwendet, wird year als 1900 + year interpretiert.month
Erforderlich. Der Monat als ganze Zahl zwischen 0 und 11 (Januar bis Dezember).day
Erforderlich. Das Datum als ganze Zahl zwischen 1 und 31.hours
Optional. Muss angegeben werden, wenn minutes verwendet wird. Eine ganze Zahl zwischen 0 und 23 (Mitternacht bis 23 Uhr), die die Stunde angibt.minutes
Optional. Muss angegeben werden, wenn seconds verwendet wird. Eine ganze Zahl zwischen 0 und 59, die die Minuten angibt.seconds
Optional. Muss angegeben werden, wenn milliseconds verwendet wird. Eine ganze Zahl zwischen 0 und 59, die die Sekunden angibt.ms
Optional. Eine ganze Zahl zwischen 0 und 999, die die Millisekunden angibt.
Hinweise
Die UTC-Methode gibt die Anzahl der Millisekunden zwischen dem 1. Januar 1970, Mitternacht, und dem angegebenen Datum gemäß koordinierter Weltzeit (Universal Coordinated Time, UTC) zurück. Dieser Rückgabewert kann in der setTime-Methode und im Date-Objektkonstruktor verwendet werden. Ist der Wert eines Arguments größer als dessen Bereich bzw. eine negative Zahl, werden andere gespeicherte Werte entsprechend geändert. Wenn Sie z. B. 150 Sekunden angeben, macht JScript daraus 2 Minuten und 30 Sekunden.
Der Unterschied zwischen der UTC-Methode und dem Date-Objektkonstruktor, der ein Datum akzeptiert, liegt darin, dass die UTC-Methode von UTC und der Date-Objektkonstruktor von der Ortszeit ausgeht.
Bei der UTC-Methode handelt es sich um eine statische Methode. Ein Date-Objekt muss daher nicht vor der eigentlichen Verwendung erstellt werden.
Hinweis: |
---|
Liegt year zwischen 0 und 99, verwenden Sie für die Jahresangabe 1900 + year. |
Beispiel
Das folgende Beispiel veranschaulicht die Verwendung der UTC-Methode.
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.
}