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

Anforderungen

Version 1

Betrifft:

Date-Objekt

Siehe auch

Referenz

setTime-Methode