Javascript

Manipulation des dates/heures en Javascript

Manipulation des dates/heures en Javascript - Expliqué en détail et avec plusieurs scripts très pratiques.

Manipuler les dates et le temps est très utile. Récupérer la date locale d’un visiteur, convertir une date en temps GMT, extraire les minutes ou les jours à des fins de calcul ou utiliser un délai pour exécuter des fonction récursive, et autres manipulations.

L’objet Date

L’objet " date " du Javascript permet d’accéder et de manipuler le format date et heure. Les méthodes sont très semblables au Java, enregistre en milliseconde depuis le 1er Janvier 1970 00 :00 :00, elles ne seront plus valides vers 2032 si je me rappelle bien, et ce en raison du nombre limité d’octets !!. Enfin, d’ici là, amusons-nous un peu. Explications, exemple et une librairie de fonctions utiles.

Pour manipuler une date ou obtenir la date du jour vous devez créer un objet date. Il y a quatre façons de faire.

• NomObjet = new Date()
• NomObjet = new Date(" mois Jour, année heures:minutes:secondes ")
• NomObjet = new Date(année, mois, jour)
• NomObjet = new Date(année, mois, jour, heures, minutes, secondes)

• La première syntaxe permet d’obtenir la date du jour dans le format (MM/JJ/AA)
• La deuxième permet de forcer une date avec l’heure. chaîne de car. (strnig)
• Les troisième et quatrième syntaxes en format (integer).
• En n’initialisant pas l’heure (heure, minutes, secondes), leur valeur sera à zéro.

Exemples

var dAujourdhui = new Date();
var dNoel = new Date("February 5, 2001 18:15:00");
var dNoel = new Date(97, 12, 25);
var dNoel = new Date(97, 12, 25, 1, 0, 0);

Les Méthodes

Une fois votre objet crée ou la date du jour obtenu, vous pouvez utiliser les méthodes suivantes pour manipuler votre objet.

Exemples

NomObjet.NomMethode(paramètres).

FONCTION : getDate()

Retourne le jour du mois pour une date spécifique. Nombre entre 1 et 31

Syntaxe : NomObjet.getDate()

Paramètres : aucun

<script>
var maDate = new Date("February 5, 2001 18:15:00");
var jour = maDate.getDate();

// Alerte pour afficher le résultat
// "\n" permet de changer de ligne
alert("maDate = "+maDate+"\ngetDate = "+jour)
</script>

Résultat
  maDate = Mon Feb 5 23:15:00 EST 2001
  getDate = 5

FONCTION : getDay()

Retourne le jour de la semaine pour une date spécifique. Nombre entre 0 et 6.

Syntaxe : NomObjet.getDay()

Paramètres : aucun

<script>
var maDate = new Date("February 5, 2001 23:15:00");
var nJour = maDate.getDay();

alert("maDate = "+maDate+"\ngetDay = "+nJour)
</script>

Résultat
  maDate = Mon Feb 5 23:15:00 EST 2001
  getDay = 1

0 = Dimanche
1 = Lundi
2 = Mardi
3 = Mercredi
4 = Jeudi
5 = Vendredi
6 = Samedi 

FONCTION : getHours()

Retourne l’heure d’une date spécifique. Nombre entre 0 et 23.

Syntaxe : NomObjet.getHours()

Paramètres : aucun

<script type="text/javascript" language="javascript">
  maDate = new Date("February 5, 2001 23:15:00");
  nHeure = maDate.getHours();

  alert("maDate = "+maDate+"\ngetHours = "+nHeure)
</script>

Résultat
  maDate = Mon Feb 5 23:15:00 EST 2001
  getHours = 23

FONCTION : getMinutes()

Retourne les minute d’une date spécifique. Nombre entre 0 et 59.

Syntaxe : NomObjet.getMinutes()

Paramètres : aucun

<script type="text/javascript" language="javascript">
  maDate = new Date("February 5, 2001 23:15:00");
  nMinutes = maDate.getMinutes();

  alert("maDate = "+maDate+"\ngetMinutes = "+nMinutes)
</script>

Résultat
  maDate = Mon Feb 5 23:15:00 EST 2001
  getMinutes = 15

FONCTION : getMonth()

Retourne le mois d’une date spécifique. Nombre entre 0 et 11.

Syntaxe : NomObjet.getMonth()

Paramètres : aucun

