Date オブジェクト
日付および時刻を格納しておくオブジェクトです。
dateObj = new Date()
dateObj = new Date(dateVal)
dateObj = new Date(year, month, date[, hours[, minutes[, seconds[,ms]]]])
引数
- dateObj
必ず指定します。Date オブジェクトを代入する変数名を指定します。 - dateVal
必ず指定します。数値で指定する場合は、世界協定時刻 (UTC)での指定する日付と 1970 年 1 月 1 日 0 時 0 分 0 秒との間をミリ秒単位の数値で指定します。文字列で指定する場合は、指定した文字列が parse メソッドでの規則に準じて解析されます。引数 dateVal には、ActiveX® オブジェクトから取得した VT_DATE 値を指定することもできます。 - year
必ず指定します。4 桁の年を指定します (たとえば、76 ではなく 1976 と指定します)。 - month
必ず指定します。月を表す 0 ～ 11 (1 ～ 12 月に相当) の範囲内の整数を指定します。 - date
必ず指定します。日を表す 1 ～ 31 の範囲内の整数を指定します。 - hours
省略可能です。この引数を指定する場合は、引数 minutes を指定する必要があります。時を表す 0 ～ 23 (午前 0 時 ～ 午後 11 時に対応) の範囲内の整数を指定します。 - minutes
省略可能です。この引数を指定する場合は、引数 seconds を指定する必要があります。分を表す 0 ～ 59 の範囲内の整数を指定します。 - seconds
省略可能です。この引数を指定する場合は、引数 milliseconds を指定する必要があります。秒を表す 0 ～ 59 の範囲内の整数を指定します。 - ms
省略可能です。ミリ秒を表す 0 ～ 999 の範囲内の整数を指定します。
解説
Date オブジェクトには、特定の時刻をミリ秒で表す数値が格納されます。引数に有効範囲を超える値や負の値を指定すると、値に応じて格納されるほかの値が変更されます。たとえば、150 秒という指定を行うと、Jscript は 2 分 30 秒として処理します。
格納されている数値が NaN の場合は、オブジェクトが特定の時刻を表していないことを示します。Date オブジェクトに一切パラメータを渡さなかった場合は、オブジェクトは現在の時刻 (UTC) で初期化されます。
Date オブジェクトで表せる日付の範囲は、1970 年 1 月 1 日の前後の約 285,616 年です。
Date オブジェクトには、Date オブジェクトを作成しなくても呼び出すことができる 2 つの静的な (static) メソッドがあります。parse メソッドと UTC メソッドです。
使用例
次のコードは、Date オブジェクトの使用例です。
function DateDemo(){
var d, s = "今日の日付:"; // 変数を宣言します。
d = new Date(); // Date オブジェクトを作成します。
s += (d.getMonth() + 1) + "/"; // 月を取得します。
s += d.getDate() + "/"; // 日を取得します。
s += d.getYear(); // 年を取得します。
return(s); // 日付を返します。
}
プロパティ
constructor プロパティ | prototype プロパティ
メソッド
getDate メソッド | getDay メソッド | getFullYear メソッド | getHours メソッド | getMilliseconds メソッド | getMinutes メソッド | getMonth メソッド | getSeconds メソッド | getTime メソッド | getTimezoneOffset メソッド | getUTCDate メソッド | getUTCDay メソッド | getUTCFullYear メソッド | getUTCHours メソッド | getUTCMilliseconds メソッド | getUTCMinutes メソッド | getUTCMonth メソッド | getUTCSeconds メソッド | getVarDate メソッド | getYear メソッド | setDate メソッド | setFullYear メソッド | setHours メソッド | setMilliseconds メソッド | setMinutes メソッド | setMonth メソッド | setSeconds メソッド | setTime メソッド | setUTCDate メソッド | setUTCFullYear メソッド | setUTCHours メソッド | setUTCMilliseconds メソッド | setUTCMinutes メソッド | setUTCMonth メソッド | setUTCSeconds メソッド | setYear メソッド | toGMTString メソッド| toLocaleString メソッド | toUTCString メソッド| toString メソッド| valueOf メソッド| parse メソッド | UTC メソッド