Share via


UTC-Methode

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

  • Jahr
    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.

Beispiel

Das folgende Beispiel veranschaulicht die Verwendung der UTC-Methode:

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);
}

Anforderungen

Version 1

Betrifft:

Date-Objekt

Siehe auch

Referenz

setTime-Methode