UTC, méthode

Article
08/21/2008

Mise à jour : novembre 2007

Retourne le nombre de millisecondes entre le 1er janvier 1970 à minuit, selon le temps universel (ou selon l'heure GMT) et la date fournie.

function UTC(year : Number , month : Number , day : Number [, hours : Number [, minutes : Number [, seconds : Number [,ms : Number]]]]) : Number

Arguments

year
Obligatoire. La désignation complète de l'année est obligatoire pour permettre de distinguer les dates d'un siècle à un autre. Si l'argument year est compris entre 0 et 99, on suppose que l'année définie correspond à 1900 + year.
month
Obligatoire. Mois, représenté par un entier compris entre 0 et 11 (janvier à décembre).
day
Obligatoire. Date, représentée par un entier compris entre 1 et 31.
hours
Facultatif. Doit être spécifié si l'argument minutes est fourni. Entier compris entre 0 et 23 (minuit à 23 heures) indiquant l'heure.
minutes
Facultatif. Doit être spécifié si l'argument seconds est fourni. Entier compris entre 0 et 59 indiquant les minutes.
seconds
Facultatif. Doit être spécifié si l'argument milliseconds est fourni. Entier compris entre 0 et 59 indiquant les secondes.
ms
Facultatif. Entier compris entre 0 et 999 indiquant les millisecondes.

Notes

La méthode UTC retourne le nombre de millisecondes entre le 1er janvier 1970 à minuit (temps universel) et la date fournie. La valeur de retour peut être utilisée dans la méthode setTime et dans le constructeur de l'objet Date. Si la valeur d'un argument est en dehors de la plage de sélection ou si elle est négative, les autres valeurs stockées sont modifiées en conséquence. Par exemple, si vous spécifiez 150 secondes, JScript convertit ce nombre en deux minutes et trente secondes.

La différence entre la méthode UTC et le constructeur de l'objet Date qui accepte une date est que la méthode UTC se base sur le temps universel alors que le constructeur de l'objet Date fait référence à l'heure locale.

La méthode UTC est une méthode statique. Un objet Date ne doit pas nécessairement être créé avant d'être utilisé.

Remarque :
Si l'argument year est compris entre 0 et 99, définissez une année correspondant à 1900 + year.

Exemple

L'exemple ci-dessous illustre l'utilisation de la méthode UTC.

function DaysBetweenDateAndNow(yr, mo, dy){
   var d, r, t1, t2, t3;            //Declare variables.
   var MinMilli = 1000 * 60         //Initialize variables.
   var HrMilli = MinMilli * 60
   var DyMilli = HrMilli * 24
   t1 = Date.UTC(yr, mo - 1, dy)    //Get milliseconds since 1/1/1970.
   d = new Date();                  //Create Date object.
   t2 = d.getTime();                //Get current time.
   if (t2 >= t1) 
      t3 = t2 - t1;
   else
      t3 = t1 - t2;
   r = Math.round(t3 / DyMilli);
   return(r);                       //Return difference.
}