Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Arbeiten mit Datum und Zeit
Wenn zweitens ein einzelner numerischer Parameter angegeben wird, wird dieser im Date()-Konstruktor als Anzahl
der Millisekunden seit dem 1. Januar 1970 interpretiert und ein entsprechendes Date-Objekt wird zurückgegeben.
Beachten Sie, dass der übergebene Wert als Millisekunden seit dem 1. Januar 1970 (UTC) interpretiert wird. Beim
Date-Objekt werden jedoch Werte in der entsprechenden Ortszeit angegeben, es sei denn, Sie verwenden UTCspezifische
Methoden, um die Werte abzurufen und anzuzeigen. Wenn Sie ein neues Date-Objekt mit einem einzelnen
milliseconds-Parameter erstellen, beachten Sie daher dabei den Zeitunterschied zwischen der Ortszeit und der
Weltzeit. Mit den folgenden Anweisungen wird ein Date-Objekt erstellt, das auf Mitternacht des 1. Januar 1970 (UTC)
gesetzt ist:
var millisecondsPerDay:int = 1000 * 60 * 60 * 24;
// gets a Date one day after the start date of 1/1/1970
var startTime:Date = new Date(millisecondsPerDay);
Sie können drittens mehrere numerische Parameter an den Date()-Konstruktor übergeben. Diese Parameter werden
jeweils als Jahr, Monat, Tag, Stunde, Minute, Sekunde und Millisekunde verarbeitet. Ein entsprechendes Date-Objekt
wird zurückgegeben. Bei diesen Eingabeparametern wird davon ausgegangen, dass sie in Ortszeit und nicht gemäß der
Weltzeit (UTC) angegeben werden. Mit den folgenden Anweisungen wird ein Date-Objekt erstellt, das auf
Mitternacht des 1. Januar 2000, Ortszeit gesetzt ist:
var millenium:Date = new Date(2000, 0, 1, 0, 0, 0, 0);
Sie können viertens einen einzelnen Stringparameter an den Date()-Konstruktor übergeben. Dieser String wird in
Datums- oder Zeitkomponenten geparst. Anschließend wird ein entsprechendes Date-Objekt zurückgegeben. Bei
dieser Vorgehensweise empfiehlt es sich, den Date()-Konstruktor in einen try..catch-Codeblock einzuschließen,
um eventuelle Parsingfehler abzufangen. Der Date()-Konstruktor akzeptiert verschiedene Stringformate (eine Liste
dieser Formate finden Sie im ActionScript 3.0-Referenzhandbuch für die Adobe Flash-Plattform). Mit der folgenden
Anweisung wird ein neues Date-Objekt mit einem Stringwert initialisiert:
var nextDay:Date = new Date("Mon May 1 2006 11:30:00 AM");
Wenn der Date()-Konstruktor den Stringparameter nicht erfolgreich analysieren kann, wird eine Ausnahme
ausgelöst. Das resultierende Date-Objekt enthält jedoch einen ungültigen Datumswert.
Abrufen von Werten für Zeiteinheiten
Flash Player 9 und höher, Adobe AIR 1.0 und höher
Sie können die Werte verschiedener Zeiteinheiten in einem Date-Objekt mithilfe der Eigenschaften oder Methoden
der Date-Klasse abrufen. Mit jeder der folgenden Eigenschaften wird der Wert für eine bestimmte Zeiteinheit im Date-
Objekt abgerufen:
fullYear-Eigenschaft
month-Eigenschaft (im numerischen Format von 0 für Januar bis 11 für Dezember)
date-Eigenschaft (mit dem numerischen Kalendertag im Monat, im Bereich von 1 bis 31)
day-Eigenschaft (der Wochentag im numerischen Format, mit dem Wert 0 für Sonntag)
hours-Eigenschaft (im Bereich von 0 bis 23)
minutes-Eigenschaft
seconds-Eigenschaft
milliseconds-Eigenschaft
Über die Date-Klasse stehen zahlreiche Möglichkeiten zur Verfügung, um jeden dieser Werte abzurufen. Sie
können den Wert für den Monat eines Date-Objekts beispielsweise auf vier verschiedene Weisen abrufen:
Letzte Aktualisierung 27.6.2012
2