<script type="text/javascript" language="javascript">
  maDate = new Date("February 5, 2001 23:15:00");
  nMois = maDate.getMois();

  alert("maDate = "+maDate+"\ngetMonth = "+nMois)
</script>

Résultat
  maDate = Mon Feb 5 23:15:00 EST 2001
  getMonth = 1

0 = Janvier
1 = Février
2 = Mars
3 = Avril
4 = Mai
5 = Juin
6 = Juillet
7 = Août
8 = Septembre
9 = Octobre
10 = Novembre
11 = Décembre

FONCTION : getSeconds()

Retourne les secondes d’une date spécifique. Nombre entre 0 et 59.

Syntaxe : NomObjet.getSeconds()

Paramètres : aucun

<script type="text/javascript" language="javascript">
  maDate = new Date("February 5, 2001 23:15:00");
  nSec = maDate.getSeconds();

  alert("maDate = "+maDate+"\ngetSeconds = "+nSec)
</script>

Résultat
  maDate = Mon Feb 5 23:15:00 EST 2001
  getSeconds = 0

FONCTION : getTime()

Retourne le nombre de milisecondes depuis le 1er janvier 1970.

Syntaxe : NomObjet.getTime()

Paramètres : aucun

<script type="text/javascript" language="javascript">
  maDate = new Date("February 5, 2001 23:15:00");
  nTemps = maDate.getTime();

  alert("maDate = "+maDate+"\ngetTime = "+nTemps)
</script>

Résultat
  maDate = Mon Feb 5 23:15:00 EST 2001
  getTime = 981432900000

FONCTION : getUTCHours()

Retourne l’heure selon la norme "Greenwich Mean Time GMT" en minute.

Syntaxe : NomObjet.getUTCHours()

Paramètres : aucun

<script type="text/javascript" language="javascript">
  maDate = new Date("February 5, 2001 21:15:00");
  nGMT1 = maDate.getUTCHours();

  // Soustraire 5 pour obtenir le fuseau horraire de Montréal
  nGMT2 = nGMT1 - 5; 
  if ( nGMT2 < 0 ) {
    nGMT2 = 24 + nGMT2;
  }
  if (nGMT2 > 23) {
    nGMT2 = nGMT2 - 24;
  }

  alert("maDate = "+maDate+"\ngetUTCHours = "
          +nGMT1+"\nHeure Local = "+nGMT2)
</script>

Résultat
  maDate = Mon Feb 5 21:15:00 EST 2001
  getUTCHours = 2
  Heure locale =  21

Conversion entre principaux fuseaux horraire
+1 = Europe centrale
+2 = Istanbul
+3 = Moscou
+8 = Hong Kong
+9 = Tokyo
+10 = Townsville, Australia
-5 = New York (EST, Est stanrd time)
-6 = Chicago (CST, Continental stanrd time)
-7 = Denver (MST, Medle stanrd time)
-8 = Los Angeles (PST, Pacific stanrd time)

FONCTION : getYear()

Retourne l’année d’une date spécifique. À partir de 1900. En bas de 2000, l’année ne retourne que deux caractères Ex: 1995 = 95

Syntaxe : NomObjet.getYear()

Paramètres : aucun

<script type="text/javascript" language="javascript">
  maDate1 = new Date();
  maDate2 = new Date("February 5, 1995 23:15:00");
  maDate3 = new Date("February 5, 2001 23:15:00");
  nAnnee1 = maDate1.getYear();
  nAnnee2 = maDate2.getYear();
  nAnnee3 = maDate3.getYear();

  alert("maDate1 = "+maDate1+"\ngetYear = "+nAnnee1
          +"\nmaDate2 = "+maDate2+"\ngetYear = "+nAnnee2
          +"\nmaDate3 = "+maDate3+"\ngetYear = "+nAnnee3)
</script>

Résultat
  maDate1 = "Votre date local"
  getYear = 2001
  maDate1 = Sun Feb 5 23:15:00 EST 1995
  getYear = 95
  maDate1 = Mon Feb 5 23:15:00 EST 2001
  getYear = 2001

FONCTION : setDate()

Change la date d’un mois.

Syntaxe : NomObjet.setDate(valeurJour)

Paramètres : valeurJour = un nombre entre 1 et 31

<script type="text/javascript" language="javascript">
  maDate1 = new Date("February 2, 2001 18:15:00");
  maDate2 = new Date("February 2, 2001 18:15:00");
  maDate2.setDate(5);

  alert("maDate = "+maDate1+"\nsetDate = "+maDate2)
</script>

Résultat
  maDate = Fri Feb 2 18:15:00 EST 2001
  setDate = Mon Feb 5 18:15:00 EST 2001

FONCTION : setHours()

Change l’heure d’une date spécifique.

Syntaxe : NomObjet.setHours(valeurHeure)

Paramètres : valeurHeure = un nombre entre 0 et 23

<script type="text/javascript" language="javascript">
  maDate1 = new Date("February 2, 2001 18:15:00");
  maDate2 = new Date("February 2, 2001 18:15:00");
  maDate2.setHours(23);

  alert("maDate = "+maDate1+"\nsetHours = "+maDate2)
</script>

Résultat
  maDate = Fri Feb 2 18:15:00 EST 2001
  setHours = Fri Feb 2 23:15:00 EST 2001

FONCTION : setMinutes()

Change les minute d’une date spécifique.

Syntaxe : NomObjet.setMinutes(valeurMinutes)

Paramètres : valeurMinutes = un nombre entre 0 et 59

<script type="text/javascript" language="javascript">
  maDate1 = new Date("February 2, 2001 18:15:00");
  maDate2 = new Date("February 2, 2001 18:15:00");
  maDate2.setMinutes(20);

  alert("maDate = "+maDate1+"\nsetMinutes = "+maDate2)
</script>

Résultat
  maDate = Fri Feb 2 18:15:00 EST 2001
  setMinutes = Fri Feb 2 18:20:00 EST 2001

FONCTION : setMonth()

Change le mois d’une date spécifique.

Syntaxe : NomObjet.setMonth(valeurMois)

Paramètres : valeurMois = un nombre entre 0 et 11

<script type="text/javascript" language="javascript">
  maDate1 = new Date("February 2, 2001 18:15:00");
  maDate2 = new Date("February 2, 2001 18:15:00");
  maDate2.setMonth(5);

  alert("maDate = "+maDate1+"\nsetMonth = "+maDate2)
</script>

Résultat
  maDate = Fri Feb 2 18:15:00 EST 2001
  setMonth = Sat Jun 2 18:15:00 EST 2001

FONCTION : setSeconds()

Change les secondes d’une date spécifique. Entre 0 et 59.

Syntaxe : NomObjet.setSeconds(valeurSecondes)

Paramètres : valeurSecondes = un nombre entre o et 59

<script type="text/javascript" language="javascript">
  maDate1 = new Date("February 2, 2001 18:15:00");
  maDate2 = new Date("February 2, 2001 18:15:00");
  maDate2.setSeconds(30);

  alert("maDate = "+maDate1+"\nsetSeconds = "+maDate2)
</script>

Résultat
  maDate = Fri Feb 2 18:15:00 EST 2001
  setSeconds = Fri Feb 2 18:15:30 EST 2001

FONCTION : setTime()

Change la valeur de l’objet Date.

Syntaxe : NomObjet.setTime(valeurMSec)

Paramètres : valeurMSec = le nombre de milliseconde depuis le 1er janvier 1970 00:00:00.

<script type="text/javascript" language="javascript">
  // Exemple qui passe la date de maDate1 à maDate2
  // en passant les millisecondes d’une date à l’autre
  maDate1 = new Date("February 5, 2001 23:15:00")
  maDate2 = new Date()
  maDate2.setTime(maDate1.getTime());

  alert("maDate = "+maDate1+"\nsetTime = "+maDate2)
</script>

Résultat
  maDate = Mon Feb 5 23:15:00 EST 2001
  setTime = Mon Feb 5 23:15:00 EST 2001

FONCTION : setTimeout()

Évalue une expression après un certain délais en milisecondes.

Syntaxe : DelaisID = setTimeout(expression, msec)

Syntaxe : clearTimeout(DelaisID)

Paramètres :

- DelaisID = Identifiant pour annuler le délais à l’aide de "clearTimeout"

- expression = fonction ou propriété d’un objet.

- msec = nombre ou propriété d’un objet en milisecondes.

<!-- Exemple qui affiche l’heure dans
un champ texte d’un formulaire
et en format texte avec la balise SPAN -->

<head>

<script type="text/javascript" language="javascript">
<!--
var timerID = null;
var ok = false;

function arreter() {
  // s’assure que l’heure est arrêté
  if(ok)
    // Arrêt du délais
    clearTimeout(timerID)
  ok = false
}

function debut() {
  // Part l’affichage de l’heure
  arreter()
  aff_heure()
}

