Date.parse()

Статический метод Date.parse() анализирует строковое представление даты и возвращает отметку времени (timestamp) этой даты.

Попробуйте

// Standard date-time string format
const unixTimeZero = Date.parse("1970-01-01T00:00:00Z");
// Non-standard format resembling toUTCString()
const javaScriptRelease = Date.parse("04 Dec 1995 00:12:00 GMT");

console.log(unixTimeZero);
// Expected output: 0

console.log(javaScriptRelease);
// Expected output: 818035920000

Синтаксис

Date.parse(dateString)

Параметры

dateString

Строка в формате строки даты и времени. См. связанную ссылку для предупреждений об использовании различных форматов.

Возвращаемое значение

Число, представляющее отметку времени (timestamp) заданной даты. Если dateString не удается разобрать как действительную дату, возвращается NaN.

Описание

Эта функция полезна для установки значений даты на основе строковых значений, например, в сочетании с методом setTime().

Форматы, которые может обрабатывать parse(), явно не указаны, но есть несколько инвариантов:

• Формат строки даты и времени (создаваемый toISOString()) должен поддерживаться.
• Если x — это любая дата, количество миллисекунд которой равно нулю, то x.valueOf() должно быть равно любому из следующих значений: Date.parse(x.toString()), Date.parse(x.toUTCString()), Date.parse(x.toISOString()). Это означает, что форматы, создаваемые toString() и toUTCString(), также должны поддерживаться.
• Спецификация не требует поддержки формата, создаваемого toLocaleString(). Однако все основные движки стараются поддерживать формат toLocaleString("en-US").

Другие форматы определяются реализацией и могут не работать во всех браузерах. Библиотека может помочь, если необходимо учесть много разных форматов. Фактически, ненадежность Date.parse() является одной из мотиваций для введения API Temporal.

Поскольку parse() является статическим методом Date, вы всегда используете его как Date.parse(), а не как метод созданного вами объекта Date.

Примеры

Использование Date.parse()

Все следующие вызовы возвращают 1546300800000. Первый будет подразумевать время UTC, поскольку это только дата, а остальные явно указывают часовой пояс UTC.

Date.parse("2019-01-01");
Date.parse("2019-01-01T00:00:00.000Z");
Date.parse("2019-01-01T00:00:00.000+00:00");

Следующий вызов, который не указывает часовой пояс, будет установлен на 2019-01-01 в 00:00:00 в локальном часовом поясе системы, поскольку он содержит и дату, и время.

Date.parse("2019-01-01T00:00:00");

Форматы toString() и toUTCString()

Помимо стандартного формата строки даты и времени, поддерживаются форматы toString() и toUTCString():

// toString() format
Date.parse("Thu Jan 01 1970 00:00:00 GMT-0500 (Eastern Standard Time)");
// 18000000 in all implementations in all timezones

// toUTCString() format
Date.parse("Thu, 01 Jan 1970 00:00:00 GMT");
// 0 in all implementations in all timezones

Нестандартные строки даты

Реализации обычно используют локальный часовой пояс по умолчанию, если строка даты нестандартна. Для обеспечения согласованности мы будем предполагать, что среда выполнения использует часовой пояс UTC, и, если не указано иное, вывод будет зависеть от часового пояса устройства. Летнее время (DST) в локальном часовом поясе также может влиять на это.

Вот еще несколько примеров нестандартных строк даты. Браузеры очень снисходительны при разборе строковых представлений дат и могут отбрасывать любую часть строки, которую они не могут разобрать. Из соображений совместимости браузеры часто копируют поведение друг друга, поэтому эти шаблоны обработки, как правило, распространяются между браузерами. Как было сказано ранее, следующие примеры приведены только для иллюстрации и ни в коем случае не являются исчерпывающими: