setUTCHours / setUTCMinutes / setUTCSeconds / setUTCMillisecondsメソッド

広告

Dateクラスのオブジェクトに対して時刻に関する時/分/秒/ミリ秒の値を設定するメソッドがそれぞれ用意されています。このページで解説しているメソッドはタイムゾーンがUTCでの値を設定します。 

setUTCHours(hour[, min[, sec[, ms]]])

Dateクラスのオブジェクトに対して時の値を設定します。

パラメータ:
  hour  時を表す0から23の数値
  min  分を表す0から59の数値(オプション)
  sec  秒を表す0から59の数値(オプション)
  ms  ミリ秒を表す0から999の数値(オプション)
戻り値:
  設定変更後のDateクラスのオブジェクトをミリ秒形式に変換した値

setUTCHoursメソッドは時の値を設定します。設定できる値は0から23までの数値で午前0時で0、午後23時で11を設定します。またオプションで分、秒及びミリ秒の値を設定することもできます。戻り値として設定変更したDateクラスのオブジェクトをミリ秒形式に変換した値が返されます。 

setUTCMinutes(min[, sec[, ms]])

Dateクラスのオブジェクトに対して分の値を設定します。

パラメータ:
  min  分を表す0から59の数値
  sec  秒を表す0から59の数値(オプション)
  ms  ミリ秒を表す0から999の数値(オプション)
戻り値:
  設定変更後のDateクラスのオブジェクトをミリ秒形式に変換した値

setUTCMinutesメソッドは分の値を設定します。設定できる値は0から59までの数値で10分なら10を設定します。またオプションで秒及びミリ秒の値を設定することもできます。戻り値として設定変更したDateクラスのオブジェクトをミリ秒形式に変換した値が返されます。 

setUTCSeconds(sec[, ms])

Dateクラスのオブジェクトに対して秒の値を設定します。

パラメータ:
  sec  秒を表す0から59の数値
  ms  ミリ秒を表す0から999の数値(オプション)
戻り値:
  設定変更後のDateクラスのオブジェクトをミリ秒形式に変換した値

setUTCSecondsメソッドは秒の値を設定します。設定できる値は0から59までの数値で45秒なら45を設定します。戻り値として設定変更したDateクラスのオブジェクトをミリ秒形式に変換した値が返されます。 

setUTCMilliseconds(ms)

Dateクラスのオブジェクトに対してミリ秒の値を設定します。

パラメータ:
  ms  ミリ秒を表す0から999の数値
戻り値:
  設定変更後のDateクラスのオブジェクトをミリ秒形式に変換した値

setUTCMillisecondsメソッドはミリ秒の値を設定します。設定できる値は0から999までの数値です。戻り値として設定変更したDateクラスのオブジェクトをミリ秒形式に変換した値が返されます。

実際の使い方は次の通りです。 

var d = new Date();

d.setUTCMinutes(0, 0);
d.setUTCMilliseconds(300);

なおタイムゾーンが現地時間の値として設定します。タイムゾーンがUTCとして各値を設定するには「setHours / setMinutes / setSeconds / setMillisecondsメソッド」を参照して下さい。

サンプルコード

では簡単なサンプルで試してみます。 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ja" lang="ja">
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<meta http-equiv="Content-Script-Type" content="text/javascript">
<title>JavaScript テスト</title>
</head>
<body>

<script type="text/javascript" src="./js/script17_1.js">
</script>

</body>
</html>

function print(str){
  document.write(str + "<br />");
}

document.write("<p>");

var d = new Date();

print(d.toUTCString());

d.setUTCMinutes(59, 59, 999);

print(d.toUTCString());

document.write("</p>");

上記を実際にブラウザ見てみると次のように表示されます。

p17-1

( Written by Tatsuo Ikura )