Dateオブジェクトの値から年、月、分、秒などの値を取得する

Date オブジェクトのインスタンスメソッドである getFullYear は Date オブジェクトが持つ値から年の値を取得します。同様に月、日、曜日、時、分、秒、ミリ秒の値を Date オブジェクトの値からそれぞれ取得するメソッドが用意されています。

また Date オブジェクトのインスタンスメソッドである getUTCFullYear は Date オブジェクトが持つ値から年の値を UTC タイムゾーンでの値として取得します。同様に UTC タイムゾーンでの月、日、曜日、時、分、秒、ミリ秒の値を Date オブジェクトの値からそれぞれ取得するメソッドが用意されています。

ここでは Date オブジェクトの getFullYear メソッドなど Date オブジェクトの値から日付や時間に関する値を取得するメソッドの使い方について解説します。

(Last modified: 2024-09-11)

日付と時刻の値を取得するメソッドの一覧

Date オブジェクトが持つ値から日付と時刻の値をそれぞれ取得するメソッドとして次のものが用意されています。

それぞれのメソッドは Date クラスのオブジェクトが持つ値から年や分の値を個別に取得します。この時、ローカルの環境で設定されているタイムゾーンが使用されます。

同じように Date オブジェクトが持つ値から日付と時刻の値をそれぞれ取得しますが、 UTC タイムゾーンを使用して表された値を取得するメソッドとして次のものが用意されています。

それぞれのメソッドは Date クラスのオブジェクトが持つ値から年や分の値を個別に取得します。この時 UTC タイムゾーンが使用されます。

それでは順に見ていきます。

年、月、日、曜日の値を取得する

Date オブジェクトが持つ値から年、月、日、曜日の値を個別に取得するメソッドについて解説します。

年の値を取得する(getFullYear)

Date オブジェクトの getFullYear メソッドは、 Date オブジェクトが持つ日付と時刻の値からローカルのタイムゾーンでの「年」の値を数値で返します。書式は次の通りです。

Dateオブジェクト.getFullYear()

年の値を 1000 から 9999 までの 4 桁の数値で返します。 1994 年であれば 1994 を、 2020 年であれば 2020 を返します。

月の値を取得する(getMonth)

Date オブジェクトの getMonth メソッドは、 Date オブジェクトが持つ日付と時刻の値からローカルのタイムゾーンでの「月」の値を数値で返します。書式は次の通りです。

Dateオブジェクト.getMonth()

月の値を 0 から 11 の数値で返します。 0 が 1 月、 1 が 2月、 11 が 12 月に相当します。

日の値を取得する(getDate)

Date オブジェクトの getDate メソッドは、 Date オブジェクトが持つ日付と時刻の値からローカルのタイムゾーンでの「日」の値を数値で返します。書式は次の通りです。

Dateオブジェクト.getDate()

日の値を 1 から 31 の数値で返します。 1 が 1 日、 31 が 31 日に相当します。

曜日の値を取得する(getDay)

Date オブジェクトの getDay メソッドは、 Date オブジェクトが持つ日付と時刻の値からローカルのタイムゾーンでの「曜日」の値を数値で返します。書式は次の通りです。

Dateオブジェクト.getDay()

曜日の値を 0 から 6 の数値で返します。 0 が日曜日、 1 が月曜日、 6 が土曜日に相当します。

次のサンプルをみてください。

let d = new Date();
console.log(d.toString());
>> Fri Oct 16 2020 18:13:06 GMT+0900 (日本標準時)

let year = d.getFullYear();
let month = d.getMonth() + 1;
let day = d.getDate();
let dayofweek = d.getDay()

const dayname = ['日','月','火','水','木','金','土'];

console.log(year + '年' + month + '月' + day + '日' + '[' + dayname[dayofweek] + ']');
>> 2020年10月16日[金]

