PacchettoPrimo livello
Classepublic final dynamic class Date
EreditarietàDate Inheritance Object

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:

La versione 5 di Flash Player gestisce l'ora legale sui seguenti sistemi operativi nel modo indicato di seguito:

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

Vedere anche

flash.utils.getTimer()
Operazioni con data e ora


Proprietà pubbliche
 ProprietàDefinito da
 Inheritedconstructor: Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
  date: Number
Il giorno del mese (un numero intero compreso tra 1 e 31) specificato dall'oggetto Date, in base all'ora locale.
Date
  dateUTC: Number
Il giorno del mese (un numero intero compreso tra 1 e 31) di un oggetto Date, in base all'ora universale (UTC).
Date
  day: Number
[sola lettura] Il giorno della settimana (0 per domenica, 1 per lunedì, e così via) specificato dall'oggetto Date, in base all'ora locale.
Date
  dayUTC: Number
[sola lettura] Il giorno della settimana (0 per domenica, 1 per lunedì e così via) dell'oggetto Date, in base all'ora universale (UTC).
Date
  fullYear: Number
L'anno completo (un numero di quattro cifre, ad esempio 2000) specificato dall'oggetto Date, in base all'ora locale.
Date
  fullYearUTC: Number
L'anno completo a quattro cifre di un oggetto Date, in base all'ora universale (UTC).
Date
  hours: Number
L'ora (un numero intero compreso tra 0 e 23) della porzione del giorno di un oggetto Date, in base all'ora locale.
Date
  hoursUTC: Number
L'ora (un numero intero compreso tra 0 e 23) del giorno di un oggetto Date, in base all'ora universale (UTC).
Date
  milliseconds: Number
La porzione dei millisecondi (un numero intero compreso tra 0 e 999) di un oggetto Date, in base all'ora locale.
Date
  millisecondsUTC: Number
La porzione dei millisecondi (un numero intero compreso tra 0 e 999) di un oggetto Date, in base all'ora universale (UTC).
Date
  minutes: Number
La porzione dei minuti (un numero intero compreso tra 0 e 59) di un oggetto Date, in base all'ora locale.
Date
  minutesUTC: Number
La porzione dei minuti (un numero intero compreso tra 0 e 59) di un oggetto Date, in base all'ora universale (UTC).
Date
  month: Number
La porzione del mese (0 per gennaio, 1 per febbraio, e così via) di un oggetto Date, in base all'ora locale.
Date
  monthUTC: Number
La porzione del mese (da 0 per gennaio a 11 per dicembre) di un oggetto Date in base all'ora universale (UTC).
Date
 Inheritedprototype: Object
[statico] Un riferimento all'oggetto prototipo di un oggetto classe o funzione.
Object
  seconds: Number
La porzione dei secondi (un numero intero compreso tra 0 e 59) di un oggetto Date, in base all'ora locale.
Date
  secondsUTC: Number
La porzione dei secondi (un numero intero compreso tra 0 e 59) di un oggetto Date, in base all'ora universale (UTC).
Date
  time: Number
Il numero di millisecondi trascorsi a partire dalla mezzanotte del 1 gennaio 1970 (ora universale) per un oggetto Date.
Date
  timezoneOffset: Number
[sola lettura] La differenza, espressa in minuti, tra l'ora universale (UTC) e l'ora locale del computer.
Date
Metodi pubblici
 MetodoDefinito da
  
Date(yearOrTimevalue:Object, month:Number, date:Number = 1, hour:Number = 0, minute:Number = 0, second:Number = 0, millisecond:Number = 0)
Crea un nuovo oggetto Date che contiene la data e l'ora specificate.
Date
  
Restituisce il giorno del mese (un numero intero compreso tra 1 e 31) specificato dall'oggetto Date, in base all'ora locale.
Date
  
Restituisce il giorno della settimana (0 per domenica, 1 per lunedì, e così via) specificato dall'oggetto Date, in base all'ora locale.
Date
  
Restituisce l'anno completo (un numero di quattro cifre, ad esempio 2000) specificato dall'oggetto Date, in base all'ora locale.
Date
  
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.
Date
  
Restituisce la porzione dei millisecondi (un numero intero compreso tra 0 e 999) specificata dall'oggetto Date, in base all'ora locale.
Date
  
Restituisce la porzione dei minuti (un numero intero compreso tra 0 e 59) specificata dall'oggetto Date, in base all'ora locale.
Date
  
