Метод parse

Статья
11/05/2008

Обновлен: Ноябрь 2007

Выполняет синтаксический анализ строки, содержащей дату, и возвращает количество миллисекунд, истекших с полуночи 1 января 1970 г.

function parse(dateVal : {String | System.DateTime} ) : Number

Аргументы

dateVal
Обязательный. Либо строка, содержащая дату в таком формате, как "5 января 1996 г., 08:47:00", либо значение VT_DATE, извлеченное из объекта ActiveX® или другого объекта.

Заметки

Метод parse возвращает целочисленное значение, представляющее количество миллисекунд, истекших с полуночи 1 января 1970 года до даты, указанной в параметре dateVal.

Метод parse является статическим методом объекта Date. Поскольку это статический метод, он вызывается не как метод созданного объекта Date, а таким способом, который показан в следующем примере.

var datestring = "November 1, 1997 10:15 AM";
Date.parse(datestring)

Для успешного синтаксического анализа строк методом parse требуется выполнение указанных ниже правил.

Краткие даты могут использовать разделитель даты "/" или "-", однако они должны следовать формату месяц/день/год, например "7/20/96".
В длинных датах в форме "10 июля 1995 г." могут год, месяц и день могут располагаться в произвольном порядке, а год может быть представлен в двузначной или четырехзначной форме. Если используется двузначная форма, год должен быть больше или равен 70.
Любой текст в скобках считается комментарием. Скобки могут быть вложенными.
Разделителями являются запятые и пробелы. Разрешается использовать несколько разделителей.
Имена месяцев и дней должны содержать не менее двух знаков. Неуникальные двузначные имена разрешаются в соответствии с последним совпадением. Например, "Ма" разрешается как "Май", а не как "Март".
Указанный день недели пропускается, если он является неверным по отношению к остальной части даты. Например, "Вторник, 9 ноября 1996 г." принимается и анализируется, несмотря на то что в действительности эта дата попадает на пятницу. Результирующий объект Date содержит строку "Пятница, 9 ноября 1996 г.".
JScript обрабатывает все стандартные часовые пояса, а также время в формате UTC и время GMT.
Часы, минуты и секунды разделяются двоеточием, однако все три элемента указывать необязательно. Например, можно указать "10:", "10:11" и "10:11:12".
Если используется время в 24-часовом формате, то при указании значения "PM" для времени после 12 пополудни возникает ошибка. Например, значение "23:15 PM" является ошибкой.
Строка, содержащая недопустимую дату, вызывает ошибку. Например, вызывает ошибку строка, содержащая два значения года или два значения месяца.

Пример

В следующем примере показано использование метода parse. Предоставляется функция с датой, и эта функция возвращает разницу между указанной датой и 1/1/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.
}