Date オブジェクトが持つ値から年、月、日、曜日の値をそれぞれ取得しました。月については 0 から 開始される点に注意してください。曜日を数値ではなく'月'や'火'などの曜日の文字として表示するために、表示用の配列を用意して曜日を表示しています。

時、分、秒、ミリ秒の値を取得する

Date オブジェクトが持つ値から時、分、秒、ミリ秒の値を個別に取得するメソッドについて解説します。

時の値を取得する(getHours)

Date オブジェクトの getHours メソッドは、 Date オブジェクトが持つ日付と時刻の値からローカルのタイムゾーンでの「時」の値を数値で返します。書式は次の通りです。

Dateオブジェクト.getHours()

時の値を 0 から 23 までの数値で返します。

分の値を取得する(getMinutes)

Date オブジェクトの getMinutes メソッドは、 Date オブジェクトが持つ日付と時刻の値からローカルのタイムゾーンでの「分」の値を数値で返します。書式は次の通りです。

Dateオブジェクト.getMinutes()

分の値を 0 から 59 までの数値で返します。

秒の値を取得する(getSeconds)

Date オブジェクトの getSeconds メソッドは、 Date オブジェクトが持つ日付と時刻の値からローカルのタイムゾーンでの「秒」の値を数値で返します。書式は次の通りです。

Dateオブジェクト.getSeconds()

秒の値を 0 から 59 までの数値で返します。

ミリ秒の値を取得する(getMilliseconds)

Date オブジェクトの getMilliseconds メソッドは、 Date オブジェクトが持つ日付と時刻の値からローカルのタイムゾーンでの「ミリ秒」の値を数値で返します。書式は次の通りです。

Dateオブジェクト.getMilliseconds()

Date オブジェクトが持つ値からミリ秒の値を 0 から 999 までの数値で返します。

次のサンプルをみてください。

let d = new Date();
console.log(d.toString());
>> Fri Oct 16 2020 18:15:10 GMT+0900 (日本標準時)

let hour = d.getHours();
let minute = d.getMinutes();
let second = d.getSeconds();
let millisecond = d.getMilliseconds();

console.log(hour + '時' + minute + '分' + second + '.' + millisecond + '秒');
>> 18時15分10.149秒

Date オブジェクトが持つ値から時、分、秒、ミリ秒の値をそれぞれ取得しました。

UTCタイムゾーンでの年、月、日、曜日の値を取得する

Date オブジェクトが持つ値からUTCタイムゾーンでの年、月、日、曜日の値を個別に取得するメソッドについて解説します。

UTCタイムゾーンでの年の値を取得する(getUTCFullYear)

Date オブジェクトの getUTCFullYear メソッドは、 Date オブジェクトが持つ日付と時刻の値から UTC タイムゾーンでの「年」の値を数値で返します。書式は次の通りです。

Dateオブジェクト.getUTCFullYear()

年の値を 1000 から 9999 までの 4 桁の数値で返します。 1994 年であれば 1994 を、 2020 年であれば 2020 を返します。

UTCタイムゾーンでの月の値を取得する(getUTCMonth)

Date オブジェクトの getUTCMonth メソッドは、 Date オブジェクトが持つ日付と時刻の値から UTC タイムゾーンでの「月」の値を数値で返します。書式は次の通りです。

Dateオブジェクト.getUTCMonth()

月の値を 0 から 11 の数値で返します。 0 が 1 月、 1 が 2月、 11 が 12 月に相当します。

UTCタイムゾーンでの日の値を取得する(getUTCDate)

Date オブジェクトの getUTCDate メソッドは、 Date オブジェクトが持つ日付と時刻の値から UTC タイムゾーンでの「日」の値を数値で返します。書式は次の通りです。

Dateオブジェクト.getUTCDate()

日の値を 1 から 31 の数値で返します。 1 が 1 日、 31 が 31 日に相当します。

UTCタイムゾーンでの曜日の値を取得する(getUTCDay)

