De klasse Date bevat een van de meest veelzijdige constructormethoden van alle kernklassen. U kunt deze op vier manieren aanroepen:
Eerste methode: als er geen parameters zijn opgegeven, retourneert de constructor
Date()
een object Date met de huidige datum en tijd voor uw tijdzone. Hier volgt een voorbeeld:
var now:Date = new Date();
Tweede methode: als er een numerieke parameter is opgegeven, wordt deze waarde door de constructor
Date()
beschouwd als het aantal milliseconden sinds 1 januari 1970 en wordt er een overeenkomend object Date geretourneerd. De waarde die u doorgeeft, wordt beschouwd als het aantal milliseconden sinds 1 januari 1970, in UTC. In het object Date worden waarden echter in uw lokale tijdzone weergegeven, tenzij u de UTC-specifieke methoden gebruikt om ze op te halen en weer te geven. Als u een nieuw object Date maakt met één parameter voor milliseconden, moet u rekening met het tijdverschil tussen uw lokale tijd en UTC. Met de volgende instructies wordt een object Date op middernacht op 1 januari 1970 (UTC) ingesteld:
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);
Derde methode: u kunt meerdere numerieke parameters doorgeven aan de constructor
Date()
. Deze parameters worden respectievelijk als het jaar, de maand, de dag, het uur, de minuut, de seconde en de milliseconde beschouwd en er wordt een overeenkomend object Date geretourneerd. De waarden in deze invoerparameters worden beschouwd als waarden in de lokale tijd, niet in UTC. Met de volgende instructies wordt een object Date op middernacht op 1 januari 2000 (lokale tijd) ingesteld:
var millenium:Date = new Date(2000, 0, 1, 0, 0, 0, 0);
Vierde methode: u kunt een parameter van één tekenreeks doorgeven aan de constructor
Date()
. Vervolgens wordt geprobeerd die tekenreeks te parseren in datum- of tijdcomponenten en wordt er een overeenkomend object Date geretourneerd. Als u deze methode gebruikt, kunt u de constructor
Date()
het beste insluiten in een blok
try..catch
om eventuele fouten bij het parseren op te vangen. De constructor
Date()
accepteert een aantal verschillende tekenreeksindelingen (deze staan vermeld in de
Naslaggids voor ActionScript 3.0 voor het Adobe Flash-platform
). Met de volgende instructie wordt een nieuw object Date geïnitialiseerd met een tekenreekswaarde:
var nextDay:Date = new Date("Mon May 1 2006 11:30:00 AM");
Als de constructor
Date()
de tekenreeksparameter niet kan parseren, treedt er geen uitzondering op. Het resulterende object Date bevat in dat geval echter wel een ongeldige datumwaarde.