База знанияИзпитен център
BGБългарски
Избери език13

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

Източници