Date オブジェクトの getUTCDay メソッドは、 Date オブジェクトが持つ日付と時刻の値から UTC タイムゾーンでの「曜日」の値を数値で返します。書式は次の通りです。

Dateオブジェクト.getUTCDay()

曜日の値を 0 から 6 の数値で返します。 0 が日曜日、 1 が月曜日、 6 が土曜日に相当します。

次のサンプルをみてください。

let d = new Date();
console.log(d.toUTCString());
>> Fri, 16 Oct 2020 10:13:23 GMT

let year = d.getUTCFullYear();
let month = d.getUTCMonth() + 1;
let day = d.getUTCDate();
let dayofweek = d.getUTCDay();

const dayname = ['日','月','火','水','木','金','土'];

console.log(year + '年' + month + '月' + day + '日' + '[' + dayname[dayofweek] + ']');
>> 2020年10月16日[金]

Date オブジェクトが持つ値から UTC タイムゾーンでの年、月、日、曜日の値をそれぞれ取得しました。月については 0 から 開始される点に注意してください。曜日を数値ではなく'月'や'火'などの曜日の文字として表示するために、表示用の配列を用意して曜日を表示しています。

UTCタイムゾーンでの時、分、秒、ミリ秒の値を取得する

Date オブジェクトが持つ値からUTCタイムゾーンでの時、分、秒、ミリ秒の値を個別に取得するメソッドについて解説します。

UTCタイムゾーンでの時の値を取得する(getUTCHours)

Date オブジェクトの getUTCHours メソッドは、 Date オブジェクトが持つ日付と時刻の値から UTC タイムゾーンでの「時」の値を数値で返します。書式は次の通りです。

Dateオブジェクト.getUTCHours()

時の値を 0 から 23 までの数値で返します。

UTCタイムゾーンでの分の値を取得する(getUTCMinutes)

Date オブジェクトの getUTCMinutes メソッドは、 Date オブジェクトが持つ日付と時刻の値から UTC タイムゾーンでの「分」の値を数値で返します。書式は次の通りです。

Dateオブジェクト.getUTCMinutes()

分の値を 0 から 59 までの数値で返します。

UTCタイムゾーンでの秒の値を取得する(getUTCSeconds)

Date オブジェクトの getUTCSeconds メソッドは、 Date オブジェクトが持つ日付と時刻の値から UTC タイムゾーンでの「秒」の値を数値で返します。書式は次の通りです。

Dateオブジェクト.getUTCSeconds()

秒の値を 0 から 59 までの数値で返します。

UTCタイムゾーンでのミリ秒の値を取得する(getUTCMilliseconds)

Date オブジェクトの getUTCMilliseconds メソッドは、 Date オブジェクトが持つ日付と時刻の値から UTC タイムゾーンでの「ミリ秒」の値を数値で返します。書式は次の通りです。

Dateオブジェクト.getUTCMilliseconds()

Date オブジェクトが持つ値からミリ秒の値を 0 から 999 までの数値で返します。

次のサンプルをみてください。

let d = new Date();
console.log(d.toUTCString());
>> Fri Oct 16 2020 18:15:10 GMT+0900 (日本標準時)

let hour = d.getUTCHours();
let minute = d.getUTCMinutes();
let second = d.getUTCSeconds();
let millisecond = d.getUTCMilliseconds();

console.log(hour + '時' + minute + '分' + second + '.' + millisecond + '秒');
>> 18時15分10.149秒

Date オブジェクトが持つ値から UTC タイムゾーンでの時、分、秒、ミリ秒の値をそれぞれ取得しました。

-- --

Date オブジェクトの getFullYear メソッドなど Date オブジェクトの値から日付や時間に関する値を取得するメソッドの使い方について解説しました。

著者 / TATSUO IKURA

これから IT 関連の知識を学ばれる方を対象に、色々な言語でのプログラミング方法や関連する技術、開発環境構築などに関する解説サイトを運営しています。