CKTIS / JavaScript
Date.parse: besedilo datuma v časovni žig
Date.parse pretvori besedilo datuma v milisekunde od epohe ali vrne NaN, če besedila ne prepozna oziroma je vrednost zunaj obsega.
Različica: ECMAScript 1 onward; current date-time string rules; example target: Node.js 24.22.2
Sintaksa
Date.parse(dateString)Date.parse(string) najprej pretvori argument v besedilo in nato vrne časovno vrednost v milisekundah od epohe. Standardni format date-time je oblika ISO 8601, na primer 2024-02-29T12:30:00+02:00. Sam datum, kot je 2024-02-29, se razume kot UTC; datum s časom brez odmika pa v krajevnem časovnem pasu.
Neveljavno besedilo ali vrednost zunaj obsega TimeClip ±8.64e15 da NaN, ne izjeme. Pretvorba argumenta v besedilo pa lahko sproži izjemo, na primer za Symbol. Format iz toISOString() mora biti podprt; za datume brez milisekund sta zahtevana tudi formata toString() in toUTCString(). Drugi formati so odvisni od izvedbe.
Za izmenjavo podatkov uporabite polno obliko ISO z Z ali izrecnim odmikom, ne dvoumnega krajevnega zapisa. Date.parse obstaja od prve izdaje ECMAScript; pravila brez odmika so bila pozneje pojasnjena.
Primeri
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")));Rezultat
1709164800000 2024-02-29T00:00:00.000Z 1709202600000 2024-02-29T10:30:00.000Z true