UTC メソッド
世界協定時刻 (UTC) (つまり GMT) の 1970 年 1 月 1 日 0 時 0 分 0 秒と、指定した日付との間をミリ秒単位で返します。
function UTC(year : Number , month : Number , day : Number [, hours : Number [, minutes : Number [, seconds : Number [,ms : Number]]]]) : Number
引数
year
必ず指定します。 日付の年数を必ず 4 桁で指定します。 引数 year に 0 ～ 99 の値が指定された場合、1900 + year の値が指定されたと見なされます。month
必ず指定します。 月を表す 0 ～ 11 (1 ～ 12 月に相当) の範囲内の整数を指定します。day
必ず指定します。 日を表す 1 ～ 31 の範囲内の整数を指定します。hours
省略可能です。 引数 minutes を指定する場合は、この引数を指定する必要があります。 時を表す 0 ～ 23 (午前 0 時 ～ 午後 11 時に対応) の範囲内の整数を指定します。minutes
省略可能です。 引数 seconds を指定する場合は、この引数を指定する必要があります。 分を表す 0 ～ 59 の範囲内の整数を指定します。seconds
省略可能です。 引数 milliseconds を指定する場合は、この引数を指定する必要があります。 秒を表す 0 ～ 59 の範囲内の整数を指定します。ms
省略可能です。 ミリ秒を表す 0 ～ 999 の範囲内の整数を指定します。
解説
UTC メソッドは、世界協定時刻での 1970 年 1 月 1 日 0 時 0 分 0 秒と指定した日付との間をミリ秒単位で返します。 この戻り値は、setTime メソッドおよび Date オブジェクト コンストラクターで使用できます。 引数に有効範囲を超える値や負の値を指定すると、値に応じて格納される他の値が変更されます。 たとえば、150 秒を指定すると、2 分 30 秒として処理されます。
UTC メソッドと日付を受け取る Date オブジェクトのコンストラクターとの違いは、渡した日付が UTC メソッドでは世界協定時刻 (UTC) として扱われ、Date オブジェクトのコンストラクターでは現地時間として扱われるという点です。
UTC メソッドは、静的なメソッドです。 したがって、メソッドを使用するために、あらかじめ Date オブジェクトを作成しておく必要はありません。
使用例
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);
}