Oggetto Date

Articolo
09/12/2008

Aggiornamento: novembre 2007

Oggetto che attiva la memorizzazione e il recupero di base dei valori di data e ora. Esistono due forme del costruttore Date.

function Date( [dateVal : { Number | String | System.DateTime } ] )
function Date( year : int, month : int, date : int[, hours : int [, minutes : int [, seconds : int [, ms : int]]]] )

Argomenti

dateVal
Facoltativo. Se è un valore numerico, dateVal rappresenta il numero di millisecondi in formato UTC (Tempo universale coordinato, Universal Coordinated Time) compresi tra la data specificata e la mezzanotte dell'1 gennaio 1970. Se è una stringa, dateVal viene valutato in base alle regole del metodo parse. L'argomento dateVal può anche essere rappresentato da un valore data .NET.
year
Obbligatorio. L'anno completo, ad esempio 1976 (non 76).
month
Obbligatorio. Numero intero compreso tra 0 e 11, da gennaio a dicembre, che rappresenta il mese.
date
Obbligatorio. Numero intero compreso tra 1 e 31 che rappresenta il giorno.
hours
Facoltativo. Obbligatorio se viene specificato l'argomento minutes. Numero intero compreso tra 0 e 23, da mezzanotte alle 23, che rappresenta l'ora.
minutes
Facoltativo. Obbligatorio se viene specificato l'argomento seconds. Numero intero compreso tra 0 e 59 che rappresenta i minuti.
seconds
Facoltativo. Obbligatorio se viene specificato l'argomento milliseconds. Numero intero compreso tra 0 e 59 che rappresenta i secondi.
ms
Facoltativo. Numero intero compreso tra 0 e 999 che rappresenta i millisecondi.

Note

Un oggetto Date include un numero che rappresenta un preciso istante nel tempo fino alla precisione di un millisecondo. Se il valore di un argomento è maggiore del relativo intervallo o è un numero negativo, gli altri valori memorizzati verranno modificati di conseguenza. Se si specifica 150 secondi, ad esempio, il numero verrà convertito in due minuti e 30 secondi.

Se il numero è un valore NaN, l'oggetto non rappresenta un preciso istante nel tempo. Se al costruttore Date non viene passato alcun parametro, verrà inizializzato sul valore di data e ora corrente (in formato UTC). Per poter utilizzare una variabile di tipo Date è necessario prima inizializzarla.

L'intervallo di date che è possibile rappresentare in un oggetto Date è pari a circa 285.616 anni sia prima che dopo la data dell'1 gennaio 1970.

All'oggetto Date sono associati i due metodi statici parse e UTC che vengono chiamati senza creare un oggetto Date.

Se il costruttore Date viene chiamato senza l'operatore new, l'oggetto Date restituito conterrà la data corrente indipendentemente dagli argomenti passati al costruttore.

Nota:
L'oggetto Date interagisce con il tipo di dati System.DateTime di .NET Framework all'interno di JScript. Tuttavia, poiché l'oggetto Date viene fornito solamente da JScript e non deriva da un tipo .NET Framework, non è possibile utilizzare tale oggetto con altri linguaggi compatibili con CLS (Common Language Specification). Per tale motivo, durante l'annotazione del tipo di parametri e tipi restituiti dei metodi compatibili con CLS, assicurarsi di utilizzare il tipo di dati System.DataTime anziché l'oggetto Date. È possibile tuttavia utilizzare l'oggetto Date per l'annotazione del tipo di identificatori diversi dai parametri o dai tipi restituiti. Per ulteriori informazioni, vedere Scrittura di codice compatibile con CLS.

L'oggetto Date interagisce con il tipo di dati System.DateTime di .NET Framework all'interno di JScript. Tuttavia, poiché l'oggetto Date viene fornito solamente da JScript e non deriva da un tipo .NET Framework, non è possibile utilizzare tale oggetto con altri linguaggi compatibili con CLS (Common Language Specification). Per tale motivo, durante l'annotazione del tipo di parametri e tipi restituiti dei metodi compatibili con CLS, assicurarsi di utilizzare il tipo di dati System.DataTime anziché l'oggetto Date. È possibile tuttavia utilizzare l'oggetto Date per l'annotazione del tipo di identificatori diversi dai parametri o dai tipi restituiti. Per ulteriori informazioni, vedere Scrittura di codice compatibile con CLS.

Esempio

Nell'esempio seguente viene utilizzato l'oggetto Date.

var s : String = "Today's date is: ";   // Declare variables.
var d : Date = new Date();              // Create Date object with today's date.
s += (d.getMonth() + 1) + "/";          // Get month
s += d.getDate() + "/";                 // Get day
s += d.getYear();                       // Get year.
print(s);                               // Print date.

Se il programma venisse eseguito il 26 gennaio 1992, l'output sarebbe il seguente: