| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Die Date-Klasse repräsentiert Datums- und Zeitinformationen. Eine Instanz der Date-Klasse repräsentiert einen bestimmten Zeitpunkt, für den Eigenschaften wie month, day, hours und seconds abgefragt oder geändert werden können. Mit der Date-Klasse können Sie Datums- und Zeitwerte relativ zur Weltzeit (GMT, heute als Koordinierte Weltzeit, UTC bezeichnet) oder relativ zur Ortszeit, die von der Einstellung für die aktuelle Zeitzone des Betriebssystems bestimmt wird, auf dem Flash Player ausgeführt wird. Die Methoden der Date-Klasse sind nicht statisch, sondern gelten nur für das jeweilige Date-Objekt, das beim Aufruf der Methode angegeben wird. Die Methoden
Date.UTC() und
Date.parse() sind Ausnahmen; es handelt sich um statische Methoden.
Wie die Sommerzeit von der Date-Klasse behandelt wird, hängt vom Betriebssystem und der Flash Player-Version ab. Flash Player behandelt ab Version 6 die Sommerzeit auf den folgenden Betriebssystemen auf folgende Art:
- Windows: Das Date-Objekt passt seine Ausgabe automatisch an die Sommerzeit an. Das Date-Objekt ermittelt, ob für das aktuelle Gebietsschema Sommerzeit Gültigkeit hat, und wenn ja, wann die Umstellung auf Sommer- bzw. Winterzeit erfolgt. Die derzeit verwendeten Umstellungstermine werden jedoch auch auf Datumswerte in der Vergangenheit und Zukunft angewendet, sodass bei in der Vergangenheit liegenden Datumswerten, zu denen für das Gebietsschema andere Umstellungstermine galten, der Sommerzeitausgleich u. U. falsch berechnet wird.
- Mac OS X: Das Date-Objekt passt seine Ausgabe automatisch an die Sommerzeit an. Anhand der Zeitzonendatenbank in Mac OSX wird ermittelt, ob für in der Gegenwart oder Vergangenheit liegende Datums- oder Uhrzeitwerte ein Sommerzeitausgleich erfolgen soll.
- Mac OS 9: Das Betriebssystem stellt nur Informationen bereit, anhand derer ermittelt werden kann, ob auf das aktuelle Datum und die aktuelle Uhrzeit ein Sommerzeitausgleich angewendet werden soll. Demzufolge geht das Date-Objekt davon aus, dass der aktuelle Sommerzeitausgleich für alle vergangenen und künftigen Datums- und Uhrzeitwerte gilt.
Flash Player 5 behandelt die Sommerzeit auf den verschiedenen Betriebssystemen wie folgt:
- Windows: Die US-Sommerzeitregeln finden immer Anwendung, was u. U. zu falschen Umstellungsterminen in Europa und anderen Regionen mit Sommerzeit führt. Ob im aktuellen Gebietsschema Sommerzeit verwendet wird, wird von Flash korrekt erkannt.
Um die Date-Klasse zu verwenden, erstellen Sie mithilfe des Operators new eine Date-Instanz.
ActionScript 3.0 stellt mehrere neue accessor-Eigenschaften bereit, die anstelle der vielen Methoden der Date-Klasse verwendet werden können, die auf Date-Instanzen zugreifen oder sie verändern. ActionScript 3.0 umfasst auch folgende neue Variationen der Methode toString(), die zum ECMA-262-Standard, 3. Auflage gehören: Date.toLocaleString(), Date.toTimeString(), Date.toLocaleTimeString(), Date.toDateString() und Date.toLocaleDateString().
Wie Sie die relative oder verstrichene Zeit berechnen, erfahren Sie im Abschnitt über die Methode getTimer() im flash.utils-Paket.
Beispiele anzeigen
date:Number [read-write]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Der von einem Date-Objekt gemäß der Ortszeit angegebenen Tag des Monats (eine Ganzzahl von 1 bis 31). Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem der Flash Player ausgeführt wird.
Implementierung
AS3 function get date():Number
AS3 function set date(value:Number):void
Siehe auch
dateUTC:Number [read-write]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt den Tag des Monats (eine Ganzzahl von 1 bis 31) eines Date-Objekts gemäß der Weltzeit (UTC) zurück.
Implementierung
AS3 function get dateUTC():Number
AS3 function set dateUTC(value:Number):void
Siehe auch
day:Number [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Der von dem Date-Objekt gemäß der Ortszeit angegebenen Wochentag (0 für Sonntag, 1 für Montag usw.). Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem der Flash Player ausgeführt wird.
Implementierung
AS3 function get day():Number
Siehe auch
dayUTC:Number [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Der Wochentag (0 für Sonntag, 1 für Montag usw.) dieses Date-Objekts gemäß Weltzeit (UTC).
Implementierung
AS3 function get dayUTC():Number
Siehe auch
fullYear:Number [read-write]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Die vollständige Jahreszahl (eine vierstellige Zahl, z. B. 2000) eines Date-Objekts gemäß der Ortszeit. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem der Flash Player ausgeführt wird.
Implementierung
AS3 function get fullYear():Number
AS3 function set fullYear(value:Number):void
Siehe auch
fullYearUTC:Number [read-write]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Die vierstellige Jahreszahl des Date-Objekts gemäß Weltzeit (UTC).
Implementierung
AS3 function get fullYearUTC():Number
AS3 function set fullYearUTC(value:Number):void
Siehe auch
hours:Number [read-write]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Die Stunde (eine Ganzzahl von 0 bis 23) des day-Teils eines Date-Objekts gemäß der Ortszeit. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem der Flash Player ausgeführt wird.
Implementierung
AS3 function get hours():Number
AS3 function set hours(value:Number):void
Siehe auch
hoursUTC:Number [read-write]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Die Stunde (eine Ganzzahl von 0 bis 23) des Date-Objekts gemäß der Weltzeit (UTC).
Implementierung
AS3 function get hoursUTC():Number
AS3 function set hoursUTC(value:Number):void
Siehe auch
milliseconds:Number [read-write]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Der milliseconds-Teil (eine Ganzzahl von 0 bis 999) des Date-Objekts gemäß der Ortszeit. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem der Flash Player ausgeführt wird.
Implementierung
AS3 function get milliseconds():Number
AS3 function set milliseconds(value:Number):void
Siehe auch
millisecondsUTC:Number [read-write]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Der milliseconds-Teil (eine Ganzzahl von 0 bis 999) eines Date-Objekts gemäß Weltzeit (UTC).
Implementierung
AS3 function get millisecondsUTC():Number
AS3 function set millisecondsUTC(value:Number):void
Siehe auch
minutes:Number [read-write]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Der minutes-Teil (eine Ganzzahl von 0 bis 59) des Date-Objekts gemäß der Ortszeit. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem der Flash Player ausgeführt wird.
Implementierung
AS3 function get minutes():Number
AS3 function set minutes(value:Number):void
Siehe auch
minutesUTC:Number [read-write]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Der minutes-Teil (eine Ganzzahl von 0 bis 59) eines Date-Objekts gemäß Weltzeit (UTC).
Implementierung
AS3 function get minutesUTC():Number
AS3 function set minutesUTC(value:Number):void
Siehe auch
month:Number [read-write]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Der month-Teil (0 für Januar, 1 für Februar usw.) dieses Date-Objekts gemäß der Ortszeit. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem der Flash Player ausgeführt wird.
Implementierung
AS3 function get month():Number
AS3 function set month(value:Number):void
Siehe auch
monthUTC:Number [read-write]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt den month-Teil (von 0 für Januar bis 11 für Dezember) eines Date-Objekts gemäß der Weltzeit (UTC) zurück.
Implementierung
AS3 function get monthUTC():Number
AS3 function set monthUTC(value:Number):void
Siehe auch
seconds:Number [read-write]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Der seconds-Teil (eine Ganzzahl von 0 bis 59) des Date-Objekts gemäß der Ortszeit. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem der Flash Player ausgeführt wird.
Implementierung
AS3 function get seconds():Number
AS3 function set seconds(value:Number):void
Siehe auch
secondsUTC:Number [read-write]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Der seconds-Teil (eine Ganzzahl von 0 bis 59) eines Date-Objekts gemäß Weltzeit (UTC).
Implementierung
AS3 function get secondsUTC():Number
AS3 function set secondsUTC(value:Number):void
Siehe auch
time:Number [read-write]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Die Anzahl der Millisekunden Gibt seit dem 1. Januar 1970, 0.00 Uhr, Weltzeit (UTC) für ein Date-Objekt. Mit dieser Methode können Sie beim Vergleich von mindestens zwei Date-Objekten einen bestimmten Zeitpunkt angeben.
Implementierung
AS3 function get time():Number
AS3 function set time(value:Number):void
Siehe auch
timezoneOffset:Number [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt die Differenz zwischen der Weltzeit (UTC) und der Ortszeit des Computers in Minuten zurück. Dieser Wert gibt die Anzahl von Minuten an, die Sie zur Ortszeit des Computers hinzufügen müssen, damit sie gleich der Weltzeit ist. Ist die Ortszeit des Computers später als die Weltzeit, wird ein negativer Wert zurückgegeben.
Implementierung
AS3 function get timezoneOffset():Number
Siehe auch
public function Date(yearOrTimevalue:Object, month:Number, date:Number = 1, hour:Number = 0, minute:Number = 0, second:Number = 0, millisecond:Number = 0)
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Erstellt ein neues Date-Objekt mit dem angegebenen Datum und der angegebenen Uhrzeit.
Dem Date()-Konstruktor können bis zu sieben Parameter (year, month, ..., millisecond) übergeben werden, um ein Datum und die Uhrzeit bis hin zu den Millisekunden anzugeben. Das Datum, das das neu erstellte Date-Objekt enthält, hängt von der übergebenen Zahl, dem Datentyp und den Argumenten ab.
- Wenn Sie keine Argumente übergeben, werden dem Date-Objekt das aktuelle Datum und die aktuelle Uhrzeit zugewiesen.
- Wenn Sie ein Argument des Datentyps Number übergeben, wird dem Date-Objekt ein Zeitwert zugewiesen, der der Anzahl an Millisekunden entspricht, die seit dem 1. Januar 1970 0:00:000 GMT verstrichen sind, wie es im lone-Argument angegeben ist.
- Wenn Sie ein Argument des Datentyps String übergeben, enthält der String ein gültiges Datum und das Date-Objekt enthält einen auf diesem Datum basierenden Zeitwert.
- Wenn Sie zwei oder mehrere Argumente übergeben, wird dem Date-Objekt ein Zeitwert zugewiesen, der auf den übergebenen Argumentwerten basiert, die das Jahr, den Monat, den Tag, die Stunde, die Minute, die Sekunde und die Millisekunde des Datums repräsentieren.
Wenn Sie an den Date-Klassenkonstruktor einen String übergeben, kann das Datum eine Vielzahl von Formaten annehmen, muss aber mindestens, den Monat, den Tag und das Jahr enthalten. So wäre Feb 1 2005 beispielsweise ein zulässiger Datumswert, Feb 2005 aber nicht. Die folgende Liste zeigt einige zulässige Formate auf:
- Wochentag Monat Tag Stunde:Minute:Sekunde GMT Jahr (z. B. "Di Feb 1 00:00:00 GMT-0800 2005", was dem
toString()-Format entspricht)
- Wochentag Monat Tag Jahr Stunde:Minute:Sekunde AM/PM (z. B. "Di Feb 1 2005 12:00:00 AM", was dem
toLocaleString()-Format entspricht)
- Wochentag Monat Tag Jahr (z. B. "Di Feb 1 2005", was dem
toDateString()-Format entspricht)
- Monat/Tag/Jahr (z. B. "02/01/2005")
Parameter
| yearOrTimevalue:Object — Wenn andere Parameter angegeben werden, stellt diese Zahl das Jahr (z. B. 1965), andernfalls einen Zeitwert dar. Wenn es sich um eine Jahresangabe handelt, steht ein Wert von 0 bis 99 für eine Jahreszahl zwischen 1900 und 1999, andernfalls müssen alle vier Ziffern der Jahreszahl angegeben werden. Stellt diese Zahl dagegen einen Zeitwert dar (ohne die Angabe anderer Parameter), so ist die Anzahl der Millisekunden vor bzw. nach dem 1. Januar 1970, 0.00 Uhr GMT gemeint. Ein negativer Wert bezieht sich auf die Zeit vor dem 1. Januar 1970, 0.00 Uhr GMT, ein positiver Wert auf eine Zeit danach.
|
| |
| month:Number — Eine Ganzzahl von 0 (Januar) bis 11 (Dezember).
|
| |
| date:Number (default = 1) — Eine Ganzzahl von 1 bis 31.
|
| |
| hour:Number (default = 0) — Eine Ganzzahl von 0 (Mitternacht) bis 23 (23.00 Uhr).
|
| |
| minute:Number (default = 0) — Eine Ganzzahl von 0 bis 59.
|
| |
| second:Number (default = 0) — Eine Ganzzahl von 0 bis 59.
|
| |
| millisecond:Number (default = 0) — Eine Ganzzahl von 0 bis 999 Millisekunden.
|
Siehe auch
AS3 function getDate():Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt den von einem Date-Objekt gemäß der Ortszeit angegebenen Tag des Monats (eine Ganzzahl von 1 bis 31) zurück. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem der Flash Player ausgeführt wird.
Rückgabewerte
| Number — Der Tag des Monats (1 - 31), den ein Date-Objekt repräsentiert.
|
Siehe auch
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
someBirthday mit den Parametern
year (
1974),
month (
10 = November),
day (
30),
hour (
1) und
minute (
20) erstellt. Anschließend wird die
getDate()-Methode aufgerufen, die den Tag des Monats abruft.
package {
import flash.display.Sprite;
public class DateExample extends Sprite {
public function DateExample() {
var someBirthday:Date = new Date(1974, 10, 30, 1, 20);
trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974
trace(someBirthday.getDate()); // 30
}
}
}
AS3 function getDay():Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt den von dem Date-Objekt gemäß der Ortszeit angegebenen Wochentag zurück (0 für Sonntag, 1 für Montag usw.). Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem der Flash Player ausgeführt wird.
Rückgabewerte
| Number — Eine numerische Version des Tags der Woche (0 - 6), die ein Date-Objekt repräsentiert.
|
Beispiel
Bei folgendem Beispiel wird ein neues Array-Objekt
weekDayLabels mit den Elementen
[Sunday,Monday,Tuesday,Wednesday,Thursday,Friday,Saturday] und ein neues Date-Objekt
someBirthday mit den Parametern
year (
1974),
month (
10 = November),
day (
30),
hour (
1) und
minute (
20) erstellt. Anschließend wird die
getDay()-Methode zweimal aufgerufen. Daraufhin wird zuerst der Tag des Monats als 6 angezeigt und dann wird der Tag der Woche mithilfe von
weekDayLabels angezeigt.
var weekDayLabels:Array = new Array("Sunday",
"Monday",
"Tuesday",
"Wednesday",
"Thursday",
"Friday",
"Saturday");
var someBirthday:Date = new Date(1974, 10, 30, 1, 20);
trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974
trace(someBirthday.getDay()); // 6
trace(weekDayLabels[someBirthday.getDay()]); // Saturday
AS3 function getFullYear():Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt die vollständige Jahreszahl (eine vierstellige Zahl, z. B. 2000) eines Date-Objekts gemäß der Ortszeit zurück. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem der Flash Player ausgeführt wird.
Rückgabewerte
| Number — Die vollständige Jahreszahl, die ein Date-Objekt repräsentiert.
|
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
someBirthday mit den Parametern
year (
1974),
month (
10 = November),
day (
30),
hour (
1) und
minute (
20) erstellt. Anschließend wird die
getFullYear()-Methode aufgerufen, die die vierstellige Jahreszahl abruft.
var someBirthday:Date = new Date(1974, 10, 30, 1, 20);
trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974
trace(someBirthday.getFullYear()); // 1974
AS3 function getHours():Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt die Stunde (eine Ganzzahl von 0 bis 23) des day-Teils eines Date-Objekts gemäß der Ortszeit zurück. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem der Flash Player ausgeführt wird.
Rückgabewerte
| Number — Die Stunde des Tags (0 - 23), die ein Date-Objekt repräsentiert.
|
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
someBirthday mit den Parametern
year (
1974),
month (
10 = November),
day (
30),
hour (
1) und
minute (
20) erstellt. Anschließend werden die
getHours()- und
getMinutes()-Methoden aufgerufen, die die Stunden und Minuten im 24-Stunden-Format abrufen. Abschließend wird ein String (
localTime) erstellt und dem Ergebnis zugeordnet, das sich aus dem Aufruf der
getUSClockTime()-Funktion ergibt. Daraufhin werden erneut
getHours() und
getMinutes() aufgerufen und schließlich wird die Zeit ausgegeben:
03:05 PM.
var someBirthday:Date = new Date(1974, 10, 30, 15, 5);
trace(someBirthday); // Sat Nov 30 15:20:00 GMT-0800 1974
trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 15:5
var localTime:String = getUSClockTime(someBirthday.getHours(), someBirthday.getMinutes());
trace(localTime); // 03:05 PM
function getUSClockTime(hrs:uint, mins:uint):String {
var modifier:String = "PM";
var minLabel:String = doubleDigitFormat(mins);
if(hrs > 12) {
hrs = hrs-12;
} else if(hrs == 0) {
modifier = "AM";
hrs = 12;
} else if(hrs < 12) {
modifier = "AM";
}
return (doubleDigitFormat(hrs) + ":" + minLabel + " " + modifier);
}
function doubleDigitFormat(num:uint):String {
if(num < 10) {
return ("0" + num);
}
return num;
}
AS3 function getMilliseconds():Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt den milliseconds-Teil (eine Ganzzahl von 0 bis 999) des Date-Objekts gemäß der Ortszeit zurück. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem der Flash Player ausgeführt wird.
Rückgabewerte
| Number — Der milliseconds-Teil eines Date-Objekts.
|
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
now ohne Parameter erstellt. Anschließend wird die
getMilliseconds()-Methode aufgerufen, die die Millisekunden des Date-Objekts
now zum Zeitpunkt seiner Erstellung abruft.
var now:Date = new Date();
trace(now.getMilliseconds());
AS3 function getMinutes():Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt den minutes-Teil (eine Ganzzahl von 0 bis 59) des Date-Objekts gemäß der Ortszeit zurück. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem der Flash Player ausgeführt wird.
Rückgabewerte
| Number — Der minutes-Teil eines Date-Objekts.
|
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
now ohne Parameter erstellt. Anschließend wird die
getMinutes()-Methode aufgerufen, die die Minuten des Date-Objekts
now zum Zeitpunkt seiner Erstellung abruft.
var now:Date = new Date();
trace(now);
trace(now.getMinutes());
AS3 function getMonth():Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt den Monat (0 für Januar, 1 für Februar usw.) dieses Date-Objekts gemäß der Ortszeit zurück. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem der Flash Player ausgeführt wird.
Rückgabewerte
| Number — Der month-Teil (0 – 11) eines Date-Objekts.
|
Beispiel
Im folgenden Beispiel wird ein neues Array-Objekt
monthLabels, und zwar mit den Elementen
January bis
December und einem neuen Date-Objekt
now ohne Parameter erstellt. Anschließend wird die
getMonth()-Methode zweimal aufgerufen. Dadurch wird zuerst die Zahl des Monats und dann der Name des Monats, in dem das Date-Objekt
now erstellt wurde, zurückgegeben.
var monthLabels:Array = new Array("January",
"February",
"March",
"April",
"May",
"June",
"July",
"August",
"September",
"October",
"November",
"December");
var now:Date = new Date();
trace(now.getMonth());
trace(monthLabels[now.getMonth()]);
AS3 function getSeconds():Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt den seconds-Teil (eine Ganzzahl von 0 bis 59) des Date-Objekts gemäß der Ortszeit zurück. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem der Flash Player ausgeführt wird.
Rückgabewerte
| Number — Der seconds-Teil (0 – 59) eines Date-Objekts.
|
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
now ohne Parameter erstellt. Anschließend wird die
getSeconds()-Methode aufgerufen, die die Sekunden des Date-Objekts
now zum Zeitpunkt seiner Erstellung abruft.
var now:Date = new Date();
trace(now.getSeconds());
AS3 function getTime():Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt für ein Date-Objekt die Anzahl der Millisekunden zurück, die seit dem 1. Januar 1970, 0.00 Uhr, Weltzeit, vergangen sind. Mit dieser Methode können Sie beim Vergleich von mindestens zwei <Date-Objekten einen bestimmten Zeitpunkt angeben.
Hinweis: Bei der getTime()-Methode werden Schaltjahre berücksichtigt; Sie brauchen daher keine logischen Anweisungen für Schaltjahre zur Datumsarithmetik hinzuzufügen.
Rückgabewerte
| Number — Die Anzahl an Millisekunden, die zwischen dem 1. Januar 1970 und dem Datum, den das Date-Objekt repräsentiert, vergangen sind.
|
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
mlk mit den folgenden Parametern erstellt:
year (
1929),
month (
0 = January) und
day (
15). Anschließend wird die
getTime()-Methode aufgerufen, die die Millisekunden seit dem 1. Januar 1970, 0.00 Uhr, abruft. Hierbei handelt es sich um einen negativen Wert, da als Jahr 1929 festgelegt wurde.
var mlk:Date = new Date(1929, 0, 15);
trace(mlk); // Tue Jan 15 00:00:00 GMT-0800 1929
trace(mlk.getTime()); // -1292601600000
Im folgenden Beispiel wird ein neues Date-Objekt
now ohne Parameter erstellt und anschließend wird dem ursprünglichen Date-Objekt
now mithilfe der folgenden DateMath-Klassenmethode (siehe unten) die Zeit seit seiner Erstellung hinzugefügt:
addSeconds(): fügt 30 Sekunden zu now hinzu.
addMinutes(): fügt 30 Minuten zu now hinzu.
addHours(): fügt 6 Stunden zum Date-Objekt now hinzu.
addDays() : fügt 30 Tage zum Date-Objekt now hinzu.
addWeeks() : fügt 4 Wochen zu now hinzu.
var now:Date = new Date();
trace(now);
trace(DateMath.addSeconds(now, 30));
trace(DateMath.addMinutes(now, 30));
trace(DateMath.addHours(now, 6));
trace(DateMath.addDays(now, 30));
trace(DateMath.addWeeks(now, 4));
class DateMath {
public static function addWeeks(date:Date, weeks:Number):Date {
return addDays(date, weeks*7);
}
public static function addDays(date:Date, days:Number):Date {
return addHours(date, days*24);
}
public static function addHours(date:Date, hrs:Number):Date {
return addMinutes(date, hrs*60);
}
public static function addMinutes(date:Date, mins:Number):Date {
return addSeconds(date, mins*60);
}
public static function addSeconds(date:Date, secs:Number):Date {
var mSecs:Number = secs * 1000;
var sum:Number = mSecs + date.getTime();
return new Date(sum);
}
}
AS3 function getTimezoneOffset():Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt die Differenz zwischen der Weltzeit (UTC) und der Ortszeit des Computers in Minuten zurück.
Rückgabewerte
| Number — Die Anzahl Minuten, die Sie zur Ortszeit des Computers hinzufügen müssen, damit sie gleich der Weltzeit ist. Ist die Ortszeit des Computers später als die Weltzeit, wird ein negativer Wert zurückgegeben.
|
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
now ohne Parameter erstellt. Anschließend wird die
getTimezoneOffset()-Methode aufgerufen, die die Differenz zwischen dem Zeitpunkt der Erstellung von
now und der Weltzeit in Minuten abruft. Anschließend wird die Zeitzonenabweichung in Stunden umgewandelt, indem das Ergebnis durch 60 geteilt wird.
var date:Date = new Date();
trace(date.getTimezoneOffset() / 60);
AS3 function getUTCDate():Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt den Tag des Monats (eine Ganzzahl von 1 bis 31) eines Date-Objekts gemäß der Weltzeit (UTC) zurück.
Rückgabewerte
| Number — Der Tag des Monats (1 - 31) gemäß Weltzeit (UTC), den ein Date-Objekt repräsentiert.
|
Siehe auch
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
someBirthday mit den Parametern
year (
1974),
month (
10 = November),
day (
30),
hour (
1) und
minute (
20) erstellt. Anschließend wird die
getUTCDate()-Methode aufgerufen, die den Tag des Monats gemäß der Weltzeit abruft.
var someBirthday:Date = new Date(1974, 10, 30, 1, 20);
trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974
trace(someBirthday.getUTCDate()); // 30
AS3 function getUTCDay():Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt den Wochentag (0 für Sonntag, 1 für Montag usw.) dieses Date -Objekts gemäß Weltzeit (UTC) zurück.
Rückgabewerte
| Number — Der Tag der Woche (0 - 6) gemäß Weltzeit (UTC), den ein Date-Objekt repräsentiert.
|
Siehe auch
Beispiel
Bei folgendem Beispiel wird ein neues Array-Objekt
weekDayLabels mit den Elementen
[Sunday,Monday,Tuesday,Wednesday,Thursday,Friday,Saturday] und ein neues Date-Objekt
someBirthday mit den Parametern
year (
1974),
month (
10 = November),
day (
30),
hour (
1) und
minute (
20) erstellt. Anschließend wird die
getUTCDay()-Methode zweimal aufgerufen. Daraufhin wird zuerst der Tag des Monats als 6 angezeigt und dann wird der Tag der Woche gemäß Weltzeit mithilfe von
weekDayLabels angezeigt.
var weekDayLabels:Array = new Array("Sunday",
"Monday",
"Tuesday",
"Wednesday",
"Thursday",
"Friday",
"Saturday");
var someBirthday:Date = new Date(1974, 10, 30, 1, 20);
trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974
trace(someBirthday.getUTCDay()); // 6
trace(weekDayLabels[someBirthday.getUTCDay()]); // Saturday
AS3 function getUTCFullYear():Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt die vierstellige Jahreszahl des Date-Objekts gemäß Weltzeit (UTC) zurück.
Rückgabewerte
| Number — Die vierstellige Jahreszahl gemäß Weltzeit (UTC), die das Date-Objekt repräsentiert.
|
Siehe auch
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
someBirthday mit den Parametern
year (
1974),
month (
10 = November),
day (
30),
hour (
1) und
minute (
20) erstellt. Anschließend wird die
getUTCFullYear()-Methode aufgerufen, die die vierstellige Jahreszahl gemäß Weltzeit abruft.
var someBirthday:Date = new Date(1974, 10, 30, 1, 20);
trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974
trace(someBirthday.getUTCFullYear()); // 1974
AS3 function getUTCHours():Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt die Stunde (eine Ganzzahl von 0 bis 23) des Date-Objekts gemäß der Weltzeit (UTC) zurück.
Rückgabewerte
| Number — Die Stunde (0 - 23) gemäß Weltzeit (UTC), die ein Date-Objekt repräsentiert.
|
Siehe auch
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
someBirthday mit den Parametern
year (
1974),
month (
10 = November),
day (
30),
hour (
1) und
minute (
20) erstellt. Anschließend werden die
getHours()- und
getMinutes()-Methoden aufgerufen, die die Stunden und Minuten im 24-Stunden-Format abrufen. Abschließend wird ein String (
localTime) erstellt und dem Ergebnis zugeordnet, das sich aus dem Aufruf der
getUSClockTime()-Funktion ergibt. Daraufhin werden erneut
getHours() und
getMinutes() aufgerufen und schließlich wird die Zeit ausgegeben:
03:05 PM. Abschließend wird eine String-Variable (
utcTime) auf die gleiche Weise wie
localTime erstellt, und in diesem Fall ist das Ergebnis identisch.
var someBirthday:Date = new Date(1974, 10, 30, 15, 5);
trace(someBirthday); // Sat Nov 30 15:20:00 GMT-0800 1974
trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 15:5
var localTime:String = getUSClockTime(someBirthday.getHours(), someBirthday.getMinutes());
trace(localTime); // 03:05 PM
var utcTime:String = getUSClockTime(someBirthday.getUTCHours(), someBirthday.getUTCMinutes());
trace(utcTime); // 11:05 PM
function getUSClockTime(hrs:uint, mins:uint):String {
var modifier:String = "PM";
var minLabel:String = doubleDigitFormat(mins);
if(hrs > 12) {
hrs = hrs-12;
} else if(hrs == 0) {
modifier = "AM";
hrs = 12;
} else if(hrs < 12) {
modifier = "AM";
}
return (doubleDigitFormat(hrs) + ":" + minLabel + " " + modifier);
}
function doubleDigitFormat(num:uint):String {
if(num < 10) {
return ("0" + num);
}
return num;
}
AS3 function getUTCMilliseconds():Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt den milliseconds-Teil (eine Ganzzahl von 0 bis 999) eines Date-Objekts gemäß Weltzeit (UTC) zurück.
Rückgabewerte
| Number — Der milliseconds-Teil gemäß Weltzeit (UTC) eines Date-Objekts.
|
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
now ohne Parameter erstellt. Anschließend wird die
getUTCMilliseconds()-Methode aufgerufen, die die Millisekunden des Date-Objekts
now zum Zeitpunkt seiner Erstellung gemäß Weltzeit abruft.
var now:Date = new Date();
trace(now.getUTCMilliseconds());
AS3 function getUTCMinutes():Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt den minutes-Teil (eine Ganzzahl von 0 bis 59) eines Date-Objekts gemäß Weltzeit (UTC) zurück.
Rückgabewerte
| Number — Der minutes-Teil gemäß Weltzeit (UTC) eines Date-Objekts.
|
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
now ohne Parameter erstellt. Anschließend wird die
getUTCMinutes()-Methode aufgerufen, die die Minuten des Date-Objekts
now zum Zeitpunkt seiner Erstellung gemäß Weltzeit abruft.
var now:Date = new Date();
trace(now.getUTCMinutes());
AS3 function getUTCMonth():Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt den month-Teil (von 0 für Januar bis 11 für Dezember) eines Date-Objekts gemäß der Weltzeit (UTC) zurück.
Rückgabewerte
| Number — Der month-Teil gemäß Weltzeit (UTC) eines Date-Objekts.
|
Siehe auch
Beispiel
Im folgenden Beispiel wird ein neues Array-Objekt
monthLabels, und zwar mit den Elementen
January bis
December und einem neuen Date-Objekt
now ohne Parameter erstellt. Anschließend wird die
getUTCMonth()-Methode zweimal aufgerufen. Dadurch wird zuerst die Zahl des Monats und dann der Name des Monats, in dem das Date-Objekt
now erstellt wurde, gemäß Weltzeit zurückgegeben.
var monthLabels:Array = new Array("January",
"February",
"March",
"April",
"May",
"June",
"July",
"August",
"September",
"October",
"November",
"December");
var now:Date = new Date();
trace(now.getMonth());
trace(now.getUTCMonth());
trace(monthLabels[now.getUTCMonth()]);
AS3 function getUTCSeconds():Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt den seconds-Teil (eine Ganzzahl von 0 bis 59) eines Date-Objekts gemäß Weltzeit (UTC) zurück.
Rückgabewerte
| Number — Der seconds-Teil gemäß Weltzeit (UTC) eines Date-Objekts.
|
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
now ohne Parameter erstellt. Anschließend wird die
getUTCSeconds()-Methode aufgerufen, die die Sekunden des Date-Objekts
now zum Zeitpunkt seiner Erstellung gemäß Weltzeit abruft.
var now:Date = new Date();
trace(now.getUTCSeconds());
public static function parse(date:String):Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Konvertiert einen String, der ein Datum repräsentiert, in eine Zahl, die der Anzahl der seit dem 1. Januar 1970 vergangenen Millisekunden gemäß Weltzeit (UTC) entspricht.
Parameter
| date:String — Die Stringdarstellung eine Datums, das dem Format für die Ausgabe von Date.toString() entspricht. Die Ausgabe von Date.toString() hat das folgende Format:
Day Mon DD HH:MM:SS TZD YYYY
Dabei gilt u. a.:
Wed Apr 12 15:30:17 GMT-0700 2006
Die Zeitzonenzuweisung (TZD, Time Zone Designation) hat immer das Format GMT-HHMM oder UTC-HHMM, wobei die Abweichung von der Weltzeit (GMT, heute als Koordinierte Weltzeit, UTC bezeichnet) in Stunden und Minuten angegeben wird. Jahr, Monat und Tag können auch durch einen Schrägstrich (/)getrennt sein oder durch Leerzeichen, aber niemals durch einen Bindestrich (-). Es werden zudem die folgenden Formate unterstützt (Sie können jeweils auch Teilrepräsentationen dieser Formate verwenden, also nur Monat, Tag und Jahr):
MM/DD/YYYY HH:MM:SS TZD HH:MM:SS TZD Day Mon/DD/YYYY Mon DD YYYY HH:MM:SS TZD Day Mon DD HH:MM:SS TZD YYYY Day DD Mon HH:MM:SS TZD YYYY Mon/DD/YYYY HH:MM:SS TZD YYYY/MM/DD HH:MM:SS TZD
|
Rückgabewerte
| Number — Eine Zahl, die der Anzahl der seit dem 1. Januar 1970 vergangenen Millisekunden gemäß Weltzeit (UTC) entspricht.
|
Siehe auch
Beispiel
Im folgenden Beispiel wird
dateParsed ein Datumsstring für den 30. November 1974 zugewiesen. Anschließend wird die
Date.parse()-Methode aufgerufen, die das Datum in die Anzahl Millisekunden seit dem 1. Januar 1970 umwandelt.
var dateParsed:String = "Sat Nov 30 1974";
var milliseconds:Number = Date.parse(dateParsed);
trace(milliseconds); // 155030400000
AS3 function setDate(day:Number):Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Stellt den Tag des Monats gemäß Ortszeit ein, und gibt den neuen Zeitpunkt in Millisekunden zurück. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem der Flash Player ausgeführt wird.
Parameter
| day:Number — Eine Ganzzahl von 1 bis 31.
|
Rückgabewerte
| Number — Die neue Zeit in Millisekunden.
|
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
someBirthday mit den Parametern
year (
1974),
month (
10 = November),
day (
30),
hour (
1) und
minute (
20) erstellt. Anschließend wird die
getDate()-Methode aufgerufen, die den Tag des Monats abruft. Dann wird
setDate() aufgerufen, wobei der
day-Parameter auf den Wert
20 gesetzt ist; daraufhin wird erneut
getDate() aufgerufen, um den neu eingestellten Tag des Monats abzurufen.
var someBirthday:Date = new Date(1974, 10, 30, 1, 20);
trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974
trace(someBirthday.getDate()); // 30
someBirthday.setDate(20);
trace(someBirthday.getDate()); // 20
AS3 function setFullYear(year:Number, month:Number, day:Number):Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Stellt das Jahr gemäß Ortszeit ein, und gibt den neuen Zeitpunkt in Millisekunden zurück. Die Angabe der Parameter month und day setzt diese auf Ortszeit. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem der Flash Player ausgeführt wird.
Bei Aufruf dieser Methode werden die anderen Felder des Date-Objekts nicht geändert. Die Methoden Date.getUTCDay() und Date.getDay() können jedoch einen neuen Wert zurückgeben, wenn sich der Wochentag aufgrund des Aufrufs dieser Methode ändert.
Parameter
| year:Number — Eine vierstellige Zahl zur Angabe eines Jahres. Zweistellige Zahlen sind nicht für vierstellige Jahresangaben vorgesehen. So steht 99 z. B. nicht für das Jahr 1999, sondern für das Jahr 99.
|
| |
| month:Number — Eine Ganzzahl von 0 (Januar) bis 11 (Dezember).
|
| |
| day:Number — Eine Zahl zwischen 1 und 31.
|
Rückgabewerte
| Number — Die neue Zeit in Millisekunden.
|
Siehe auch
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
someBirthday mit den Parametern
year (
1974),
month (
10 = November),
day (
30),
hour (
1) und
minute (
20) erstellt. Anschließend wird die
getFullYear()-Methode aufgerufen, die die vierstellige Jahreszahl abruft. Dann wird
setFullYear() aufgerufen, wobei der
year-Parameter auf den Wert
2000 gesetzt ist; daraufhin wird erneut
getFullYear() aufgerufen, um das neu eingestellte Jahr abzurufen.
var someBirthday:Date = new Date(1974, 10, 30, 1, 20);
trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974
trace(someBirthday.getFullYear()); // 1974
someBirthday.setFullYear(2000);
trace(someBirthday.getFullYear()); // 2000
AS3 function setHours(hour:Number, minute:Number, second:Number, millisecond:Number):Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Stellt die Stunde gemäß Ortszeit ein, und gibt den neuen Zeitpunkt in Millisekunden zurück. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem der Flash Player ausgeführt wird.
Parameter
| hour:Number — Eine Ganzzahl von 0 (Mitternacht) bis 23 (23.00 Uhr).
|
| |
| minute:Number — Eine Ganzzahl von 0 bis 59.
|
| |
| second:Number — Eine Ganzzahl von 0 bis 59.
|
| |
| millisecond:Number — Eine Ganzzahl von 0 bis 999.
|
Rückgabewerte
| Number — Die neue Zeit in Millisekunden.
|
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
someBirthday mit den Parametern
year (
1974),
month (
10 = November),
day (
30),
hour (
1) und
minute (
20) erstellt. Anschließend werden die
getHours()- und
getMinutes()-Methoden aufgerufen, die die Stunden und Minuten abrufen. Dann wird
setHours() aufgerufen, wobei der
hour-Parameter auf den Wert
12 gesetzt ist; daraufhin wird erneut
getHours() und
getMinutes() aufgerufen, um die neu eingestellten Stunden und Minuten abzurufen.
var someBirthday:Date = new Date(1974, 10, 30, 15, 20);
trace(someBirthday); // Sat Nov 30 15:20:00 GMT-0800 1974
trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 15:20
someBirthday.setHours(12);
trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 12:20
AS3 function setMilliseconds(millisecond:Number):Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Stellt die Millisekunde gemäß Ortszeit ein, und gibt den neuen Zeitpunkt in Millisekunden zurück. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem der Flash Player ausgeführt wird.
Parameter
| millisecond:Number — Eine Ganzzahl von 0 bis 999.
|
Rückgabewerte
| Number — Die neue Zeit in Millisekunden.
|
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
now ohne Parameter erstellt. Anschließend wird die
getMilliseconds()-Methode aufgerufen, die die Anzahl von Millisekunden zum Zeitpunkt der Erstellung von
now zurückgibt. Dann wird weiteres neues Date-Objekt (
before) mit einem zusätzlichen Aufruf von
setMilliseconds() erstellt, wobei der
millisecond-Parameter auf den Wert
4 gesetzt ist. Dann wird
getMilliseconds() erneut aufgerufen, die die neu eingestellten Millisekunden abruft.
var now:Date = new Date();
trace(now);
trace(now.getMilliseconds());
var before:Date = new Date(now.setMilliseconds(4));
trace(before);
trace(before.getMilliseconds());
AS3 function setMinutes(minute:Number, second:Number, millisecond:Number):Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Stellt die Minute gemäß Ortszeit ein, und gibt den neuen Zeitpunkt in Millisekunden zurück. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem der Flash Player ausgeführt wird.
Parameter
| minute:Number — Eine Ganzzahl von 0 bis 59.
|
| |
| second:Number — Eine Ganzzahl von 0 bis 59.
|
| |
| millisecond:Number — Eine Ganzzahl von 0 bis 999.
|
Rückgabewerte
| Number — Die neue Zeit in Millisekunden.
|
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
now ohne Parameter erstellt. Anschließend wird die
getMinutes()-Methode aufgerufen, die die Anzahl von Minuten zum Zeitpunkt der Erstellung von
now zurückgibt. Dann wird weiteres neues Date-Objekt (
before) mit einem zusätzlichen Aufruf von
setMinutes() erstellt, wobei der
minute-Parameter auf den Wert
0 gesetzt ist. Dann wird
getMinutes() erneut aufgerufen, die die neu eingestellten Minuten abruft.
var now:Date = new Date();
trace(now);
trace(now.getMinutes());
var before:Date = new Date(now.setMinutes(0));
trace(before);
trace(before.getMinutes());
AS3 function setMonth(month:Number, day:Number):Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Stellt den Monat und optional den Tag des Monats gemäß Ortszeit ein, und gibt den neuen Zeitpunkt in Millisekunden zurück. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem der Flash Player ausgeführt wird.
Parameter
| month:Number — Eine Ganzzahl von 0 (Januar) bis 11 (Dezember).
|
| |
| day:Number — Eine Ganzzahl von 1 bis 31.
|
Rückgabewerte
| Number — Die neue Zeit in Millisekunden.
|
Beispiel
Im folgenden Beispiel wird ein neues Array-Objekt
monthLabels, und zwar mit den Elementen
January bis
December und einem neuen month-Objekt
now ohne Parameter erstellt. Anschließend wird die
getMonth()-Methode aufgerufen, die den Monat zum Zeitpunkt der Erstellung von
now zurückgibt. Dann wird
setMonth() aufgerufen, wobei der
month-Parameter auf den Wert
0 gesetzt ist; daraufhin wird erneut
getMonth() aufgerufen, um den neu eingestellten Monat abzurufen.
var monthLabels:Array = new Array("January",
"February",
"March",
"April",
"May",
"June",
"July",
"August",
"September",
"October",
"November",
"December");
var now:Date = new Date();
trace(now.getMonth());
trace(monthLabels[now.getMonth()]);
now.setMonth(0);
trace(now.getMonth()); // 0
trace(monthLabels[now.getMonth()]); // January
AS3 function setSeconds(second:Number, millisecond:Number):Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Stellt die Sekunde gemäß Ortszeit ein, und gibt den neuen Zeitpunkt in Millisekunden zurück. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem der Flash Player ausgeführt wird.
Parameter
| second:Number — Eine Ganzzahl von 0 bis 59.
|
| |
| millisecond:Number — Eine Ganzzahl von 0 bis 999.
|
Rückgabewerte
| Number — Die neue Zeit in Millisekunden.
|
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
now ohne Parameter erstellt. Anschließend wird die
getseconds()-Methode aufgerufen, die die Anzahl von Minuten zum Zeitpunkt der Erstellung von
now zurückgibt. Dann wird
setSeconds() aufgerufen, wobei der
second-Parameter auf den Wert
0 gesetzt ist; daraufhin wird erneut
getSeconds() aufgerufen, um die neu eingestellten Sekunden abzurufen.
var now:Date = new Date();
trace(now.getSeconds());
now.setSeconds(0);
trace(now.getSeconds()); // 0
AS3 function setTime(millisecond:Number):Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Legt das Datum in Millisekunden seit dem 1. Januar 1970, 0.00 Uhr fest und gibt den neuen Zeitpunkt in Millisekunden zurück.
Parameter
| millisecond:Number — Eine Ganzzahl, bei der 0 dem 1. Januar, 0.00 Uhr Weltzeit (UTC) entspricht.
|
Rückgabewerte
| Number — Die neue Zeit in Millisekunden.
|
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
now ohne Parameter erstellt. Anschließend wird die
setTime()-Methode aufgerufen, wobei der
millisecond-Parameter auf den Wert
-1292601600000 gesetzt ist; dadurch wird die Zeit wie folgt eingestellt:
Tue Jan 15 00:00:00 GMT-0800 1929.
var now:Date = new Date();
trace(now);
now.setTime(-1292601600000);
trace(now); // Tue Jan 15 00:00:00 GMT-0800 1929
AS3 function setUTCDate(day:Number):Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Stellt den Tag des Monats gemäß Weltzeit (UTC) ein, und gibt den neuen Zeitpunkt in Millisekunden zurück. Bei Aufruf dieser Methode werden die anderen Felder des Date -Objekts nicht geändert. Die Methoden Date.getUTCDay() und Date.getDay() können jedoch einen neuen Wert zurückgeben, wenn sich der Wochentag aufgrund des Aufrufs dieser Methode ändert.
Parameter
| day:Number — Eine Ganzzahl von 1 bis 31.
|
Rückgabewerte
| Number — Die neue Zeit in Millisekunden.
|
Siehe auch
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
someBirthday mit den Parametern
year (
1974),
month (
10 = November),
day (
30),
hour (
1) und
minute (
20) erstellt. Anschließend wird die
getUTCDate()-Methode aufgerufen, die den richtigen Tag des Monats zurückgibt. Dann wird
setUTCDate() aufgerufen, wobei der
day-Parameter auf den Wert
1 gesetzt ist. Mithilfe einer
trace()-Anweisung wird bestätigt, dass das Datum richtig gesetzt wurde.
var someBirthday:Date = new Date(1974, 10, 30, 1, 20);
trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974
trace(someBirthday.getUTCDate()); // 30
someBirthday.setUTCDate(1);
trace(someBirthday); // Fri Nov 1 01:20:00 GMT-0800 1974
AS3 function setUTCFullYear(year:Number, month:Number, day:Number):Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Stellt das Jahr gemäß Weltzeit (UTC) ein, und gibt den neuen Zeitpunkt in Millisekunden zurück.
Optional können mit dieser Methode auch der Monat und der Tag des Monats eingestellt werden. Bei Aufruf dieser Methode werden die anderen Felder des Objekts nicht geändert. Die Methoden Date.getUTCDay() und Date.getDay() können jedoch einen neuen Wert zurückgeben, wenn sich der Wochentag aufgrund des Aufrufs dieser Methode ändert.
Parameter
| year:Number — Eine Ganzzahl, die das Jahr mit vier Stellen darstellt, z. B. 2007.
|
| |
| month:Number — Eine Ganzzahl von 0 (Januar) bis 11 (Dezember).
|
| |
| day:Number — Eine Ganzzahl von 1 bis 31.
|
Rückgabewerte
Siehe auch
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
someBirthday mit den Parametern
year (
1974),
month (
10 = November),
day (
30),
hour (
1) und
minute (
20) erstellt. Anschließend wird die
getUTCFullYear()-Methode aufgerufen, die korrekt die vierstellige Jahreszahl zurückgibt. Dann wird
setUTCFullYear() aufgerufen, wobei der
year-Parameter auf den Wert
1975 gesetzt ist. Mithilfe einer
trace()-Anweisung wird bestätigt, dass das Jahr richtig gesetzt wurde.
var someBirthday:Date = new Date(1974, 10, 30, 1, 20);
trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974
trace(someBirthday.getUTCFullYear()); // 1974
someBirthday.setUTCFullYear(1975);
trace(someBirthday); // Thu Nov 30 01:20:00 GMT-0800 1975
AS3 function setUTCHours(hour:Number, minute:Number, second:Number, millisecond:Number):Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Stellt die Stunde gemäß Weltzeit (UTC) ein, und gibt den neuen Zeitpunkt in Millisekunden zurück. Optional können auch die Minute, Sekunde und Millisekunde angegeben werden.
Parameter
| hour:Number — Eine Ganzzahl von 0 (Mitternacht) bis 23 (23.00 Uhr).
|
| |
| minute:Number — Eine Ganzzahl von 0 bis 59.
|
| |
| second:Number — Eine Ganzzahl von 0 bis 59.
|
| |
| millisecond:Number — Eine Ganzzahl von 0 bis 999.
|
Rückgabewerte
| Number — Die neue Zeit in Millisekunden.
|
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
someBirthday mit den Parametern
year (
1974),
month (
10 = November),
day (
30),
hour (
1) und
minute (
20) erstellt. Anschließend werden die
getHours()-,
getMinutes()-,
getUTCHours()- und
getUTCMinutes()-Methoden aufgerufen, die die Stunden und Minuten abrufen. Dann wird
setUTCHours() aufgerufen, wobei der
hour-Parameter auf den Wert
12 gesetzt ist. Anschließend werden die Methoden
getHours(),
getMinutes(),
getUTCHours() und
getUTCMinutes() erneut aufgerufen und die aktualisierte Stunde wird korrekt angezeigt.
var someBirthday:Date = new Date(1974, 10, 30, 15, 20);
trace(someBirthday); // Sat Nov 30 15:20:00 GMT-0800 1974
trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 15:20
trace(someBirthday.getUTCHours() + ":" + someBirthday.getUTCMinutes()); // 23:20
someBirthday.setUTCHours(12);
trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 4:20
trace(someBirthday.getUTCHours() + ":" + someBirthday.getUTCMinutes()); // 12:20
AS3 function setUTCMilliseconds(millisecond:Number):Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Stellt die Millisekunde gemäß Weltzeit (UTC) ein, und gibt den neuen Zeitpunkt in Millisekunden zurück.
Parameter
| millisecond:Number — Eine Ganzzahl von 0 bis 999.
|
Rückgabewerte
| Number — Die neue Zeit in Millisekunden.
|
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
now ohne Parameter erstellt. Anschließend wird die
getUTCMilliseconds()-Methode aufgerufen, die die Anzahl von Millisekunden gemäß Weltzeit zum Zeitpunkt der Erstellung von
now zurückgibt. Dann wird weiteres neues Date-Objekt (
before) mit einem zusätzlichen Aufruf von
setUTCMilliseconds() erstellt, wobei der
millisecond-Parameter auf den Wert
4 gesetzt ist. Dann wird
getUTCMilliseconds() erneut aufgerufen, die die neu eingestellten Millisekunden abruft.
var now:Date = new Date();
trace(now);
trace(now.getUTCMilliseconds());
var before:Date = new Date(now.setUTCMilliseconds(4));
trace(before);
trace(before.getUTCMilliseconds());
AS3 function setUTCMinutes(minute:Number, second:Number, millisecond:Number):Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Stellt die Minute gemäß Weltzeit (UTC) ein, und gibt den neuen Zeitpunkt in Millisekunden zurück. Optional können Sie auch die Sekunde und Millisekunde angeben.
Parameter
| minute:Number — Eine Ganzzahl von 0 bis 59.
|
| |
| second:Number — Eine Ganzzahl von 0 bis 59.
|
| |
| millisecond:Number — Eine Ganzzahl von 0 bis 999.
|
Rückgabewerte
| Number — Die neue Zeit in Millisekunden.
|
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
now ohne Parameter erstellt. Anschließend wird die
getUTCMinutes()-Methode aufgerufen, die die Anzahl von Minuten gemäß Weltzeit zum Zeitpunkt der Erstellung von
now zurückgibt. Dann wird weiteres neues Date-Objekt (
before) mit einem zusätzlichen Aufruf von
setUTCMinutes() erstellt, wobei der
minute-Parameter auf den Wert
0 gesetzt ist. Dann wird
getUTCMinutes() erneut aufgerufen, die die neu eingestellten Minuten abruft.
var now:Date = new Date();
trace(now);
trace(now.getUTCMinutes());
var before:Date = new Date(now.setUTCMinutes(0));
trace(before);
trace(before.getUTCMinutes());
AS3 function setUTCMonth(month:Number, day:Number):Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Stellt den Monat, und optional auch den Tag des Monats, gemäß Weltzeit (UTC) ein, und gibt den neuen Zeitpunkt in Millisekunden zurück. Bei Aufruf dieser Methode werden die anderen Felder des Objekts nicht geändert. Die Methoden Date.getUTCDay() und Date.getDay() können jedoch einen neuen Wert zurückgeben, wenn sich der Wochentag aufgrund des Aufrufs dieser Methode ändert.
Parameter
| month:Number — Eine Ganzzahl von 0 (Januar) bis 11 (Dezember).
|
| |
| day:Number — Eine Ganzzahl von 1 bis 31.
|
Rückgabewerte
| Number — Die neue Zeit in Millisekunden.
|
Siehe auch
Beispiel
Im folgenden Beispiel wird ein neues Array-Objekt
UTCMonthLabels, und zwar mit den Elementen
January bis
December und einem neuen UTCMonth-Objekt
now ohne Parameter erstellt. Anschließend wird die
getUTCMonth()-Methode aufgerufen, die den Monat gemäß Weltzeit zum Zeitpunkt der Erstellung von
now zurückgibt. Dann wird
setUTCMonth() aufgerufen, wobei der
month-Parameter auf den Wert
0 gesetzt ist; daraufhin wird erneut
getUTCMonth() aufgerufen, um den neu eingestellten Monat abzurufen.
var UTCMonthLabels:Array = new Array("January",
"February",
"March",
"April",
"May",
"June",
"July",
"August",
"September",
"October",
"November",
"December");
var now:Date = new Date();
trace(now.getUTCMonth());
trace(UTCMonthLabels[now.getUTCMonth()]);
now.setUTCUTCMonth(0);
trace(now.getUTCMonth()); // 0
trace(UTCMonthLabels[now.getUTCMonth()]); // January
AS3 function setUTCSeconds(second:Number, millisecond:Number):Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Stellt die Sekunde, und optional auch die Millisekunde, gemäß Weltzeit (UTC) ein, und gibt den neuen Zeitpunkt in Millisekunden zurück.
Parameter
| second:Number — Eine Ganzzahl von 0 bis 59.
|
| |
| millisecond:Number — Eine Ganzzahl von 0 bis 999.
|
Rückgabewerte
| Number — Die neue Zeit in Millisekunden.
|
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
now ohne Parameter erstellt. Anschließend wird die
getUTCSeconds()-Methode aufgerufen, die die Anzahl von Minuten zum Zeitpunkt der Erstellung von
now zurückgibt. Dann wird
setUTCSeconds() aufgerufen, wobei der
second-Parameter auf den Wert
0 gesetzt ist; daraufhin wird erneut
getUTCSeconds() aufgerufen, um die neu eingestellten Sekunden abzurufen.
var now:Date = new Date();
trace(now.getUTCSeconds());
now.setUTCSeconds(0);
trace(now.getUTCSeconds()); // 0
AS3 function toDateString():String
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt eine Stringdarstellung nur des Wochentags und des Tags des Monats zurück ohne Angabe zu Uhrzeit und Zeitzone. Vergleichen Sie dies mit den folgenden Methoden:
Date.toTimeString(), die nur die Zeit und die Zeitzone zurückgibt.
Date.toString(), die nicht nur den Wochentag und den Tag des Monats zurückgibt, sondern auch die Uhrzeit und die Zeitzone.
Rückgabewerte
| String — Die Stringdarstellung nur des Wochentags und des Tags des Monats.
|
Siehe auch
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
now ohne Parameter erstellt und anschließend werden die folgenden Methoden innerhalb einer
trace()-Anweisung aufgerufen
toString: zeigt alle Parameter für now zum Zeitpunkt der Erstellung von now an.
toDateString(): zeigt die Parameter day, month und year zum Zeitpunkt der Erstellung von now an.
var now:Date = new Date();
trace(now);
trace(now.toDateString());
AS3 function toLocaleDateString():String
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt eine Stringdarstellung nur des Wochentags und des Tags des Monats zurück ohne Angabe zu Uhrzeit und Zeitzone. Diese Methode gibt denselben Wert zurück wie Date.toDateString. Vergleichen Sie dies mit den folgenden Methoden:
Date.toTimeString(), die nur die Zeit und die Zeitzone zurückgibt.
Date.toString(), die nicht nur den Wochentag und den Tag des Monats zurückgibt, sondern auch die Uhrzeit und die Zeitzone.
Rückgabewerte
| String — Die String-Darstellung nur des Wochentags und des Tags des Monats.
|
Siehe auch
AS3 function toLocaleString():String
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt eine Stringdarstellung des Wochentags, des Tags des Monats, der Uhrzeit gemäß der Ortszeit zurück. Vergleichen Sie dies mit der Methode Date.toString(), die dieselben Informationen (plus die Zeitzone) zurückgibt, wobei am Ende des Strings zudem das Jahr erscheint.
Rückgabewerte
| String — Eine Stringdarstellung eines Date-Objekts in der lokalen Zeitzone.
|
AS3 function toLocaleTimeString():String
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt eine Stringdarstellung nur der Uhrzeit zurück ohne Angabe zu Wochentag, Tag des Monats, Jahr oder Zeitzone. Vergleichen Sie dies mit der Methode Date.toTimeString(), die nur die Uhrzeit und die Zeitzone zurückgibt.
Rückgabewerte
| String — Die Stringdarstellung nur der Uhrzeit und der Zeitzone.
|
Siehe auch
AS3 function toString():String
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt eine Stringdarstellung des Wochentags, des Tags des Monats, der Uhrzeit und der Zeitzone zurück. Das Datum für die Ausgabe hat das folgende Format:
Day Mon Date HH:MM:SS TZD YYYY
Dabei gilt u. a.:
Wed Apr 12 15:30:17 GMT-0700 2006
Rückgabewerte
| String — Die Stringdarstellung des Date-Objekts.
|
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
now ohne Parametera erstellt. Anschließend wird
toString innerhalb einer
trace() Anweisung aufgerufen, wodurch alle Parameter für
now zum Zeitpunkt der Erstellung von
now angezeigt werden.
var now:Date = new Date();
trace(now);
AS3 function toTimeString():String
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt eine Stringdarstellung nur der Uhrzeit und der Zeitzone zurück ohne Angabe zu Wochentag und Tag des Monats. Vergleichen Sie dies mit der Methode Date.toDateString(), die nur den Wochentag und den Tag des Monats zurückgibt.
Rückgabewerte
| String — Die Stringdarstellung nur der Uhrzeit und der Zeitzone.
|
Siehe auch
AS3 function toUTCString():String
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt eine Stringdarstellung des Wochentags, des Tags des Monats und der Uhrzeit gemäß der Weltzeit (UTC) zurück. Das Datum "1. Februar 2005" wird beispielsweise als Tue Feb 1 00:00:00 2005 UTC zurückgegeben.
Rückgabewerte
| String — Die Stringdarstellung eines Date-Objekts in der UTC-Zeitzone.
|
Siehe auch
public static function UTC(year:Number, month:Number, date:Number = 1, hour:Number = 0, minute:Number = 0, second:Number = 0, millisecond:Number = 0):Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt die Anzahl von Millisekunden zurück, die zwischen dem 1. Januar 1970, 0.00 Uhr Weltzeit, und der in den Parametern angegebenen Zeit vergangen sind. Diese Methode verwendet Weltzeit, während der Konstruktor Date Ortszeit verwendet.
Diese Methode ist nützlich, wenn Sie ein UTC-Datum an den Date-Klassenkonstruktor übergeben. Da der Date-Klassenkonstruktor den Zeitabstand in Millisekunden als Argument akzeptiert, können Sie mithilfe der Methode Date.UTC() Ihr UTC-Datum in den entsprechenden Zeitabstand in Millisekunden konvertieren und diesen Zeitabstand dann als Argument an den Date-Klassenkonstruktor senden.
Parameter
| year:Number — Eine vierstellige Ganzzahl, die das Jahr darstellt (z. B. 2000).
|
| |
| month:Number — Eine Ganzzahl von 0 (Januar) bis 11 (Dezember).
|
| |
| date:Number (default = 1) — Eine Ganzzahl von 1 bis 31.
|
| |
| hour:Number (default = 0) — Eine Ganzzahl von 0 (Mitternacht) bis 23 (23.00 Uhr).
|
| |
| minute:Number (default = 0) — Eine Ganzzahl von 0 bis 59.
|
| |
| second:Number (default = 0) — Eine Ganzzahl von 0 bis 59.
|
| |
| millisecond:Number (default = 0) — Eine Ganzzahl von 0 bis 999.
|
Rückgabewerte
| Number — Die Anzahl von Millisekunden seit dem 1. Januar 1970 und dem angegebenen Datum und der Uhrzeit.
|
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
someBirthday mit den Parametern
year (
1974),
month (
10 = November),
day (
30),
hour (
1) und
minute (
20) in Ortszeit erstellt. Durch das Aufrufen von
UTC() innerhalb einer
setTime()-Methode werden die gleichen Parameter auf Weltzeit gesetzt.
var someBirthday:Date = new Date(1974, 10, 30, 15, 20);
trace(someBirthday.toString());
someBirthday.setTime(Date.UTC(1974, 10, 30, 15, 20));
trace(someBirthday.toString());
AS3 function valueOf():Number
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt für ein Date-Objekt die Anzahl der Millisekunden zurück, die seit dem 1. Januar 1970, 0.00 Uhr, Weltzeit, vergangen sind.
Rückgabewerte
| Number — Die Anzahl an Millisekunden, die zwischen dem 1. Januar 1970 und dem Datum, den das Date-Objekt repräsentiert, vergangen sind.
|
Beispiel
Im folgenden Beispiel wird ein neues Date-Objekt
now ohne Parameter erstellt. Anschließend wird die
getTime()-Methode aufgerufen, die die Anzahl von Millisekunden zwischen dem Zeitpunkt der Erstellung von
now und dem 1. Januar 1970, 0.00 Uhr abruft. Dann wird
valueOf() aufgerufen, womit ebenfalls diese Anzahl von Millisekunden abgerufen wird.
var now:Date = new Date();
trace(now.getTime());
trace(now.valueOf());
Das folgende Beispiel veranschaulicht verschiedene Möglichkeiten, wie Sie mit dem
Date()-Konstruktor die folgenden Variablen zuweisen können:
myDate1 ruft Date() ohne Parametera auf, wodurch myDate1 auf das aktuelle Datum und die aktuelle Zeit gesetzt wird (gemäß der aktuellen Datums- und Zeiteinstellung des System).
myDate2 ruft Date() auf, wobei die Parameter year (2000), month (0 = Januar) und day (1) übergeben werden.
myDate3 ruft Date() mit year (65 = 1965), month (2 = März) auf, wobei day (6), hour (9), minute (30), second (15) und millisecond-+ (0) als Parameter weitergegeben werden.
myDate4 ruft Date() auf, wobei der Zeitwert die Anzahl der Millisekunden vor (da dieser Wert negativ ist) dem 1. Januar 1970, 0.00 Uhr GMT angibt.
package {
import flash.display.Sprite;
public class DateExample extends Sprite{
public function DateExample() {
var myDate1:Date = new Date();
trace(myDate1); // [NOW]
var myDate2:Date = new Date(2000, 0, 1);
trace(myDate2); // Sat Jan 1 00:00:00 GMT-0800 2000
var myDate3:Date = new Date(65, 2, 6, 9, 30, 15, 0);
trace(myDate3); // Sat Mar 6 09:30:15 GMT-0800 1965
var myDate4:Date = new Date(-14159025000);
trace(myDate4); // Sun Jul 20 19:56:15 GMT-0700 1969
}
}
}
© 2004-2007 Adobe Systems Incorporated. All rights reserved.
Fri Oct 12 2007, 2:03 AM GMT-07:00
Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/Date.html