CKTIS / JavaScript
Date.parse: текст на дата към времеви печат
Date.parse преобразува текст на дата в милисекунди от епохата или връща NaN, ако текстът не е разпознат или е извън диапазона.
Версия: ECMAScript 1 onward; current date-time string rules; example target: Node.js 24.22.2
Синтаксис
Date.parse(dateString)Date.parse(string) първо преобразува аргумента в текст, после връща времева стойност в милисекунди от епохата. Стандартният date-time формат е форма на ISO 8601 като 2024-02-29T12:30:00+02:00. Само дата като 2024-02-29 се тълкува като UTC; дата и час без отместване се тълкуват в местната часова зона.
Невалиден текст или стойност извън диапазона TimeClip ±8.64e15 дава NaN, не изключение. Преобразуването на аргумента в текст все пак може да хвърли, например при Symbol. Форматът от toISOString() трябва да се приема; за дати с нула милисекунди се изискват и форматите от toString() и toUTCString(). Другите формати зависят от реализацията.
За обмен на данни използвайте пълната ISO форма със Z или явно отместване, а не двусмислен местен запис. Date.parse съществува от първото издание на ECMAScript; правилата без отместване са уточнени по-късно.
Примери
const dateOnly = Date.parse("2024-02-29");
const withOffset = Date.parse("2024-02-29T12:30:00+02:00");
console.log(dateOnly, new Date(dateOnly).toISOString());
console.log(withOffset, new Date(withOffset).toISOString());
console.log(Number.isNaN(Date.parse("not a date")));Резултат
1709164800000 2024-02-29T00:00:00.000Z 1709202600000 2024-02-29T10:30:00.000Z true