Restituisce la porzione del mese (0 per gennaio, 1 per febbraio, e così via) specificata dall'oggetto Date, in base all'ora locale.
Date
  
Restituisce la porzione dei secondi (un numero intero compreso tra 0 e 59) specificata dall'oggetto Date, in base all'ora locale.
Date
  
Restituisce il numero di millisecondi trascorsi a partire dalla mezzanotte del 1 gennaio 1970 (ora universale) per un oggetto Date.
Date
  
Restituisce la differenza, espressa in minuti, tra l'ora universale (UTC) e l'ora locale del computer.
Date
  
Restituisce il giorno del mese (un numero intero compreso tra 1 e 31) di un oggetto Date, in base all'ora universale (UTC).
Date
  
Restituisce il giorno della settimana (0 per domenica, 1 per lunedì, e così via) dell'oggetto Date, in base all'ora universale (UTC).
Date
  
Restituisce l'anno completo (un numero di quattro cifre) di un oggetto Date, in base all'ora universale (UTC).
Date
  
Restituisce l'ora (un numero intero compreso tra 0 e 23) del giorno di un oggetto Date, in base all'ora universale (UTC).
Date
  
Restituisce la porzione dei millisecondi (un numero intero compreso tra 0 e 999) di un oggetto Date, in base all'ora universale (UTC).
Date
  
Restituisce la porzione dei minuti (un numero intero compreso tra 0 e 59) di un oggetto Date, in base all'ora universale (UTC).
Date
  
Restituisce la porzione del mese (da 0 per gennaio a 11 per dicembre) di un oggetto Date, in base all'ora universale (UTC).
Date
  
Restituisce la porzione dei secondi (un numero intero compreso tra 0 e 59) di un oggetto Date, in base all'ora universale (UTC).
Date
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
  
[statico] Converte una stringa che rappresenta una data in un numero uguale al numero di millisecondi trascorsi a partire dal 1 gennaio 1970 UTC.
Date
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
  
Imposta il giorno del mese, in base all'ora locale, e restituisce il nuovo valore, espresso in millisecondi.
Date
  
setFullYear(year:Number, month:Number, day:Number):Number
Imposta l'anno, in base all'ora locale, e restituisce il nuovo valore, espresso in millisecondi.
Date
  
setHours(hour:Number, minute:Number, second:Number, millisecond:Number):Number
Imposta l'ora, in base all'ora locale, e restituisce il nuovo valore, espresso in millisecondi.
Date
  
Imposta i millisecondi, in base all'ora locale, e restituisce il nuovo valore, espresso in millisecondi.
Date
  
setMinutes(minute:Number, second:Number, millisecond:Number):Number
Imposta i minuti, in base all'ora locale, e restituisce il nuovo valore, espresso in millisecondi.
Date
  
Imposta il mese e opzionalmente il giorno del mese, in base all'ora locale, e restituisce il nuovo valore, espresso in millisecondi.
Date
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
  
setSeconds(second:Number, millisecond:Number):Number
Imposta i secondi, in base all'ora locale, e restituisce il nuovo valore, espresso in millisecondi.
Date
  
setTime(millisecond:Number):Number
Imposta la data, espressa in millisecondi, rispetto alla mezzanotte del 1 gennaio 1970, e restituisce il nuovo valore, espresso in millisecondi.
Date
  
Imposta il giorno del mese, in base all'ora universale (UTC), e restituisce il nuovo valore, espresso in millisecondi.
Date
  
Imposta l'anno, in base all'ora universale (UTC), e restituisce il nuovo valore, espresso in millisecondi.
Date
  
setUTCHours(hour:Number, minute:Number, second:Number, millisecond:Number):Number
Imposta l'ora, in base all'ora universale (UTC), e restituisce il nuovo valore, espresso in millisecondi.
Date
  
Imposta i millisecondi, in base all'ora universale (UTC), e restituisce il nuovo valore, espresso in millisecondi.
Date
  
setUTCMinutes(minute:Number, second:Number, millisecond:Number):Number
Imposta i minuti, in base all'ora universale (UTC), e restituisce il nuovo valore, espresso in millisecondi.
Date
  
Imposta il mese e facoltativamente il giorno, in base all'ora universale (UTC), e restituisce il nuovo valore, espresso in millisecondi.
Date
  
