Date.prototype.setUTCDate()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

setUTCDate() メソッドは、指定された Date インスタンスの「日」を UTC 時刻に基づいて変更します。

ローカル時間に基づいて指定された Date インスタンスの「日」を変更するには、 setDate() メソッドを使用してください。

試してみましょう

構文

js
setUTCDate(dayValue)

引数

dayValue

任意。「日」を表す 1 から 31 までの間の整数値。

返値

協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 から更新された日時までの間のミリ秒単位の数値。

解説

もし dayValue がその月の日付値の範囲外だった場合、 setDate() は Date オブジェクトをそれに応じて更新します。

例えば、 dayValue に 0 が指定された場合、日付は前月の最終日に設定されます。もし dayValue に 40 を使用した場合、Date オブジェクトに格納されている月が 6 月であれば、日は 10 に変更され、月は 7 月に増加します。

もし dayValue に負の数が指定された場合、日付は前月の最終日から逆算して設定されます。 -1 の場合、日付は前月の最終日の 1 日前に設定されます。

例

setUTCDate() の使用

js
const theBigDay = new Date();
theBigDay.setUTCDate(20);

仕様書

Specification
ECMAScript Language Specification
# sec-date.prototype.setutcdate

ブラウザーの互換性

BCD tables only load in the browser

関連情報