JavaScript 入門 | 標準オブジェクト | Date メソッド

Date.now() メソッド

Date.now() メソッドは、1970 年 1 月 1 日 0 時 0 分 0 秒から現在までの時間をミリ秒 (millisecond) 単位の整数で返す。

var nowMiliSec = Date.now();
nowMiliSec;           // 1970 年 1 月 1 日 00:00:00 から現在までのミリ秒
new Date(nowMiliSec); // new Date() と同じ結果を返す。
new Date();

Date.prototype getter メソッド

すべての Date インスタンスは Date.prototype からメソッドとプロパティを継承する。

Date.prototype getter メソッドは、日付に関する情報を取得するためのメソッドである。 最もよく使用される代表的な getter メソッドは次のとおりである。

  1. getFullYear()
  2. getDate()
  3. getDay()
  4. getTime()

getFullYear() メソッド

getFullYear() メソッドは、現在の年を 4 桁の数値 (YYYY) で返す。

var date = new Date();
document.write("今年は " + date.getFullYear() + " 年である。"); // 現在の年を返す。

getDate() メソッド

getDate() メソッドは、現在の日付に該当する数値を返す。

var date = new Date();
document.write("今日は " + date.getMonth() + " 月 " + date.getDate() + " 日である。"); // 現在の日付を返す。

getDay() メソッド

getDay() メソッドは、現在の曜日に該当する数値を返す。

JavaScript で 1 週間は日曜日 (0) から始まり、土曜日 (6) で終わる。

var date = new Date();
var day;
switch (date.getDay()) { // 現在の曜日を返す。
    case 0:
        day = "日";
        break;
    case 1:
        day = "月";
        break;
    ...
    case 6:
        day = "土";
        break;
}
document.write("今日は " + day + "曜日である。");

配列を使用すると、より簡単に曜日を出力できる。

var date = new Date();
var days = ["日", "月", "火", "水", "木", "金", "土"];
document.write("今日は " + days[date.getDay()] + "曜日である。");

getTime() メソッド

getTime() メソッドは、1970 年 1 月 1 日 0 時 0 分 0 秒から現在までの時間をミリ秒単位に換算した値を数値で返す。

var date = new Date();
var period = date.getTime() / 86400000 // 1 日は 86,400,000 ミリ秒として計算される。
document.write("1970 年 1 月 1 日から今日まで " + period.toFixed() + " 日が過ぎた。"); // 小数部分は省略する。

JavaScript Date.prototype getter メソッド

メソッド 説明 値の範囲
getDate() 現地時刻で現在の日付に該当する数値を返す。 1 ~ 31
getDay() 現地時刻で現在の曜日に該当する数値を返す。 0 ~ 6
getMonth() 現地時刻で現在の月に該当する数値を返す。 0 ~ 11
getFullYear() 現地時刻で現在の年を 4 桁の数値 (YYYY) で返す。 YYYY
getHours() 現地時刻で現在の時に該当する数値を返す。 0 ~ 23
getMilliseconds() 現地時刻で現在時刻のミリ秒に該当する数値を返す。 0 ~ 999
getMinutes() 現地時刻で現在時刻の分に該当する数値を返す。 0 ~ 59
getSeconds() 現地時刻で現在時刻の秒に該当する数値を返す。 0 ~ 59
getTime() 1970 年 1 月 1 日 0 時 0 分 0 秒から現在までの時間をミリ秒単位に換算した値を数値で返す。 -
getTimezoneOffset() UTC から現在時刻までの時差を分単位に換算した値を数値で返す。 -

JavaScript Date.prototype UTC getter メソッド

メソッド 説明
getUTCDate() 協定世界時 (UTC) で現在の日付に該当する数値を返す。
getUTCDay() 協定世界時 (UTC) で現在の曜日に該当する数値を返す。
getUTCMonth() 協定世界時 (UTC) で現在の月に該当する数値を返す。
getUTCFullYear() 協定世界時 (UTC) で現在の年を 4 桁の数値 (YYYY) で返す。
getUTCHours() 協定世界時 (UTC) で現在の時に該当する数値を返す。
getUTCMilliseconds() 協定世界時 (UTC) で現在時刻のミリ秒に該当する数値を返す。
getUTCMinutes() 協定世界時 (UTC) で現在時刻の分に該当する数値を返す。
getUTCSeconds() 協定世界時 (UTC) で現在時刻の秒に該当する数値を返す。

Date.prototype setter メソッド

Date.prototype setter メソッドは、日付に関する情報を設定するためのメソッドである。 最もよく使用される代表的な setter メソッドは次のとおりである。

  1. setFullYear()
  2. setDate()

setFullYear() メソッド

setFullYear() メソッドは、Date オブジェクトの値を特定の日付に設定する。

var date = new Date();
date.setFullYear(1982, 1, 19); // JavaScript では 2 月は 1 である。
date.getFullYear();            // 1982
date.getMonth();               // 1
date.getDate();                // 19

setDate() メソッド

setDate() メソッドは、Date オブジェクトの日付値を特定の日付に設定する。

var date = new Date();
date.setDate(10);              // Date オブジェクトの日付値を 10 日に設定する。
document.write(date + "<br>");
date.setDate(40);              // 40 日を設定すると、超過した日数だけ翌月へ移る。
document.write(date);

JavaScript Date.prototype setter メソッド

メソッド 説明 値の範囲
setDate() 現地時刻で特定の日付を設定する。 1 ~ 31
setMonth() 現地時刻で特定の月を設定する。 0 ~ 11
setFullYear() 現地時刻で特定の年を設定する。(年だけでなく月と日付も設定できる) YYYY, MM, DD
setHours() 現地時刻で特定の時を設定する。 0 ~ 23
setMilliseconds() 現地時刻で特定のミリ秒を設定する。 0 ~ 999
setMinutes() 現地時刻で特定の分を設定する。 0 ~ 59
setSeconds() 現地時刻で特定の秒を設定する。 0 ~ 59
setTime() 1970 年 1 月 1 日 0 時 0 分 0 秒からミリ秒単位で表される特定の時刻を設定する。 -

JavaScript には setDay() メソッドは存在しない。

JavaScript Date.prototype UTC setter メソッド

メソッド 説明 値の範囲
setUTCDate() 協定世界時 (UTC) で特定の日付を設定する。 1 ~ 31
setUTCMonth() 協定世界時 (UTC) で特定の月を設定する。 0 ~ 11
setUTCFullYear() 協定世界時 (UTC) で特定の年を設定する。(年だけでなく月と日付も設定できる) YYYY, MM, DD
setUTCHours() 協定世界時 (UTC) で特定の時を設定する。 0 ~ 23
setUTCMilliseconds() 協定世界時 (UTC) で特定のミリ秒を設定する。 0 ~ 999
setUTCMinutes() 協定世界時 (UTC) で特定の分を設定する。 0 ~ 59
setUTCSeconds() 協定世界時 (UTC) で特定の秒を設定する。 0 ~ 59