Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Date.parse : texte de date vers horodatage

Date.parse convertit un texte de date en millisecondes depuis l’époque, ou renvoie NaN si le texte est inconnu ou hors plage.

Version : ECMAScript 1 onward; current date-time string rules; example target: Node.js 24.22.2

Syntaxe

Date.parse(dateString)

Date.parse(string) convertit d’abord son argument en texte, puis renvoie une valeur temporelle en millisecondes depuis l’époque. Le format date-time standard est une forme ISO 8601 comme 2024-02-29T12:30:00+02:00. Une date seule telle que 2024-02-29 est interprétée en UTC ; une date avec heure sans décalage est interprétée dans le fuseau local.

Un texte invalide ou une valeur hors de la plage TimeClip ±8.64e15 produit NaN, pas une exception. La conversion de l’argument en texte peut néanmoins lever, par exemple pour un Symbol. Le format de toISOString() doit être accepté ; pour une date sans millisecondes, les formats de toString() et toUTCString() sont aussi requis. Les autres formats dépendent de l’implémentation.

Pour échanger des données, utilisez la forme ISO complète avec Z ou un décalage explicite plutôt qu’une notation locale ambiguë. Date.parse existe depuis la première édition d’ECMAScript ; les règles sans décalage ont été précisées ultérieurement.

Exemples

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")));

Résultat

1709164800000 2024-02-29T00:00:00.000Z
1709202600000 2024-02-29T10:30:00.000Z
true

Sources