Date-Objekt

Artikel
08/10/2011

Ein Objekt, das das grundlegende Speichern und Abrufen von Datums- und Zeitangaben ermöglicht. Der Date-Konstruktor liegt in zwei Formen vor.

function Date( [dateVal : { Number | String | System.DateTime } ] )
function Date( year : int, month : int, date : int[, hours : int [, minutes : int [, seconds : int [, ms : int]]]] )

Argumente

dateVal
Optional. Als numerischer Wert gibt dateVal die Anzahl der Millisekunden zwischen Mitternacht des 1. Januar 1970 UTC (Universal Coordinated Time, koordinierte Weltzeit) und dem angegebenen Datum an. Bei einer Zeichenfolge wird dateVal nach den Regeln in der parse-Methode analysiert. Der dateVal kann auch ein .NET-Datenwert sein.
Jahr
Erforderlich. Das vollständige Jahr, z. B. 1976 (nicht 76).
month
Erforderlich. Der Monat als ganze Zahl zwischen 0 und 11 (Januar bis Dezember).
date
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

Ein Date-Objekt enthält eine Zahl, die einen bestimmten Zeitpunkt von bis zu einer Millisekunde darstellt. 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.

Ist die Zahl NaN, stellt das Objekt keinen bestimmten Zeitpunkt dar. Wenn Sie keine Parameter an den Date-Konstruktor übergeben, wird er mit der aktuellen Zeit (UTC) initialisiert. Sie müssen eine Variable vom Typ Date initialisieren, bevor Sie das Objekt verwenden können.

Der Bereich, der in einem Date-Objekt dargestellt werden kann, beträgt etwa 285.616 Jahre vor und nach dem 1. Januar 1970.

Zum Date-Objekt gehören zwei statische Methoden, parse und UTC, die aufgerufen werden, ohne ein Date-Objekt zu erstellen.

Wenn der Date-Konstruktor ohne den Operator new aufgerufen wird, enthält das zurückgegebene Date-Objekt das aktuelle Datum, und zwar unabhängig davon, welche Argumente an den Konstruktor übergeben wurden.

Tipp

Das Date-Objekt interagiert innerhalb von JScript mit dem System.DateTime-Datentyp von .NET Framework. Andere CLS (Common Language Specification-)Sprachen können das Date-Objekt jedoch nicht verwenden, da das Objekt nur von JScript bereitgestellt wird. Es ist nicht von einem .NET Framework-Typ abgeleitet. Achten Sie daher beim Ausstatten der Parameter und Rückgabetypen von CLS‑kompatiblen Methoden mit Typanmerkungen darauf, dass Sie den System.DateTime-Datentyp verwenden und nicht das Date-Objekt. Sie können das Date-Objekt jedoch verwenden, um andere Bezeichner als Parameter oder Rückgabetypen mit Typanmerkungen zu versehen. Weitere Informationen hierzu finden Sie unter Schreiben von CLS-kompatiblem Code.

Weitere Informationen zur Verwendung des Date-Objekts und verwandter Methoden finden Sie unter Datums- und Uhrzeitberechnungen.

Beispiel

Im folgenden Beispiel wird das Date-Objekt verwendet.

var s : String = "Today's date is: ";   // Declare variables.
var d : Date = new Date();              // Create Date object with today's date.
s += (d.getMonth() + 1) + "/";          // Get month
s += d.getDate() + "/";                 // Get day
s += d.getYear();                       // Get year.
print(s);                               // Print date.

Wäre dieses Programm am 26. Januar 1992 ausgeführt worden, hätte die Ausgabe folgendermaßen ausgesehen: