Metodo parse
Aggiornamento: novembre 2007
Analizza una stringa contenente una data e restituisce il numero di millisecondi compresi tra tale data e la mezzanotte dell'1 gennaio 1970.
function parse(dateVal : {String | System.DateTime} ) : Number
Argomenti
- dateVal
Obbligatorio. Stringa contenente una data in un formato quale "5 gen 1996 8:47:00" oppure valore VT_DATE ottenuto da un oggetto ActiveX® o da un altro oggetto.
Note
Mediante il metodo parse viene restituito un numero intero che rappresenta il numero di millisecondi compresi tra la mezzanotte dell'1 gennaio 1970 e la data specificata in dateVal.
Il metodo parse è un metodo statico dell'oggetto Date. Poiché è un metodo statico, non viene richiamato come metodo di un oggetto Date esistente, ma nel modo seguente:
var datestring = "November 1, 1997 10:15 AM";
Date.parse(datestring)
Per gli elementi che possono essere analizzati mediante il metodo parse sono valide le seguenti regole:
Per il formato di data breve è possibile utilizzare il separatore di data "/" o "-", ma deve essere utilizzato il formato mese/giorno/anno, ad esempio "7/20/1996".
Per il formato di data estesa, ad esempio "10 luglio 1995", è possibile specificare l'anno, il mese (in lingua inglese) e il giorno in qualsiasi ordine e per l'anno può essere specificato un valore a due o a quattro cifre. Se si utilizza un valore a due cifre per l'anno, deve essere uguale o maggiore di 70.
Il testo tra parentesi viene considerato un commento. Le parentesi possono essere nidificate.
Virgole e spazi sono entrambi utilizzabili come delimitatori. È possibile specificare più delimitatori.
I nomi di mesi e giorni devono includere due o più caratteri. Se i due caratteri non consentono di identificare il nome in modo univoco, viene considerata valida l'ultima occorrenza. Se, ad esempio, si specifica "Ju", i due caratteri verranno interpretati come "July" e non come "June".
Il giorno della settimana viene ignorato se non è corretto in base al resto della data specificata. La data "Tuesday November 9 1996", ad esempio, verrà accettata e analizzata anche se il giorno della settimana corretto è venerdì e non martedì. L'oggetto Date risultante conterrà "Friday November 9 1996".
In JScript vengono gestiti tutti i fusi orari standard, oltre all'ora UTC (Tempo universale coordinato, Universal Coordinated Time) e all'ora di Greenwich (GMT).
Ore, minuti e secondi sono separati da virgole, sebbene non sia necessario specificare tutti questi valori. "10:", "10:11" e "10:11:12" sono tutti formati validi.
Se viene utilizzato il formato di 24 ore, l'indicazione di "PM" per le ore successive a mezzogiorno viene considerata un errore. Ad esempio, "23:15 PM" è un errore.
Una stringa contenente una data non valida rappresenta un errore. Una stringa contenente, ad esempio, due valori di anno o di mese viene considerata un errore.
Esempio
Nell'esempio seguente viene illustrato l'utilizzo del metodo parse. Fornendo alla funzione una data, verrà restituita la differenza tra la data fornita e l'1 gennaio 1970:
function GetTimeTest(testdate){
var s, t; //Declare variables.
var MinMilli = 1000 * 60; //Initialize variables.
var HrMilli = MinMilli * 60;
var DyMilli = HrMilli * 24;
t = Date.parse(testdate); //Parse testdate.
s = "There are " //Create return string.
s += Math.round(Math.abs(t / DyMilli)) + " days "
s += "between " + testdate + " and 1/1/70";
return(s); //Return results.
}