Freigeben über


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

Anforderungen

Version 1

Betrifft:

Date-Objekt

Siehe auch

Weitere Ressourcen

Methoden