parse

Описание

Анализирует строку, содержащую дату, и возвращает число миллисекунд между данной датой и полуночью 1 января 1970.

Синтаксис

Аргумент dateVal – это либо строка, содержащая дату в формате: "Jan 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 может успешно анализировать:

• Короткие даты могут использовать разделители для даты, как "/" или "-", но должны следовать формату month/day/year (месяц/день/год), например "7/20/96".
• Длинные даты формы "July 10 1995" могут даваться с годом, месяцем и днем в любом порядке, а год в 2-х или 4-х числовом формате. Если вы используете форму с 2-я числами, то год должен быть больше или равен 70.
• Любой текст внутри скобок воспринимается как комментарий. Эти скобки могут быть вложенными.
• Запятые и пробелы воспринимаются как разделители. Разрешены множественные разделители.
• Названия месяцев и дней должны иметь два или больше символов. Имена из двух символов, которые не уникальны, разрешены, как последнее согласование. Например, "Ju" разрешен для July, но не для June.
• Установленный день недели игнорируется, если он не корректный для данной даты. Например, "Tuesday November 9 1996" принимается и анализируется, даже если такая дата выпадает на пятницу (Friday). Результирующий объект Date содержит "Friday November 9 1996".
• JavaScript работает со всеми стандартными временными поясами, а также с Универсальным синхронизированным временем (Universal Coordinated Time (UTC)) и Средним временем по Гринвичу (Greenwich Mean Time (GMT)).
• Часы, минуты и секунды разделяются двоеточием, хотя они и не все определены. "10:", "10:11", and "10:11:12" – все корректные выражения.
• Если часы в 24-часовом режиме, то будет ошибочно определять "PM" для времени после 12 часов дня. Например, "23:15 PM" - ошибка.
• Строка, содержащая некорректную дату, является ошибкой. Например, строка с двумя годами или с двумя месяцами – ошибка.

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

function GetTimeTest(testdate)
{
  var d, s, t;
  var MinMilli = 1000 * 60;
  var HrMilli = MinMilli * 60;
  var DyMilli = HrMilli * 24;
  d = new Date();
  t = Date.parse(testdate);
  s = "There are "
  s += Math.round(Math.abs(t / DyMilli)) + " days "
  s += "between " + testdate + " and 1/1/70";
  return(s);
}