Справочник Javascript

Метод parse получает строку с датой (напр. "Jan 03, 2000") и возвращает целое число, представляющее собой количество миллисекунд, истекших с полуночи 1 января 1970 года GMT+0 до даты, указанной в параметре dateVal.

Это статический метод, который можно вызывать без создания объекта даты, поэтому для доступа к нему используется форма Date.parse, а не объект .parse.

Пример:

Выделить все

var d = new Date();
d.setTime(Date.parse("21 May 1958 10:12"));
document.write(d.toLocaleString());
 
// Выведет на экран следующий результат:
Wednesday, May 21, 1958 10:12:00

В случае, если метод parse не смог разобрать переданную ему в качестве параметра строку, он возвращает значение NaN.

Правила разбора строки

Поддерживается стандарт IETF standard (RFC 1123, раздел 5.2.14 и т.д.)

Существуют следующие правила перевода даты из текстовой строки:

• Для краткого формата даты допускается использование разделителей "/" или "-", но порядок элементов должен быть строго "месяц/день/год", например "7/20/96".
• Для полного формата даты порядок указания элементов может быть произвольным. Если используется два знака для обозначения года, то число должно быть меньше 70 для указания 21-го века. Например "July 10 1995".
• Любой текст в круглых скобках рассматривается как комментарии. Комментарии могут быть вложенными, например: "July 10 1995 (this (1234) is a comment)".
• Запятые и пробелы рассматриваются как разделители, могут повторяться.
• Месяца и дни недели должны иметь два и больше знаков. Если в двузначном написании элементы становятся идентичными, то используется последнее значение, например "Ju" это Июль, а не Июнь.
• Если в полном формате даты указан неверный день недели, то он игнорируется.
  Яваскрипт обрабатывает все стандартные временные зоны, включая UTC и GMT.
• Значения для часов, минут и секунд могут быть пропущены, например "10:", "10:11", и "10:11:12".
• Если время указано в 24-часовом формате, то указание полудня считается ошибкой, например "23:15 PM" - ошибка.
• Строка, содержащая неправильную дату - ошибочна. Например, строка содержащая два года или два месяца.

Пример:

Выделить все

IPOdate.setTime(Date.parse("Aug 9, 1995")) ;
 
// Возвращает 807937200000 в зоне GMT-0300, 
// и другие значения в других зонах, так как зона
// не указана в аргументе
Date.parse("Aug 9, 1995");
 
// Возвращает 807926400000 в любой зоне.
Date.parse("Wed, 09 Aug 1995 00:00:00 GMT");