UTC, méthode
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.secondes
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é.
Exemple
L'exemple suivant illustre l'utilisation de la méthode UTC.
function DaysBetweenDateAndNow(yr, mo, dy)
{
// Determine the milliseconds per day.
var MinMilli = 1000 * 60
var HrMilli = MinMilli * 60
var DyMilli = HrMilli * 24
// Determine today's UTC year, month, and day.
var d = new Date();
var yeartoday = d.getUTCFullYear();
var monthtoday = d.getUTCMonth();
var dayofmonthtoday = d.getUTCDate();
// Get the milliseconds since 1/1/1970 UTC.
var t1 = Date.UTC(yr, mo - 1, dy)
var t2 = Date.UTC(yeartoday, monthtoday, dayofmonthtoday);
// Determine the difference in days.
var days = (t1 - t2) / DyMilli;
return(days);
}