L’objet global Date en JavaScript


Introduction aux dates

L’objet Date qui permet de créer et de manipuler des dates grâce à ses méthodes.
Pour travailler avec des dates et les manipuler en JavaScript, nous allons utiliser l’objet natif Date. Le constructeur Date() possède en effet de nombreuses méthodes qui vont nous permettre d’obtenir ou de définir une date.

Le JavaScript stocke les dates en interne sous forme d’un Timestamp Unix exprimé en millisecondes (c’est-à-dire le Timestamp Unix multiplié par 1000). Le Timestamp Unix correspond au nombre de secondes écoulées depuis le premier janvier 1970 à minuit UTC ou GMT (c’est-à-dire minuit selon l’heure de Londres).

De nombreux langages représentent les dates sous forme de Timestamp Unix car c’est un nombre et il est beaucoup plus facile de travailler et de manipuler des nombres que des dates littérales qui peuvent s’écrire sous de nombreux différents formats. Nous allons cependant également pouvoir exprimer des dates sous forme littérale (c’est-à-dire sous forme de chaînes de caractères), en anglais, et en respectant certaines conventions.

Récupérer la date actuelle

Pour récupérer la date actuelle sous forme littérale, on va tout simplement utiliser Date(). Pour afficher cette même date sous forme de nombre (le nombre de millisecondes écoulées depuis le 1er janvier 1970), on peut utiliser la méthode statique now() du constructeur Date.

        let date = Date();
        document.write("Date() : " + date);
        let timestamp = Date.now();
        document.write("Date.now() : " + timestamp);
        

Comme vous pouvez le remarquer, la forme littérale est difficilement exploitable telle quelle pour nous, car celle-ci suit les normes anglo-saxonnes. Nous allons voir comment afficher nos dates avec un format local dans la suite de cette leçon.

Créer un objet de type date

Pour créer et manipuler une date particulière, nous allons devoir créer un objet de type date. Pour créer un objet de type date, nous allons cette fois-ci être obligé d’utiliser le constructeur Date() avec donc le mot clef new.

On va pouvoir instancier notre constructeur Date() de différentes manières pour créer une date. On peut déjà instancier Date() sans lui passer d’argument, auquel cas le constructeur va créer un objet date contenant la date actuelle complète en fonction de l’heure locale du système.

On peut également fournir une date sous forme de millisecondes écoulées depuis le 1er janvier 1970 à Date() pour qu’il crée un objet avec la date demandée.

Enfin, on va pouvoir passer une suite de nombres à notre constructeur pour qu’il crée un objet date morceau par morceau. Ces nombres représentent, dans l’ordre :
• L’année (argument obligatoire) de la date qu’on souhaite créer ;
• Le numéro du mois (argument obligatoire) de la date qu’on souhaite créer, entre 0 (pour janvier) et 11 (pour décembre) ;
• Le numéro du jour du mois (facultatif) de la date qu’on souhaite créer, entre 1 et 31 ;
• L’heure (facultatif) de la date qu’on souhaite créer, entre 0 et 23 ;
• Le nombre de minutes (facultatif) de la date qu’on souhaite créer, entre 0 et 59 ;
• Le nombre de secondes (facultatif) de la date qu’on souhaite créer, entre 0 et 59 ;
• Le nombre de millisecondes (facultatif) de la date qu’on souhaite créer, entre 0 et 999.

        let dateSimple = new Date();
        document.write("Date() : " + dateSimple);
        let dateDuJour = new Date(2024, 0, 25, 18, 15);
        document.write("Date(2024, 0, 25, 18, 15) : " + dateDuJour);
        let dateTimestamp = new Date(365 * 24 * 3600 * 1000);
        document.write("Date(365 * 24 * 3600 * 1000) : " + dateTimestamp);
        

Convertir une date au format local

L’objet Date dispose également de méthodes nous permettant de convertir un format de date en un format local. Ces méthodes vont notamment nous permettre d’afficher les éléments de date dans un ordre local (jour puis mois puis année par exemple) ou de pouvoir afficher une heure selon un format 12 heures ou 24 heures.
Elles vont également nous permettre de traduire des dates littérales anglaises dans la langue locale. Pour faire cela, on va pouvoir utiliser les méthodes toLocaleDateString(), toLocaleTimeString() et toLocaleString().

La méthode toLocaleDateString() renvoie la partie « jour-mois-année » d’une date, formatée en fonction d’une locale et d’options.
La méthode toLocaleTimeString() renvoie la partie « heures-minutes-secondes » d’une date, formatée en fonction d’une locale et d’options.
La méthode toLocaleString() renvoie la date complète, formatée en fonction d’une locale et d’options.

Ces trois méthodes vont donc pouvoir prendre deux arguments : un premier argument qui est une locale et un second qui correspond à des options.

La locale sert à définir la langue dans laquelle la date doit être formatée. Pour la France, on utilisera fr-FR (belgique : fr-BE / nl-BE / de-BE).

Les options vont permettre de modifier le comportement par défaut de nos méthodes et notamment d’expliciter si on souhaite que la date passée soit renvoyée sous forme de chiffres ou sous forme littérale.
Les options qui vont particulièrement nous intéresser vont être les suivantes :
• weekday qui représente le jour de la semaine. Les valeurs possibles sont « narrow », « short » et « long » ;
• day qui représente le jour du mois. Les valeurs possibles sont numeric et 2-digit
• month qui représente le mois. Les valeurs possibles sont numeric et 2-digit
• year qui représente l’année. Les valeurs possibles sont numeric et 2-digit
• hour qui représente l’heure. Les valeurs possibles sont numeric et 2-digit
• minute qui représente les minutes. Les valeurs possibles sont numeric et 2-digit
• second qui représente les secondes. Les valeur possibles sont numeric et 2-digit

A noter que les navigateurs sont obligés de supporter à minima les ensembles suivants.
Si vous utilisez une autre combinaison, celle-ci pourra ne pas être supportée :
• weekday, year, month, day, hour, minute, second
• weekday, year, month, day
• year, month, day
• year, month
• month, day
• hour, minute, second
• hour, minute.

Une autre option intéressante est l’option timeZone qui permet de définir le fuseau horaire à utiliser.

        let dateObj = new Date();
        let dateLocale = dateObj.toLocaleDateString('fr-FR', {
            weekday: 'long', 
            year: 'numeric', 
            month: 'long', 
            day: 'numeric',
            hour: 'numeric',
            minute: 'numeric',
            second: 'numeric'
        }
        );
        

Plus d'infos sur MDN Web docs