parse-Methode
Aktualisiert: November 2007
Analysiert eine Zeichenfolge mit einem Datum und gibt die Anzahl der Millisekunden zwischen diesem Datum und Mitternacht des 1. Januars 1970 zurück.
function parse(dateVal : {String | System.DateTime} ) : Number
Argumente
- dateVal
Erforderlich. Entweder eine Zeichenfolge mit einem Datum, z. B. im Format "5. Jan 2005 08:47:00", oder ein VT_DATE-Wert, der von einem ActiveX®-Objekt oder einem anderen Objekt abgerufen wurde.
Hinweise
Die parse-Methode gibt einen ganzzahligen Wert zurück, der der Anzahl der Millisekunden zwischen Mitternacht des 1. Januar 1970 und dem mit dateVal übergebenen Datum entspricht.
Die parse-Methode ist eine statische Methode des Date-Objekts. Da es sich um eine statische Methode handelt, wird sie wie im folgenden Beispiel gezeigt aufgerufen und nicht als Methode eines generierten Date-Objekts.
var datestring = "November 1, 1997 10:15 AM";
Date.parse(datestring)
Die folgenden Regeln bestimmen, was von der parse-Methode analysiert werden kann:
Ein kurzes Datumsformat kann entweder "/" oder "-" als Trennzeichen enthalten, muss aber das amerikanische Format Monat/Tag/Jahr, z. B. "7/20/96", aufweisen.
Ein langes Datum in der Form "10. Juli 1995" kann mit Jahr, Monat und Tag in beliebiger Reihenfolge angegeben werden, wobei das Jahr 2 oder 4 Stellen haben kann. Wenn Sie die 2-stellige Form verwenden, muss die Jahreszahl größer oder gleich 70 sein.
Jeder Text in Klammern wird als Kommentar behandelt. Die Klammern können geschachtelt werden.
Kommas und Leerzeichen werden als Begrenzungszeichen behandelt. Mehrfache Begrenzungszeichen sind erlaubt.
Die Namen der Monate oder Tage müssen mindestens zwei Zeichen lang sein. Namen mit zwei Zeichen, die nicht eindeutig sind, werden der letzten Übereinstimmung zugeordnet. Beispiel: "Ju" resultiert in Juli, nicht Juni.
Ein in Bezug auf den Rest des Datums falsch angegebener Wochentag wird ignoriert. Beispiel: "Dienstag 9. November 1996" wird akzeptiert und analysiert, obwohl der Tag tatsächlich ein Freitag ist. Das resultierende Date-Objekt enthält "Freitag 9. November 1996".
Alle Standardzeitzonen sowie UTC (Universal Coordinated Time) und GMT (Greenwich Mean Time) werden von JScript verarbeitet.
Stunden, Minuten und Sekunden werden durch Doppelpunkte getrennt. Es müssen jedoch nicht alle Zeiteinheiten angegeben werden. "10:", "10:11" und "10:11:12" sind alle gültig.
Wird die 24-Stunden-Zeiteinteilung verwendet, ist der Zusatz von "PM" für Werte größer als 12 Uhr falsch. "23:15 PM" ist z. B. falsch.
Eine Zeichenfolge mit einem ungültigen Datum verursacht einen Fehler. So sind z. B. Zeichenfolgen mit zwei Jahresangaben oder zwei Monatsangaben falsch.
Beispiel
Das folgende Beispiel veranschaulicht die Verwendung der parse-Methode. Geben Sie für die Funktion ein Datum an. Die Funktion gibt den Unterschied zwischen dem angegebenen Datum und dem 1. 1. 1970 zurück:
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.
}