Date-Objekt

Aktualisiert: November 2007

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. Bei einem numerischen Wert stellt dateVal die Anzahl von Millisekunden in koordinierter Weltzeit (Coordinated Universal Time, UTC) zwischen dem angegebenem Datum und Mitternacht des 1. Januar 1970 dar. Bei einer Zeichenfolge wird dateVal entsprechend den Regeln in der parse-Methode analysiert. Der dateVal kann auch ein .NET-Datenwert sein.

• year
  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 new-Operator aufgerufen wird, enthält das zurückgegebene Date-Objekt das aktuelle Datum, und zwar unabhängig davon, welche Argumente an den Konstruktor übergeben wurden.

Hinweis:

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.

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:

Today's date is: 1/26/1992

Eigenschaften und Methoden

Eigenschaften und Methoden des Date-Objekts

Anforderungen

Version 1

Siehe auch

Referenz

new-Operator

var-Anweisung