2021年8月8日

日付 と 時刻

新しい組み込みオブジェクトを見ていきましょう: Date。日付や時刻を保存し、管理するためのメソッドを提供します。

例えば、作成/修正時刻を保存したり、時間を測定したり、単に現在の時刻を表示するために使うことができます。

作成

新しい Date オブジェクトを作るには、 次のいずれかの引数で new Date() を呼びます:

new Date()

引数なし – 現在の日付と時刻で Date オブジェクトを作ります:

let now = new Date();
alert( now ); // 現在の日時を表示します
new Date(milliseconds)

Jan 1st of 1970 UTC+0 (1970年 1月1日 UTC+0) からの経過したミリ秒(秒の1/1000)に等しい時間をもつ Date オブジェクトを作ります。

// 0 は 01.01.1970 UTC+0 を意味します
let Jan01_1970 = new Date(0);
alert( Jan01_1970 );

// 今 24 時間を追加しました, 02.01.1970 UTC+0 になります
let Jan02_1970 = new Date(24 * 3600 * 1000);
alert( Jan02_1970 );

1970年初めから経過したミリ秒の数値は タイムスタンプ と呼ばれます。

これは日付の軽量な数値表現です。常に new Date(timestamp) を使ってタイムスタンプから日付を作成し、存在する Date オブジェクトを date.getTime() メソッド(後述) を使ってタイムスタンプに変換します。

1970.01.01 以前の日付は負のタイムスタンプになります。例:

// 31 Dec 1969
let Dec31_1969 = new Date(-24 * 3600 * 1000);
alert( Dec31_1969 );
new Date(datestring)

1つの引数でそれが文字列の場合、自動でパースされます。Date.parse アルゴリズム(後述)でパースされます。

let date = new Date("2017-01-26");
alert(date);
// 時刻が設定されていないので、GMT の深夜0時とみなされ、
// コーザルが実行されるタイムゾーンに応じて調整されます。
// したがって、結果は以下になります
// Thu Jan 26 2017 11:00:00 GMT+1100 (Australian Eastern Daylight Time)
// または
// Wed Jan 25 2017 16:00:00 GMT-0800 (Pacific Standard Time)
new Date(year, month, date, hours, minutes, seconds, ms)

ローカルタイムゾーンで、与えられた要素で日付を作成します。最初の2つの引数は必須です。

  • year は4桁でなければいけません。2013 はOKですが、98 はダメです。
  • month 0 (1月) から数え、11 (12月)までです。
  • date パラメータは実際の月の日です。もし指定がなければ 1 になります。
  • もし hours/minutes/seconds/ms がなければ、これらは 0 とみなされます。

例:

new Date(2011, 0, 1, 0, 0, 0, 0); // // 1 Jan 2011, 00:00:00
new Date(2011, 0, 1); // 同じです。時などはデフォルトで 0 です

最小の精度は 1ms (1/1000秒)です:

let date = new Date(2011, 0, 1, 2, 3, 4, 567);
alert( date ); // 1.01.2011, 02:03:04.567

date コンポーネントへのアクセス

Date オブジェクトから 年、月などへアクセスする多くのメソッドがあります。しかし、カテゴライズすることで簡単に覚えることができます。

getFullYear()
年を取得します(4桁)
getMonth()
月を取得します, 0から11。
getDate()
月の日を取得し、値は 1 から 31 です。メソッドの名前には少し違和感がありますが。
getHours(), getMinutes(), getSeconds(), getMilliseconds()
対応する時刻の構成要素を取得します。
getYear() ではなく getFullYear() です

多くのJavaScriptエンジンは 標準ではないメソッド getYear() を実装しています。このメソッドは非推奨です。これは2桁の年を返す時があるので、決して使わないでください。年の取得には getFullYear() があります。

加えて、週の曜日を取得することもできます: