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 メソッドは次のとおりである。
- getFullYear()
- getDate()
- getDay()
- 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 メソッドは次のとおりである。
- setFullYear()
- 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 |