Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【JavaScript ECMAScript】Date::Date.prototype.getUTCDayインスタンスメソッドの使い方

Date.prototype.getUTCDay()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

Date.prototype.getUTCDay()メソッドは、指定されたDateオブジェクトが保持する日付と時刻情報に基づき、UTC(協定世界時)における曜日を数値で取得するメソッドです。このメソッドは、タイムゾーンの影響を受けずに、世界標準時での曜日を知りたい場合に特に有用です。

戻り値は0から6までの整数であり、各数値は特定の曜日を表します。具体的には、0が日曜日、1が月曜日、2が火曜日、3が水曜日、4が木曜日、5が金曜日、そして6が土曜日を意味します。この数値は、JavaScriptのDateオブジェクトで一般的に使用される曜日の表現方法に準拠しています。

例えば、Dateオブジェクトが日本時間の特定の日時を表している場合でも、getUTCDay()メソッドは、その日時がUTCにおいて何曜日であるかを返します。これにより、グローバルなアプリケーション開発において、特定の地域やユーザーのタイムゾーンに依存しない曜日の計算や表示を行うことが可能になります。このメソッドは、日付や時刻の情報を変更するものではなく、あくまで既存の情報から曜日を抽出する目的で使用されます。

公式リファレンス: Date.prototype.getUTCDay()

構文(syntax)

1const date = new Date();
2const day = date.getUTCDay();

引数(parameters)

引数なし

引数はありません

戻り値(return)

Number

Date.prototype.getUTCDay()は、UTC(協定世界時)における曜日を数値で返します。0は日曜日、1は月曜日、...、6は土曜日を表します。

関連コンテンツ

関連プログラミング言語