function aff_heure() {
  // Fonction pour afficher l’heure
  // Construction de l’heure
  var heure = new Date();
  var hh = heure.getHours();
  var mm = heure.getMinutes();
  var ss = heure.getSeconds();
  var valeur = "" + ((hh > 12) ? hh - 12 : hh);
  valeur += ((mm < 10) ? ":0" : ":") + mm;
  valeur += ((ss < 10) ? ":0" : ":") + ss;
  valeur += (hh >= 12) ? " P.M." : " A.M.";

  // Affiche l’heure dans le formulaire
  document.form.resul.value = valeur;

  // Affiche l’heure en format texte (pas compatible N6)
  if (document.layers) {
    document.layers.Htxt.document.write(valeur);
    document.layers.Htxt.document.close();
  }
  else if (document.all) {
    Htxt.innerHTML = valeur;
  }

  // Appelle de façon récursive la fonction
  // aff_heure() à chaque seconde.
  timerID = setTimeout("aff_heure()",1000);

  // Indique que l’heurre fonctionne
  ok = true;
}
// -->
</script>
</head>

<!-- Événement "onload" pour partir l’affichage
<body onLoad="debut()">

<!-- Affichage dans le formulaire -->
<form name="form">
  <input type="text" name="resul" size="12" value="">
</form>

<br>

<!-- Affichage en format texte -->
<span id=Htxt style="position:relative;"></span>

</body>

Résultat
  L’heure du formulaire  (HH:MM:SS A.M./P.M")
  L’heure en format texte (HH:MM:SS A.M./P.M")

FONCTION : setYear()

Change l’année d’une date spécifique. Entre 0 et 23.

Syntaxe : NomObjet.setYear(valeurAnnee)

Paramètres : valeurAnnee = un nombre entre 1900 et (?) 2032.

<script type="text/javascript" language="javascript">
  maDate1 = new Date("February 2, 2001 18:15:00");
  maDate2 = new Date("February 2, 2001 18:15:00");
  maDate2.setYear(2002);

  alert("maDate = "+maDate1+"\nsetYear = "+maDate2)
</script>

Résultat
  maDate = Fri Feb 2 18:15:00 EST 2001
  setYear = Sat Feb 2 18:15:00 EST 2002

PROTOTYPE - Quelques fonctions pratiques à ajouter à l’objet Date

Date.prototype.ajouteSecondes = function(Secondes) {
    this.setSeconds(this.getSeconds() + Secondes);
    return this;
};

Date.prototype.ajouteMinutes = function(minutes) {
    this.setMinutes(this.getMinutes() + minutes);
    return this;
};

Date.prototype.ajouteHeures = function(heures) {
    this.setHours(this.getHours() + heures);
    return this;
};

Date.prototype.ajouteJours = function(jours) {
    this.setDate(this.getDate() + jours);
    return this;
};

Date.prototype.ajouteSemaines = function(semaines) {
    this.ajouteJours(semaines*7);
    return this;
};

Date.prototype.ajouteMois = function (mois) {
    var d = this.getDate();
    this.setMonth(this.getMonth() + mois);
    var dCourrante = this.getDate();
    if (d !== dCourrante) {  this.ajouteJours(-dCourrante);}
    return this;
};

Date.prototype.ajouteAnnees = function(annees) {
    var d = this.getDate();
    this.setFullYear(this.getFullYear() + annees);
    var dCourrante = this.getDate();
    if (d !== dCourrante) {  this.ajouteJours(-dCourrante);}
    return this;
};

// sDatePortion: "annees", "mois", "semaines", "jours", "heures", "minutes", "secondes"
Date.twDateDiff = function(sDatePortion, dDateDe, dDateA) {
  sDatePortion = sDatePortion.toLowerCase();
  var nDifference = dDateA - dDateDe;
  var divideBy = { annees:31536000000, mois:2628000000, semaines:604800000, jours:86400000, heures:3600000, minutes:60000, secondes:1000 };
  return Math.floor( nDifference/divideBy[sDatePortion]);
}

// Obtenir l’âge
function twCalculeAge(dNaissance) {
  let nDifferenceEnMilliseconde = Date.now() - dNaissance.getTime();
  let dAge = new Date(nDifferenceEnMilliseconde); // Millisecondes
  // LA date UTC renvoie le nombre de millièmes de seconde depuis le 1er janvier 1970 !!
  return Math.abs(dAge.getUTCFullYear() - 1970);
}