setUTCSeconds(second:Number, millisecond:Number):Number
Imposta i secondi e facoltativamente i millisecondi, in base all'ora universale (UTC), e restituisce il nuovo valore, espresso in millisecondi.
Date
  
Restituisce una rappresentazione in formato stringa solo del giorno e della data, e non include l'ora o il fuso orario.
Date
  
Restituisce una rappresentazione in formato stringa solo del giorno e della data, e non include l'ora o il fuso orario.
Date
  
Restituisce una rappresentazione in formato stringa del giorno, della data e dell'ora in base all'ora locale.
Date
  
Restituisce una rappresentazione in formato stringa solo dell'ora, e non include il giorno, la data o il fuso orario.
Date
  
Restituisce una rappresentazione in formato stringa del giorno, della data, dell'ora e del fuso orario.
Date
  
Restituisce una rappresentazione in formato stringa solo dell'ora o del fuso orario, e non include il giorno e la data.
Date
  
Restituisce una rappresentazione in formato stringa del giorno, della data e dell'ora in base all'ora universale (UTC).
Date
  
UTC(year:Number, month:Number, date:Number = 1, hour:Number = 0, minute:Number = 0, second:Number = 0, millisecond:Number = 0):Number
[statico] Restituisce il numero di millisecondi trascorsi tra la mezzanotte del 1 gennaio 1970 (ora universale) e il tempo specificato nei parametri.
Date
  
Restituisce il numero di millisecondi trascorsi a partire dalla mezzanotte del 1 gennaio 1970 (ora universale) per un oggetto Date.
Date
Descrizione delle proprietà
dateproprietà
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

dateUTCproprietà 
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

dayproprietà 
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

dayUTCproprietà 
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

fullYearproprietà 
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

fullYearUTCproprietà 
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

hoursproprietà 
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

hoursUTCproprietà 
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

millisecondsproprietà 
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

millisecondsUTCproprietà 
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

minutesproprietà 
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

minutesUTCproprietà 
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

monthproprietà 
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

monthUTCproprietà 
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

secondsproprietà 
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

secondsUTCproprietà 
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

timeproprietà 
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

timezoneOffsetproprietà 
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

Descrizione della funzione di costruzione
Date()Funzione di costruzione
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 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:

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

Descrizione dei metodi
getDate()metodo
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
        }
    }
}
getDay()metodo 
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
getFullYear()metodo 
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
getHours()metodo 
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;
}
getMilliseconds()metodo 
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());
getMinutes()metodo 
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());
getMonth()metodo 
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()]);
getSeconds()metodo 
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());
getTime()metodo 
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);
    }
}
getTimezoneOffset()metodo 
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);
getUTCDate()metodo 
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
getUTCDay()metodo 
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
getUTCFullYear()metodo 
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
getUTCHours()metodo 
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;
}
getUTCMilliseconds()metodo 
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());
getUTCMinutes()metodo 
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());
getUTCMonth()metodo 
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()]);
getUTCSeconds()metodo 
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());
parse()metodo 
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
setDate()metodo 
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
setFullYear()metodo 
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
setHours()metodo 
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
setMilliseconds()metodo 
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());
setMinutes()metodo 
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());
setMonth()metodo 
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
setSeconds()metodo 
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
setTime()metodo 
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
setUTCDate()metodo 
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
setUTCFullYear()metodo 
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
Number — Un numero intero.

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
setUTCHours()metodo 
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
setUTCMilliseconds()metodo 
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());
setUTCMinutes()metodo 
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());
setUTCMonth()metodo 
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
setUTCSeconds()metodo 
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
toDateString()metodo 
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:

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());
toLocaleDateString()metodo 
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:

Restituisce
String — La rappresentazione in formato String solo del giorno e della data.

Vedere anche

toLocaleString()metodo 
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.
toLocaleTimeString()metodo 
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

toString()metodo 
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);
toTimeString()metodo 
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

toUTCString()metodo 
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

UTC()metodo 
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());
valueOf()metodo 
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());
Esempi Come utilizzare gli esempi
DateExample.as

L'esempio seguente mostra vari modi di utilizzare la funzione di costruzione Date() per assegnare le seguenti variabili:

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
        }        
    }    
}




 

Inviami un messaggio e-mail quando vengono aggiunti dei commenti a questa | Rapporto sui commenti

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/Date.html