【JavaScript ECMAScript】Date::Date.prototype.setUTCMonthインスタンスメソッドの使い方
Date.prototype.setUTCMonth()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
Date.prototype.setUTCMonth()メソッドは、JavaScriptのDateオブジェクトに対して、協定世界時（UTC）に基づいて月を設定するメソッドです。UTCは、世界中で時刻を統一するための標準時を指します。
このメソッドは、設定したい月を0から11の整数で指定します。例えば、0は1月、5は6月、11は12月を表します。また、オプションとして日付（1から31の整数）も指定できます。日付を省略した場合、そのDateオブジェクトの現在の日にちが使用されます。
設定する月の値が0未満であったり、11を超える値であったりしても、JavaScriptは自動的に適切な年に調整を行います。例えば、月を13と指定すると、翌年の2月として扱われます。
このメソッドを実行すると、対象のDateオブジェクト自身の月と年が直接変更されます。そのため、元のDateオブジェクトが変更されることに注意が必要です。メソッドの戻り値は、変更後の日付と時刻を表す1970年1月1日UTCからの経過ミリ秒数です。現地時間ではなく、世界標準時として日付の月を変更したい場合に活用されます。
公式リファレンス: Date.prototype.setUTCMonth()
構文(syntax)
1const dateObject = new Date(); 2dateObject.setUTCMonth(monthIndex, dayOfMonth);
引数(parameters)
monthIndex, dayValue
- monthIndex: number: 設定する月を表す0から11までの整数（0は1月、11は12月）
- dayValue: number = 1: 月の日付（1から31まで）を指定します。省略された場合、または日数が月の最大日数を超える場合は、翌月の日付として扱われます。
戻り値(return)
Number
setUTCMonth() メソッドは、指定された UTC（協定世界時）月を設定した後の、この Date オブジェクトのミリ秒単位でのタイムスタンプを返します。