| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
La classe Date rappresenta le informazioni relative a data e ora. Un'istanza della classe Date rappresenta un particolare momento temporale per cui è possibile interrogare o modificare proprietà come mese, giorno, ore e secondi. La classe Date consente di recuperare i valori relativi alla data e all'ora dell'ora universale (UTC; precedentemente definito GMT, Greenwich Mean Time) o relativi all'ora locale, che è determinata dall'impostazione del fuso orario locale nel sistema operativo su cui è in esecuzione Flash Player. I metodi della classe Date non sono statici ma si applicano solo al singolo oggetto Date specificato quando viene chiamato il metodo. I metodi
Date.UTC() e
Date.parse() sono eccezioni; si tratta di metodi statici.
La classe Date gestisce l'ora legale in modo diverso a seconda del sistema operativo e della versione di Flash Player. La versione 6 e successive di Flash Player gestiscono l'ora legale sui seguenti sistemi operativi nei modi indicati di seguito:
- Windows - L'oggetto Date regola automaticamente l'output per l'ora legale. L'oggetto Date rileva se l'ora legale è adottata nella versione locale corrente e, in caso affermativo, rileva la data e l'ora di transizione dall'ora standard all'ora legale. Tuttavia, le date di transizione attualmente in vigore vengono applicate alle date passate e future, e pertanto potrebbe essere calcolata una variazione non corretta dell'ora legale per le ore del passato per cui la versione locale prevedeva date di transizione diverse.
- Mac OS X - L'oggetto Date regola automaticamente l'output per l'ora legale. Per determinare se a una data o a un'ora del presente o del passato deve essere applicata la variazione dell'ora legale viene utilizzato il database delle informazioni sui fusi orari di Mac OS X.
- Mac OS 9 - Il sistema operativo fornisce solo le informazioni sufficienti a determinare se alla data e all'ora corrente deve essere applicata la variazione dell'ora legale. Di conseguenza, l'oggetto Date presuppone che la variazione corrente dell'ora legale viene applicata a tutte le date e le ore nel passato e nel futuro.
La versione 5 di Flash Player gestisce l'ora legale sui seguenti sistemi operativi nel modo indicato di seguito:
- Windows - Vengono sempre applicate le regole statunitensi per l'ora legale e questo comporta delle transizioni non corrette in Europa e nelle altre aree del mondo che adottano l'ora legale ma hanno ore di transizione diverse rispetto agli Stati Uniti. Flash rileva in modo corretto se nella versione locale corrente è utilizzata l'ora legale.
Per utilizzare la classe Date, creare un'istanza Date mediante l'operatore new.
ActionScript 3.0 aggiunge diverse nuove proprietà accessor che è possibile utilizzare al posto di molti metodi della classe Date che accedono o modificano le istanze Date. ActionScript 3.0 include inoltre diverse nuove variazioni del metodo toString() che sono incluse per compatibilità con il linguaggio ECMA-262 edition 3, tra cui: Date.toLocaleString(), Date.toTimeString(), Date.toLocaleTimeString(), Date.toDateString() e Date.toLocaleDateString().
Per calcolare il tempo relativo o il tempo trascorso, vedere il metodo getTimer() nel pacchetto flash.utils.
Vedere gli esempi
date:Number [lettura-scrittura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Il giorno del mese (un numero intero compreso tra 1 e 31) specificato dall'oggetto Date, in base all'ora locale. La data e l'ora locali vengono determinate in base al sistema operativo su cui Flash Player è in esecuzione.
Implementazione
AS3 function get date():Number
AS3 function set date(value:Number):void
Vedere anche
dateUTC:Number [lettura-scrittura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Il giorno del mese (un numero intero compreso tra 1 e 31) di un oggetto Date, in base all'ora universale (UTC).
Implementazione
AS3 function get dateUTC():Number
AS3 function set dateUTC(value:Number):void
Vedere anche
day:Number [sola lettura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Il giorno della settimana (0 per domenica, 1 per lunedì, e così via) specificato dall'oggetto Date, in base all'ora locale. La data e l'ora locali vengono determinate in base al sistema operativo su cui Flash Player è in esecuzione.
Implementazione
AS3 function get day():Number
Vedere anche
dayUTC:Number [sola lettura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Il giorno della settimana (0 per domenica, 1 per lunedì, e così via) dell'oggetto Date, in base all'ora universale (UTC).
Implementazione
AS3 function get dayUTC():Number
Vedere anche
fullYear:Number [lettura-scrittura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
L'anno completo (un numero di quattro cifre, ad esempio 2000) specificato dall'oggetto Date, in base all'ora locale. La data e l'ora locali vengono determinate in base al sistema operativo su cui Flash Player è in esecuzione.
Implementazione
AS3 function get fullYear():Number
AS3 function set fullYear(value:Number):void
Vedere anche
fullYearUTC:Number [lettura-scrittura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
L'anno completo a quattro cifre di un oggetto Date, in base all'ora universale (UTC).
Implementazione
AS3 function get fullYearUTC():Number
AS3 function set fullYearUTC(value:Number):void
Vedere anche
hours:Number [lettura-scrittura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
L'ora (un numero intero compreso tra 0 e 23) della porzione del giorno di un oggetto Date, in base all'ora locale. La data e l'ora locali vengono determinate in base al sistema operativo su cui Flash Player è in esecuzione.
Implementazione
AS3 function get hours():Number
AS3 function set hours(value:Number):void
Vedere anche
hoursUTC:Number [lettura-scrittura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
L'ora (un numero intero compreso tra 0 e 23) del giorno di un oggetto Date, in base all'ora universale (UTC).
Implementazione
AS3 function get hoursUTC():Number
AS3 function set hoursUTC(value:Number):void
Vedere anche
milliseconds:Number [lettura-scrittura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
La porzione dei millisecondi (un numero intero compreso tra 0 e 999) di un oggetto Date, in base all'ora locale. La data e l'ora locali vengono determinate in base al sistema operativo su cui Flash Player è in esecuzione.
Implementazione
AS3 function get milliseconds():Number
AS3 function set milliseconds(value:Number):void
Vedere anche
millisecondsUTC:Number [lettura-scrittura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
La porzione dei millisecondi (un numero intero compreso tra 0 e 999) di un oggetto Date, in base all'ora universale (UTC).
Implementazione
AS3 function get millisecondsUTC():Number
AS3 function set millisecondsUTC(value:Number):void
Vedere anche
minutes:Number [lettura-scrittura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
La porzione dei minuti (un numero intero compreso tra 0 e 59) di un oggetto Date, in base all'ora locale. La data e l'ora locali vengono determinate in base al sistema operativo su cui Flash Player è in esecuzione.
Implementazione
AS3 function get minutes():Number
AS3 function set minutes(value:Number):void
Vedere anche
minutesUTC:Number [lettura-scrittura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
La porzione dei minuti (un numero intero compreso tra 0 e 59) di un oggetto Date, in base all'ora universale (UTC).
Implementazione
AS3 function get minutesUTC():Number
AS3 function set minutesUTC(value:Number):void
Vedere anche
month:Number [lettura-scrittura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
La porzione del mese (0 per gennaio, 1 per febbraio, e così via) di un oggetto Date, in base all'ora locale. La data e l'ora locali vengono determinate in base al sistema operativo su cui Flash Player è in esecuzione.
Implementazione
AS3 function get month():Number
AS3 function set month(value:Number):void
Vedere anche
monthUTC:Number [lettura-scrittura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
La porzione del mese (da 0 per gennaio a 11 per dicembre) di un oggetto Date in base all'ora universale (UTC).
Implementazione
AS3 function get monthUTC():Number
AS3 function set monthUTC(value:Number):void
Vedere anche
seconds:Number [lettura-scrittura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
La porzione dei secondi (un numero intero compreso tra 0 e 59) di un oggetto Date, in base all'ora locale. La data e l'ora locali vengono determinate in base al sistema operativo su cui Flash Player è in esecuzione.
Implementazione
AS3 function get seconds():Number
AS3 function set seconds(value:Number):void
Vedere anche
secondsUTC:Number [lettura-scrittura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
La porzione dei secondi (un numero intero compreso tra 0 e 59) di un oggetto Date, in base all'ora universale (UTC).
Implementazione
AS3 function get secondsUTC():Number
AS3 function set secondsUTC(value:Number):void
Vedere anche
time:Number [lettura-scrittura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Il numero di millisecondi trascorsi a partire dalla mezzanotte del 1 gennaio 1970 (ora universale) per un oggetto Date. Utilizzare questo metodo per rappresentare un istante specifico nel tempo in cui confrontare due o più oggetti Date.
Implementazione
AS3 function get time():Number
AS3 function set time(value:Number):void
Vedere anche
timezoneOffset:Number [sola lettura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
La differenza, espressa in minuti, tra l'ora universale (UTC) e l'ora locale del computer. In particolare, questo valore è il numero di minuti che è necessario aggiungere all'ora locale del computer in modo che corrisponda all'ora universale (UTC). Se l'ora del computer è successiva all'ora universale, il valore è negativo.
Implementazione
AS3 function get timezoneOffset():Number
Vedere anche
public function Date(yearOrTimevalue:Object, month:Number, date:Number = 1, hour:Number = 0, minute:Number = 0, second:Number = 0, millisecond:Number = 0)
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Crea un nuovo oggetto Date che contiene la data e l'ora specificate.
La funzione di costruzione Date() richiede fino a sette parametri (year, month, ..., millisecond) per specificare una data e un'ora al millisecondo. La data contenuta nell'oggetto Date appena creato dipende dal numero e dal tipo di dati degli argomenti passati.
- Se non si passano argomenti, all'oggetto Date vengono assegnate la data e l'ora correnti.
- Se si passa un solo argomento di tipo Number, all'oggetto Date viene assegnato un valore temporale basato sul numero di millisecondi trascorsi a partire dal 1 gennaio 1970 0:00:000 GMT, come specificato nell'unico argomento.
- Se si passa un solo argomento di tipo String e la stringa contiene una data valida, l'oggetto Date contiene un valore temporale basato su tale data.
- Se si passano due o più argomenti, all'oggetto Date viene assegnato un valore temporale basato sui valori dell'argomento passati, che rappresentano l'anno, il mese, la data, l'ora, il minuto, il secondo e i millisecondi della data.
Se si passa una stringa alla funzione di costruzione della classe Date, la data può avere una vasta gamma di formati ma come minimo deve includere il mese, la data e l'anno. Ad esempio, Feb 1 2005 è valido, mentre Feb 2005 non lo è. L'elenco seguente indica alcuni dei formati validi:
- Giorno Mese Data Ore:Minuti:Secondi GMT Anno (ad esempio, "Tue Feb 1 00:00:00 GMT-0800 2005", che corrisponde a
toString())
- Giorno Mese Data Anno Ore:Minuti:Secondi AM/PM (ad esempio, "Tue Feb 1 2005 12:00:00 AM", che corrisponde a
toLocaleString())
- Giorno Mese Data Anno (ad esempio, "Tue Feb 1 2005", che corrisponde a
toDateString())
- Mese/Giorno/Anno (ad esempio, "02/01/2005")
Parametri
| yearOrTimevalue:Object — Se vengono specificati altri parametri, questo numero rappresenta un anno (ad esempio, 1965); in caso contrario, rappresenta un valore dell'ora. Se il numero rappresenta un anno, un valore compreso tra 0 e 99 indica un anno compreso tra il 1900 e il 1999; in caso contrario, è necessario specificare tutte e quattro le cifre dell'anno. Se il numero rappresenta un valore dell'ora (ovvero se non vengono specificati altri parametri), si tratta del numero di millisecondi prima o dopo le 0:00:00 GMT del 1 gennaio 1970; un valore negativo rappresenta un'ora precedente le 0:00:00 GMT del 1 gennaio 1970, mentre un valore positivo rappresenta un'ora successiva.
|
| |
| month:Number — Un numero intero da 0 (gennaio) a 11 (dicembre).
|
| |
| date:Number (default = 1) — Un numero intero compreso tra 1 e 31.
|
| |
| hour:Number (default = 0) — Un numero intero compreso tra 0 (mezzanotte) e 23 (11 PM).
|
| |
| minute:Number (default = 0) — Un numero intero compreso tra 0 e 59.
|
| |
| second:Number (default = 0) — Un numero intero compreso tra 0 e 59.
|
| |
| millisecond:Number (default = 0) — Un numero intero compreso tra 0 e 999 millisecondi.
|
Vedere anche
AS3 function getDate():Number
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce il giorno del mese (un numero intero compreso tra 1 e 31) specificato dall'oggetto Date, in base all'ora locale. La data e l'ora locali vengono determinate in base al sistema operativo su cui Flash Player è in esecuzione.
Restituisce
| Number — Il giorno del mese (1-31) rappresentato da un oggetto Date.
|
Vedere anche
Esempio
Nell'esempio seguente viene illustrato come creare un nuovo oggetto Date
someBirthday con i parametri
year (
1974),
month (
10 = novembre),
day (
30),
hour (
1) e
minute (
20). Quindi, viene chiamato il metodo
getDate(), che recupera il giorno del mese.
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
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce il giorno della settimana (0 per domenica, 1 per lunedì, e così via) specificato dall'oggetto Date, in base all'ora locale. La data e l'ora locali vengono determinate in base al sistema operativo su cui Flash Player è in esecuzione.
Restituisce
| Number — Una versione numerica del giorno della settimana (0-6) rappresentato da un oggetto Date.
|
Esempio
Nell'esempio seguente viene illustrato come creare un nuovo oggetto Array
weekDayLabels con gli elementi
[Sunday,Monday,Tuesday,Wednesday,Thursday,Friday,Saturday] e un nuovo oggetto Date
someBirthday con i parametri
year (
1974),
month (
10 = novembre),
day (
30),
hour (
1) e
minute (
20). Il metodo
getDay() viene quindi chiamato due volte, prima per visualizzare il giorno del mese (6), e quindi, per visualizzare il giorno della settimana mediante
weekDayLabels.
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
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce l'anno completo (un numero di quattro cifre, ad esempio 2000) specificato dall'oggetto Date, in base all'ora locale. La data e l'ora locali vengono determinate in base al sistema operativo su cui Flash Player è in esecuzione.
Restituisce
| Number — L'anno completo rappresentato da un oggetto Date.
|
Esempio
Nell'esempio seguente viene illustrato come creare un nuovo oggetto Date
someBirthday con i parametri
year (
1974),
month (
10 = novembre),
day (
30),
hour (
1) e
minute (
20). Quindi, viene chiamato il metodo
getFullYear(), che recupera l'anno completo a quattro cifre.
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
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce l'ora (un numero intero compreso tra 0 e 23) della porzione del giorno specificata da un oggetto Date, in base all'ora locale. La data e l'ora locali vengono determinate in base al sistema operativo su cui Flash Player è in esecuzione.
Restituisce
| Number — L'ora (0-23) del giorno rappresentato da un oggetto Date.
|
Esempio
Nell'esempio seguente viene illustrato come creare un nuovo oggetto Date
someBirthday con i parametri
year (
1974),
month (
10 = novembre),
day (
30),
hour (
1) e
minute (
20). I metodi
getHours() e
getMinutes() vengono chiamati per recuperare le ore e i minuti nel formato a 24 ore. Infine, viene creata una stringa
localTime che viene assegnata al risultato di una chiamata alla funzione
getUSClockTime() che, a sua volta, chiama di nuovo
getHours() e
getMinutes(), dando come risultato l'ora
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
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce la porzione dei millisecondi (un numero intero compreso tra 0 e 999) specificata dall'oggetto Date, in base all'ora locale. La data e l'ora locali vengono determinate in base al sistema operativo su cui Flash Player è in esecuzione.
Restituisce
| Number — La porzione dei millisecondi di un oggetto Date.
|
Esempio
L'esempio seguente crea un nuovo oggetto Date
now senza parametri. Quindi, viene chiamato il metodo
getMilliseconds(), che recupera i millisecondi dell'oggetto Date
now al momento della sua creazione.
var now:Date = new Date();
trace(now.getMilliseconds());
AS3 function getMinutes():Number
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce la porzione dei minuti (un numero intero compreso tra 0 e 59) specificata dall'oggetto Date, in base all'ora locale. La data e l'ora locali vengono determinate in base al sistema operativo su cui Flash Player è in esecuzione.
Restituisce
| Number — La porzione dei minuti di un oggetto Date.
|
Esempio
L'esempio seguente crea un nuovo oggetto Date
now senza parametri. Quindi, viene chiamato il metodo
getMinutes(), che recupera i minuti dell'oggetto Date
now al momento della sua creazione.
var now:Date = new Date();
trace(now);
trace(now.getMinutes());
AS3 function getMonth():Number
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce la porzione del mese (0 per gennaio, 1 per febbraio, e così via) specificata dall'oggetto Date, in base all'ora locale. La data e l'ora locali vengono determinate in base al sistema operativo su cui Flash Player è in esecuzione.
Restituisce
| Number — La porzione del mese (0-11) di un oggetto Date.
|
Esempio
L'esempio seguente crea un nuovo oggetto Array
monthLabels con gli elementi compresi nell'intervallo da
January a
December e un nuovo oggetto Date
now senza parametri. Il metodo
getMonth() viene quindi chiamato due volte per restituire prima il numero del mese e quindi il nome del mese in cui è stato creato l'oggetto Date
now.
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
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce la porzione dei secondi (un numero intero compreso tra 0 e 59) specificata dall'oggetto Date, in base all'ora locale. La data e l'ora locali vengono determinate in base al sistema operativo su cui Flash Player è in esecuzione.
Restituisce
| Number — La porzione dei secondi (0-59) di un oggetto Date.
|
Esempio
L'esempio seguente crea un nuovo oggetto Date
now senza parametri. Quindi, viene chiamato il metodo
getSeconds(), che recupera i secondi dell'oggetto Date
now al momento della sua creazione.
var now:Date = new Date();
trace(now.getSeconds());
AS3 function getTime():Number
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce il numero di millisecondi trascorsi a partire dalla mezzanotte del 1 gennaio 1970 (ora universale) per un oggetto Date. Utilizzare questo metodo per rappresentare un istante specifico nel tempo in cui confrontare due o più oggetti Date.
Nota: il metodo getTime() incorpora gli anni bisestili, in modo che l'esecuzione di operazioni aritmetiche con gli oggetti Date non richieda logica aggiuntiva per le modifiche relative all'anno bisestile.
Restituisce
| Number — Il numero di millisecondi trascorsi a partire dal 1 gennaio 1970 rappresentato da un oggetto Date.
|
Esempio
L'esempio seguente crea un nuovo oggetto Date
mlk con i parametri
year (
1929),
month (
0 = gennaio) e
day (
15). Quindi, viene chiamato il metodo
getTime(), che recupera i millisecondi trascorsi dal 1 gennaio 1970, restituendo un valore negativo dal momento che l'anno impostato è 1929.
var mlk:Date = new Date(1929, 0, 15);
trace(mlk); // Tue Jan 15 00:00:00 GMT-0800 1929
trace(mlk.getTime()); // -1292601600000
L'esempio seguente crea un nuovo oggetto Date
now senza parametri e utilizza i metodi della classe DateMath (creati di seguito) per aggiungere all'oggetto Date originale
now il tempo trascorso dal momento della sua creazione:
addSeconds(): aggiunge 30 secondi a now.
addMinutes(): aggiunge 30 minuti a now.
addHours(): aggiunge 6 ore all'oggetto Date now.
addDays(): aggiunge 30 giorni all'oggetto Date now.
addWeeks(): aggiunge 4 settimane a now.
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
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce la differenza, espressa in minuti, tra l'ora universale (UTC) e l'ora locale del computer.
Restituisce
| Number — I minuti che è necessario aggiungere all'ora locale del computer in modo che corrisponda all'ora universale (UTC). Se l'ora del computer è successiva all'ora universale, il valore restituito è negativo.
|
Esempio
L'esempio seguente crea un nuovo oggetto Date
now senza parametri. Quindi, viene chiamato il metodo
getTimezoneOffset(), che recupera la differenza (espressa in minuti) tra l'ora in cui è stato creato
now e l'ora universale. Quindi, dividendo il risultato per 60, l'offset del fuso orario viene convertito in ore.
var date:Date = new Date();
trace(date.getTimezoneOffset() / 60);
AS3 function getUTCDate():Number
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce il giorno del mese (un numero intero compreso tra 1 e 31) di un oggetto Date, in base all'ora universale (UTC).
Restituisce
| Number — Il giorno del mese UTC (1-31) rappresentato da un oggetto Date.
|
Vedere anche
Esempio
Nell'esempio seguente viene illustrato come creare un nuovo oggetto Date
someBirthday con i parametri
year (
1974),
month (
10 = novembre),
day (
30),
hour (
1) e
minute (
20). Quindi, viene chiamato il metodo
getUTCDate(), che recupera il giorno del mese, in base all'ora universale (UTC).
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
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce il giorno della settimana (0 per domenica, 1 per lunedì, e così via) dell'oggetto Date, in base all'ora universale (UTC).
Restituisce
| Number — Il giorno della settimana UTC (0-6) rappresentato da un oggetto Date.
|
Vedere anche
Esempio
Nell'esempio seguente viene illustrato come creare un nuovo oggetto Array
weekDayLabels con gli elementi
[Sunday,Monday,Tuesday,Wednesday,Thursday,Friday,Saturday] e un nuovo oggetto Date
someBirthday con i parametri
year (
1974),
month (
10 = novembre),
day (
30),
hour (
1) e
minute (
20). Il metodo
getUTCDay() viene quindi chiamato due volte, prima per visualizzare il giorno del mese (6), e quindi, per visualizzare il giorno della settimana mediante
weekDayLabels, in base all'ora universale (UTC).
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
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce l'anno completo (un numero di quattro cifre) di un oggetto Date, in base all'ora universale (UTC).
Restituisce
| Number — L'anno UTC a quattro cifre rappresentato da un oggetto Date.
|
Vedere anche
Esempio
Nell'esempio seguente viene illustrato come creare un nuovo oggetto Date
someBirthday con i parametri
year (
1974),
month (
10 = novembre),
day (
30),
hour (
1) e
minute (
20). Quindi, viene chiamato il metodo
getUTCFullYear(), che recupera l'anno completo a quattro cifre, in base all'ora universale (UTC).
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
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce l'ora (un numero intero compreso tra 0 e 23) del giorno di un oggetto Date, in base all'ora universale (UTC).
Restituisce
| Number — L'ora del giorno UTC (0-23) rappresentata da un oggetto Date.
|
Vedere anche
Esempio
Nell'esempio seguente viene illustrato come creare un nuovo oggetto Date
someBirthday con i parametri
year (
1974),
month (
10 = novembre),
day (
30),
hour (
1) e
minute (
20). I metodi
getHours() e
getMinutes() vengono chiamati per recuperare le ore e i minuti nel formato a 24 ore. Infine, viene creata una stringa
localTime che viene assegnata al risultato di una chiamata alla funzione
getUSClockTime() che, a sua volta, chiama di nuovo
getHours() e
getMinutes(), dando come risultato l'ora
03:05 PM. Viene quindi creata una variabile String
utcTime allo stesso modo di
localTime e, in questo caso, il risultato è lo stesso.
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
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce la porzione dei millisecondi (un numero intero compreso tra 0 e 999) di un oggetto Date, in base all'ora universale (UTC).
Restituisce
| Number — La porzione dei millisecondi UTC di un oggetto Date.
|
Esempio
L'esempio seguente crea un nuovo oggetto Date
now senza parametri. Quindi, viene chiamato il metodo
getUTCMilliseconds(), che recupera i millisecondi dell'oggetto Date
now al momento della sua creazione, in base all'ora universale (UTC).
var now:Date = new Date();
trace(now.getUTCMilliseconds());
AS3 function getUTCMinutes():Number
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce la porzione dei minuti (un numero intero compreso tra 0 e 59) di un oggetto Date, in base all'ora universale (UTC).
Restituisce
| Number — La porzione dei minuti UTC di un oggetto Date.
|
Esempio
L'esempio seguente crea un nuovo oggetto Date
now senza parametri. Quindi, viene chiamato il metodo
getUTCMinutes(), che recupera i minuti dell'oggetto Date
now al momento della sua creazione, in base all'ora universale (UTC).
var now:Date = new Date();
trace(now.getUTCMinutes());
AS3 function getUTCMonth():Number
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce la porzione del mese (da 0 per gennaio a 11 per dicembre) di un oggetto Date in base all'ora universale (UTC).
Restituisce
| Number — La porzione del mese UTC di un oggetto Date.
|
Vedere anche
Esempio
L'esempio seguente crea un nuovo oggetto Array
monthLabels con gli elementi compresi nell'intervallo da
January a
December e un nuovo oggetto Date
now senza parametri. Il metodo
getUTCMonth() viene quindi chiamato due volte per restituire prima il numero del mese e quindi il nome del mese in cui è stato creato l'oggetto Date
now, in base all'ora universale (UTC).
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
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce la porzione dei secondi (un numero intero compreso tra 0 e 59) di un oggetto Date, in base all'ora universale (UTC).
Restituisce
| Number — La porzione dei secondi UTC di un oggetto Date.
|
Esempio
L'esempio seguente crea un nuovo oggetto Date
now senza parametri. Quindi, viene chiamato il metodo
getUTCSeconds(), che recupera i secondi dell'oggetto Date
now al momento della sua creazione, in base all'ora universale (UTC).
var now:Date = new Date();
trace(now.getUTCSeconds());
public static function parse(date:String):Number
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Converte una stringa che rappresenta una data in un numero uguale al numero di millisecondi trascorsi a partire dal 1 gennaio 1970 UTC.
Parametri
| date:String — Una rappresentazione in formato stringa di una data, conforme al formato dell'output di Date.toString(). Il formato data per l'output di Date.toString() è:
Gio Mes GG HH:MM:SS TZD AAAA
Ad esempio:
Mer Apr 12 15:30:17 GMT-0700 2006.
La designazione del fuso orario (TZD, Time Zone Designation) ha sempre il formato GMT-HHMM o UTC-HHMM, che indica l'offset di ore e minuti relativo all'ora di Greenwich (GMT, Greenwich Mean Time), che oggi è definita ora universale (UTC). I termini relativi ad anno, mese e giorno possono essere separati da una barra (/) o da spazi, ma mai da un trattino (-). Tra gli altri formati supportati ci sono i seguenti (è possibile includere delle rappresentazioni parziali di questi formati; cioè, solo mese, giorno e anno):
MM/GG/AAAA HH:MM:SS TZD HH:MM:SS TZD Gio Mes/GG/AAAA Mes GG AAAA HH:MM:SS TZD Gio Mes GG HH:MM:SS TZD AAAA Gio GG Mes HH:MM:SS TZD AAAA Mes/GG/AAAA HH:MM:SS TZD AAAA/MM/GG HH:MM:SS TZD
|
Restituisce
| Number — Un numero che rappresenta i millisecondi trascorsi a partire dal 1 gennaio 1970 UTC.
|
Vedere anche
Esempio
L'esempio seguente assegna una stringa relativa alla data a
dateParsed per 30 novembre 1974. Quindi, viene chiamato il metodo
Date.parse(), che converte la data in millisecondi a partire dal 1 gennaio 1970.
var dateParsed:String = "Sat Nov 30 1974";
var milliseconds:Number = Date.parse(dateParsed);
trace(milliseconds); // 155030400000
AS3 function setDate(day:Number):Number
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Imposta il giorno del mese, in base all'ora locale, e restituisce il nuovo valore, espresso in millisecondi. La data e l'ora locali vengono determinate in base al sistema operativo su cui Flash Player è in esecuzione.
Parametri
| day:Number — Un numero intero compreso tra 1 e 31.
|
Restituisce
| Number — La nuova ora, espressa in millisecondi.
|
Esempio
Nell'esempio seguente viene illustrato come creare un nuovo oggetto Date
someBirthday con i parametri
year (
1974),
month (
10 = novembre),
day (
30),
hour (
1) e
minute (
20). Quindi, viene chiamato il metodo
getDate(), che recupera il giorno del mese. In seguito, il metodo
setDate() viene chiamato con il parametro
day impostato su
20 e quindi viene chiamato di nuovo il metodo
getDate(), che recupera il giorno del mese appena impostato.
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
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Imposta l'anno, in base all'ora locale, e restituisce il nuovo valore, espresso in millisecondi. Se i parametri month e day vengono specificati, vengono impostati sull'ora locale. La data e l'ora locali vengono determinate in base al sistema operativo su cui Flash Player è in esecuzione.
Se si chiama questo metodo, gli altri campi dell'oggetto Date non vengono modificati, ma è possibile che Date.getUTCDay() e Date.getDay() riportino un nuovo valore se il giorno della settimana cambia come conseguenza della chiamata a questo metodo.
Parametri
| year:Number — Un numero di quattro cifre che specifica un anno. I numeri a due cifre non rappresentano gli anni a quattro cifre; ad esempio, 99 non corrisponde all'anno 1999, bensì all'anno 99.
|
| |
| month:Number — Un numero intero da 0 (gennaio) a 11 (dicembre).
|
| |
| day:Number — Un numero compreso tra 1 e 31.
|
Restituisce
| Number — La nuova ora, espressa in millisecondi.
|
Vedere anche
Esempio
Nell'esempio seguente viene illustrato come creare un nuovo oggetto Date
someBirthday con i parametri
year (
1974),
month (
10 = novembre),
day (
30),
hour (
1) e
minute (
20). Quindi, viene chiamato il metodo
getFullYear(), che recupera l'anno completo a quattro cifre. In seguito, il metodo
setFullYear() viene chiamato con il parametro
year impostato su
2000 e quindi viene chiamato di nuovo il metodo
getFullYear(), che recupera l'anno appena impostato.
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
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Imposta l'ora, in base all'ora locale, e restituisce il nuovo valore, espresso in millisecondi. La data e l'ora locali vengono determinate in base al sistema operativo su cui Flash Player è in esecuzione.
Parametri
| hour:Number — Un numero intero compreso tra 0 (mezzanotte) e 23 (11 PM).
|
| |
| minute:Number — Un numero intero compreso tra 0 e 59.
|
| |
| second:Number — Un numero intero compreso tra 0 e 59.
|
| |
| millisecond:Number — Un numero intero compreso tra 0 e 999.
|
Restituisce
| Number — La nuova ora, espressa in millisecondi.
|
Esempio
Nell'esempio seguente viene illustrato come creare un nuovo oggetto Date
someBirthday con i parametri
year (
1974),
month (
10 = novembre),
day (
30),
hour (
1) e
minute (
20). I metodi
getHours() e
getMinutes() vengono quindi chiamati per recuperare le ore e i minuti. In seguito, il metodo
setHours() viene chiamato con il parametro
hour impostato su
12 e quindi
getHours() e
getMinutes() vengono chiamati di nuovo per recuperare le ore e i minuti appena impostati.
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
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Imposta i millisecondi, in base all'ora locale, e restituisce il nuovo valore, espresso in millisecondi. La data e l'ora locali vengono determinate in base al sistema operativo su cui Flash Player è in esecuzione.
Parametri
| millisecond:Number — Un numero intero compreso tra 0 e 999.
|
Restituisce
| Number — La nuova ora, espressa in millisecondi.
|
Esempio
L'esempio seguente crea un nuovo oggetto Date
now senza parametri. Quindi, viene chiamato il metodo
getMilliseconds(), che recupera i millisecondi dell'ora in cui è stato creato
now. Quindi, viene creato un altro oggetto Date
before con una chiamata aggiuntiva a
setMilliseconds() con il parametro
millisecond impostato su
4 e viene chiamato di nuovo il metodo
getMilliseconds(), che recupera i millisecondi appena impostati.
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
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Imposta i minuti, in base all'ora locale, e restituisce il nuovo valore, espresso in millisecondi. La data e l'ora locali vengono determinate in base al sistema operativo su cui Flash Player è in esecuzione.
Parametri
| minute:Number — Un numero intero compreso tra 0 e 59.
|
| |
| second:Number — Un numero intero compreso tra 0 e 59.
|
| |
| millisecond:Number — Un numero intero compreso tra 0 e 999.
|
Restituisce
| Number — La nuova ora, espressa in millisecondi.
|
Esempio
L'esempio seguente crea un nuovo oggetto Date
now senza parametri. Quindi, viene chiamato il metodo
getMinutes(), che recupera i minuti dell'ora in cui è stato creato
now. Quindi, viene creato un altro oggetto Date
before con una chiamata aggiuntiva a
setMinutes() con il parametro
minute impostato su
0 e viene chiamato di nuovo il metodo
getMinutes(), che recupera i minuti appena impostati.
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
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Imposta il mese e opzionalmente il giorno del mese, in base all'ora locale, e restituisce il nuovo valore, espresso in millisecondi. La data e l'ora locali vengono determinate in base al sistema operativo su cui Flash Player è in esecuzione.
Parametri
| month:Number — Un numero intero da 0 (gennaio) a 11 (dicembre).
|
| |
| day:Number — Un numero intero compreso tra 1 e 31.
|
Restituisce
| Number — La nuova ora, espressa in millisecondi.
|
Esempio
L'esempio seguente crea un nuovo oggetto Array
monthLabels con gli elementi compresi nell'intervallo da
January a
December e un nuovo oggetto Month
now senza parametri. Quindi, viene chiamato il metodo
getMonth(), che recupera il mese in cui è stato creato
now. In seguito, il metodo
setMonth() viene chiamato con il parametro
month impostato su
0 e quindi viene chiamato di nuovo il metodo
getMonth(), che recupera il mese appena impostato.
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
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Imposta i secondi, in base all'ora locale, e restituisce il nuovo valore, espresso in millisecondi. La data e l'ora locali vengono determinate in base al sistema operativo su cui Flash Player è in esecuzione.
Parametri
| second:Number — Un numero intero compreso tra 0 e 59.
|
| |
| millisecond:Number — Un numero intero compreso tra 0 e 999.
|
Restituisce
| Number — La nuova ora, espressa in millisecondi.
|
Esempio
L'esempio seguente crea un nuovo oggetto Date
now senza parametri. Quindi, viene chiamato il metodo
getseconds(), che recupera i secondi dell'ora in cui è stato creato
now. Quindi, il metodo
setSeconds() viene chiamato con il parametro
second impostato su
0 e viene chiamato di nuovo il metodo
getSeconds(), che recupera i secondi appena impostati.
var now:Date = new Date();
trace(now.getSeconds());
now.setSeconds(0);
trace(now.getSeconds()); // 0
AS3 function setTime(millisecond:Number):Number
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Imposta la data, espressa in millisecondi, rispetto alla mezzanotte del 1 gennaio 1970, e restituisce il nuovo valore, espresso in millisecondi.
Parametri
| millisecond:Number — Un valore intero in cui 0 corrisponde alla mezzanotte del 1 gennaio, in base all'ora universale (UTC).
|
Restituisce
| Number — La nuova ora, espressa in millisecondi.
|
Esempio
L'esempio seguente crea un nuovo oggetto Date
now senza parametri. Quindi, viene chiamato il metodo
setTime() con il parametro
millisecond impostato su
-1292601600000, che imposta l'ora su
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
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Imposta il giorno del mese, in base all'ora universale (UTC), e restituisce il nuovo valore, espresso in millisecondi. Se si chiama questo metodo, gli altri campi di un oggetto Date non vengono modificati, ma è possibile che Date.getUTCDay() e Date.getDay() riportino un nuovo valore se il giorno della settimana cambia come conseguenza della chiamata a questo metodo.
Parametri
| day:Number — Un numero; un numero intero compreso tra 1 e 31.
|
Restituisce
| Number — La nuova ora, espressa in millisecondi.
|
Vedere anche
Esempio
Nell'esempio seguente viene illustrato come creare un nuovo oggetto Date
someBirthday con i parametri
year (
1974),
month (
10 = novembre),
day (
30),
hour (
1) e
minute (
20). Quindi, viene chiamato il metodo
getUTCDate(), che restituisce in modo corretto il giorno del mese. In seguito, il metodo
setUTCDate() viene chiamato con il parametro
day impostato su
1 e un'istruzione
trace() conferma che la data è stata impostata correttamente.
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
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Imposta l'anno, in base all'ora universale (UTC), e restituisce il nuovo valore, espresso in millisecondi.
Facoltativamente, questo metodo può anche impostare il mese e il giorno del mese. Se si chiama questo metodo, gli altri campi vengono modificati, ma è possibile che i metodi Date.getUTCDay() e Date.getDay() riportino un nuovo valore se il giorno della settimana cambia come conseguenza della chiamata a questo metodo.
Parametri
| year:Number — Un numero intero che rappresenta l'anno specificato come anno a quattro cifre (ad esempio, 2000).
|
| |
| month:Number — Un numero intero da 0 (gennaio) a 11 (dicembre).
|
| |
| day:Number — Un numero intero compreso tra 1 e 31.
|
Restituisce
Vedere anche
Esempio
Nell'esempio seguente viene illustrato come creare un nuovo oggetto Date
someBirthday con i parametri
year (
1974),
month (
10 = novembre),
day (
30),
hour (
1) e
minute (
20). Quindi, viene chiamato il metodo
getUTCFullYear(), che restituisce in modo corretto l'anno completo a quattro cifre. In seguito, il metodo
setUTCFullYear() viene chiamato con il parametro
year impostato su
1975 e un'istruzione
trace() conferma che la data è stata impostata correttamente.
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
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Imposta l'ora, in base all'ora universale (UTC), e restituisce il nuovo valore, espresso in millisecondi. Facoltativamente, è possibile specificare i minuti, i secondi e i millisecondi.
Parametri
| hour:Number — Un numero intero compreso tra 0 (mezzanotte) e 23 (11 PM).
|
| |
| minute:Number — Un numero intero compreso tra 0 e 59.
|
| |
| second:Number — Un numero intero compreso tra 0 e 59.
|
| |
| millisecond:Number — Un numero intero compreso tra 0 e 999.
|
Restituisce
| Number — La nuova ora, espressa in millisecondi.
|
Esempio
Nell'esempio seguente viene illustrato come creare un nuovo oggetto Date
someBirthday con i parametri
year (
1974),
month (
10 = novembre),
day (
30),
hour (
1) e
minute (
20). I metodi
getHours(),
getMinutes(),
getUTCHours() e
getUTCMinutes() vengono quindi chiamati per recuperare le ore e i minuti. In seguito, il metodo
setUTCHours() viene chiamato con il parametro
hour impostato su
12 e quindi vengono chiamati di nuovo i metodi
getHours(),
getMinutes(),
getUTCHours() e
getUTCMinutes(), che visualizzano in modo corretto l'ora aggiornata.
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
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Imposta i millisecondi, in base all'ora universale (UTC), e restituisce il nuovo valore, espresso in millisecondi.
Parametri
| millisecond:Number — Un numero intero compreso tra 0 e 999.
|
Restituisce
| Number — La nuova ora, espressa in millisecondi.
|
Esempio
L'esempio seguente crea un nuovo oggetto Date
now senza parametri. Quindi, viene chiamato il metodo
getUTCMilliseconds(), che recupera i millisecondi UTC dell'ora in cui è stato creato
now. Quindi, viene creato un altro oggetto Date
before con una chiamata aggiuntiva a
setUTCMilliseconds() con il parametro
millisecond impostato su
4 e viene chiamato di nuovo il metodo
getUTCMilliseconds(), che recupera i millisecondi appena impostati.
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
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Imposta i minuti, in base all'ora universale (UTC), e restituisce il nuovo valore, espresso in millisecondi. Facoltativamente, è possibile specificare i secondi e i millisecondi.
Parametri
| minute:Number — Un numero intero compreso tra 0 e 59.
|
| |
| second:Number — Un numero intero compreso tra 0 e 59.
|
| |
| millisecond:Number — Un numero intero compreso tra 0 e 999.
|
Restituisce
| Number — La nuova ora, espressa in millisecondi.
|
Esempio
L'esempio seguente crea un nuovo oggetto Date
now senza parametri. Quindi, viene chiamato il metodo
getUTCMinutes(), che recupera i minuti UTC dell'ora in cui è stato creato
now. Quindi, viene creato un altro oggetto Date
before con una chiamata aggiuntiva a
setUTCMinutes() con il parametro
minute impostato su
0 e viene chiamato di nuovo il metodo
getUTCMinutes(), che recupera i minuti appena impostati.
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
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Imposta il mese e facoltativamente il giorno, in base all'ora universale (UTC), e restituisce il nuovo valore, espresso in millisecondi. Se si chiama questo metodo, gli altri campi non vengono modificati, ma è possibile che i metodi Date.getUTCDay() e Date.getDay() riportino un nuovo valore se il giorno della settimana cambia come conseguenza della chiamata a questo metodo.
Parametri
| month:Number — Un numero intero da 0 (gennaio) a 11 (dicembre).
|
| |
| day:Number — Un numero intero compreso tra 1 e 31.
|
Restituisce
| Number — La nuova ora, espressa in millisecondi.
|
Vedere anche
Esempio
L'esempio seguente crea un nuovo oggetto Array
UTCMonthLabels con gli elementi compresi nell'intervallo da
January a
December e un nuovo oggetto UTCMonth
now senza parametri. Quindi, viene chiamato il metodo
getUTCMonth(), che recupera il mese UTC in cui è stato creato
now. In seguito, il metodo
setUTCMonth() viene chiamato con il parametro
month impostato su
0 e quindi viene chiamato di nuovo il metodo
getUTCMonth(), che recupera il mese appena impostato.
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
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Imposta i secondi e facoltativamente i millisecondi, in base all'ora universale (UTC), e restituisce il nuovo valore, espresso in millisecondi.
Parametri
| second:Number — Un numero intero compreso tra 0 e 59.
|
| |
| millisecond:Number — Un numero intero compreso tra 0 e 999.
|
Restituisce
| Number — La nuova ora, espressa in millisecondi.
|
Esempio
L'esempio seguente crea un nuovo oggetto Date
now senza parametri. Quindi, viene chiamato il metodo
getUTCSeconds(), che recupera i secondi dell'ora in cui è stato creato
now. Quindi, il metodo
setUTCSeconds() viene chiamato con il parametro
second impostato su
0 e viene chiamato di nuovo il metodo
getUTCSeconds(), che recupera i secondi appena impostati.
var now:Date = new Date();
trace(now.getUTCSeconds());
now.setUTCSeconds(0);
trace(now.getUTCSeconds()); // 0
AS3 function toDateString():String
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce una rappresentazione in formato stringa solo del giorno e della data, e non include l'ora o il fuso orario. In contrasto con i metodi seguenti:
Date.toTimeString(), che restituisce solo l'ora e il fuso orario
Date.toString(), che restituisce non solo il giorno e la data, ma anche l'ora e il fuso orario.
Restituisce
| String — La rappresentazione in formato stringa solo del giorno e della data.
|
Vedere anche
Esempio
L'esempio seguente crea un nuovo oggetto Date
now senza parametri e quindi chiama i seguenti metodi all'interno di un'istruzione
trace()
toString: visualizza tutti i parametri per now al momento in cui è stato creato now.
toDateString(): visualizza i parametri day, month e year per il momento in cui è stato creato now.
var now:Date = new Date();
trace(now);
trace(now.toDateString());
AS3 function toLocaleDateString():String
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce una rappresentazione in formato stringa solo del giorno e della data, e non include l'ora o il fuso orario. Questo metodo restituisce lo stesso valore di Date.toDateString. In contrasto con i metodi seguenti:
Date.toTimeString(), che restituisce solo l'ora e il fuso orario
Date.toString(), che restituisce non solo il giorno e la data, ma anche l'ora e il fuso orario.
Restituisce
| String — La rappresentazione in formato String solo del giorno e della data.
|
Vedere anche
AS3 function toLocaleString():String
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce una rappresentazione in formato stringa del giorno, della data e dell'ora in base all'ora locale. In contrasto con il metodo Date.toString(), che restituisce le stesse informazioni (con l'aggiunta del fuso orario) con l'anno indicato alla fine della stringa.
Restituisce
| String — Una rappresentazione in formato stringa di un oggetto Date in base al fuso orario locale.
|
AS3 function toLocaleTimeString():String
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce una rappresentazione in formato stringa solo dell'ora, e non include il giorno, la data o il fuso orario. In contrasto con il metodo Date.toTimeString(), che restituisce l'ora e il fuso orario.
Restituisce
| String — La rappresentazione in formato stringa solo dell'ora e del fuso orario.
|
Vedere anche
AS3 function toString():String
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce una rappresentazione in formato stringa del giorno, della data, dell'ora e del fuso orario. Il formato data per l'output è:
Gio Mes Data HH:MM:SS TZD AAAA
Ad esempio:
Mer Apr 12 15:30:17 GMT-0700 2006.
Restituisce
| String — La rappresentazione in formato stringa di un oggetto Date.
|
Esempio
L'esempio seguente crea un nuovo oggetto Date
now senza parametri e quindi chiama un'istruzione
toString all'interno di un'istruzione
trace(), che visualizza tutti i parametri per
now al momento in cui è stato creato
now.
var now:Date = new Date();
trace(now);
AS3 function toTimeString():String
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce una rappresentazione in formato stringa solo dell'ora o del fuso orario, e non include il giorno e la data. In contrasto con il metodo Date.toDateString(), che restituisce solo il giorno e la data.
Restituisce
| String — La rappresentazione in formato stringa solo dell'ora e del fuso orario.
|
Vedere anche
AS3 function toUTCString():String
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce una rappresentazione in formato stringa del giorno, della data e dell'ora in base all'ora universale (UTC). Ad esempio, la data 1 febbraio 2005 viene restituita come Tue Feb 1 00:00:00 2005 UTC.
Restituisce
| String — La rappresentazione in formato stringa di un oggetto Date in base all'ora universale (UTC).
|
Vedere anche
public static function UTC(year:Number, month:Number, date:Number = 1, hour:Number = 0, minute:Number = 0, second:Number = 0, millisecond:Number = 0):Number
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce il numero di millisecondi trascorsi tra la mezzanotte del 1 gennaio 1970 (ora universale) e il tempo specificato nei parametri. Questo metodo utilizza l'ora universale, mentre la funzione di costruzione Date utilizza l'ora locale.
Questo metodo è utile se si desidera passare una data UTC alla funzione di costruzione della classe Date. Poiché la funzione di costruzione della classe Date accetta l'offset dei millisecondi come argomento, è possibile utilizzare il metodo Date.UTC() per convertire una data UTC nell'offset dei millisecondi corrispondente e inviare tale offset come argomento alla funzione di costruzione della classe Date:
Parametri
| year:Number — Un numero intero a quattro cifre che rappresenta l'anno (ad esempio, 2000).
|
| |
| month:Number — Un numero intero da 0 (gennaio) a 11 (dicembre).
|
| |
| date:Number (default = 1) — Un numero intero compreso tra 1 e 31.
|
| |
| hour:Number (default = 0) — Un numero intero compreso tra 0 (mezzanotte) e 23 (11 PM).
|
| |
| minute:Number (default = 0) — Un numero intero compreso tra 0 e 59.
|
| |
| second:Number (default = 0) — Un numero intero compreso tra 0 e 59.
|
| |
| millisecond:Number (default = 0) — Un numero intero compreso tra 0 e 999.
|
Restituisce
| Number — Il numero di millisecondi trascorsi a partire dal 1 gennaio 1970 e la data e l'ora specificate.
|
Esempio
Nell'esempio seguente viene illustrato come creare un nuovo oggetto Date
someBirthday con i parametri
year (
1974),
month (
10 = novembre),
day (
30),
hour (
1) e
minute (
20) che utilizzano l'ora locale. Quindi, una chiamata a
UTC() all'interno di un metodo
setTime() reimposta i parametri sull'ora universale.
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
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Restituisce il numero di millisecondi trascorsi a partire dalla mezzanotte del 1 gennaio 1970 (ora universale) per un oggetto Date.
Restituisce
| Number — Il numero di millisecondi trascorsi a partire dal 1 gennaio 1970 rappresentato da un oggetto Date.
|
Esempio
L'esempio seguente crea un nuovo oggetto Date
now senza parametri. Quindi, viene chiamato il metodo
getTime(), che recupera il numero di millisecondi che trascorrono tra il momento in cui è stato creato
now e la mezzanotte del 1 gennaio 1970 e quindi viene chiamato il metodo
valueOf(), che recupera lo stesso valore.
var now:Date = new Date();
trace(now.getTime());
trace(now.valueOf());
L'esempio seguente mostra vari modi di utilizzare la funzione di costruzione
Date() per assegnare le seguenti variabili:
myDate1 chiama Date() senza parametri, che imposta myDate1 sulla data e ora correnti (in base alla data e ora del sistema in uso).
myDate2 chiama Date() passando i parametri year (2000), month (0 = gennaio) e day (1).
myDate3 chiama Date() passando i parametri year (65 = 1965), month (2 = marzo), day (6), hour (9), minute (30), second (15) e millisecond -+ (0).
myDate4 chiama Date() con il valore dell'ora rappresentato dal numero di millisecondi prima (dato che il valore è negativo) delle 0:00:00 GMT del 1 gennaio 1970.
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, 3:14 AM GMT-07:00
Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/Date.html