JavaScript
 Computer >> コンピューター >  >> プログラミング >> JavaScript

JavaScriptのDate.setUTCMinutes()関数の使い方を徹底解説

DateオブジェクトとsetUTCMinutes()メソッドの基本

Dateオブジェクトは、JavaScriptに組み込みで用意されているデータ型の一つで、日付や時刻を扱うために使用します。Dateオブジェクトは、次のようにnew Date()によって生成できます。

一度Dateオブジェクトを作成すれば、数多くのメソッドを使って操作できます。これらのメソッドの多くは、ローカル時刻またはUTC（協定世界時／GMT）を基準として、年・月・日・時・分・秒・ミリ秒の各フィールドを取得・設定するためのものです。

setUTCMinutes()は、分を表す整数値を受け取り、協定世界時（UTC）に基づいて現在の日付（時刻）が持つ「分」の値を新しい値に置き換えるメソッドです。

構文

構文は以下のとおりです。

dateObj.setUTCMinutes(minutesValue);

引数

  • minutesValue：設定する分を表す整数。0〜59の範囲で指定します。範囲外の値を渡すと、日時は自動的に繰り上げ・繰り下げされます。

サンプル1：既存の日付の分を変更する

まず、生成済みのDateオブジェクトに対してsetUTCMinutes()を呼び出し、「分」の値を書き換える基本的な例を見てみましょう。

<html>
<head>
    <title>JavaScript Example</title>
</head>
<body>
    <script type="text/javascript">
        var dateObj = new Date('september 26, 89 12:4:25:96');
        document.write("Current date: "+dateObj.toUTCString());
        document.write("<br>");
        dateObj.setUTCMinutes(58);
        document.write("Value of minutes after modification: "+dateObj.toUTCString());
    </script>
</body>
</html>

実行結果

Current date: Tue, 26 Sep 1989 06:34:25 GMT
Value of minutes after modification: Tue, 26 Sep 1989 06:58:25 GMT

このように、元の分の値「34」がsetUTCMinutes(58)の呼び出しによって「58」に更新されました。

サンプル2：分を指定せずに生成した日付へ分を設定する

Dateオブジェクトの生成時に時刻（分）を指定していなくても、後からsetUTCMinutes()を使ってUTC基準で分を設定できます。

<html>
<head>
    <title>JavaScript Example</title>
</head>
<body>
    <script type="text/javascript">
        var dateObj = new Date('September 26, 1989');
        dateObj.setUTCMinutes(15);
        document.write(dateObj.toString());
    </script>
</body>
</html>

実行結果

Tue Sep 26 1989 00:15:00 GMT+0530 (India Standard Time)

サンプル3：現在日時に基づいて分を設定する

同様に、コンストラクタに引数を一切渡さずにDateオブジェクトを生成した場合でも、分を設定することが可能です。このとき、月・日・年などの他の値は現在の日付（時刻）のまま維持されます。

<html>
<head>
    <title>JavaScript Example</title>
</head>
<body>
    <script type="text/javascript">
        var dateObj = new Date();
        dateObj.setMinutes(15);
        document.write(dateObj.toString());
    </script>
</body>
</html>

実行結果

Thu Oct 18 2018 22:15:48 GMT+0530 (India Standard Time)

setMinutes()とsetUTCMinutes()の違いに注意

サンプル3のコードでは、ローカル時刻を基準に分を設定するsetMinutes()を使用しています。両者の主な違いは以下のとおりです。

  • setMinutes()：ブラウザのローカルタイムゾーンに基づいて分を設定する
  • setUTCMinutes()：協定世界時（UTC）に基づいて分を設定する

日本標準時（JST、UTC+9）など特定のタイムゾーンで動作させる場合は、どちらのメソッドを選ぶかによって結果が変わるため、用途に応じて適切に使い分けましょう。

  1. JavaScriptのDate.setUTCMonth()メソッドとは？構文と使い方を実例付きで解説

    Dateオブジェクトは、JavaScriptに組み込まれているデータ型の一つです。Dateオブジェクトは、次のように new Date() を使って生成します。 Dateオブジェクトを生成すると、多数のメソッドを使ってそのオブジェクトを操作できます。ほとんどのメソッドは、ローカル時間またはUTC（協定世界時／GMT）のいずれかの時刻基準で、年・月・日・時・分・秒・ミリ秒の各フィールドを取得・設定するためのものです。 setUTCMonth()メソッドは、年の月を表す整数を受け取り、UTC（協定世界時）に基づいて現在の日付の「月」の値を置き換えます。月の値は0が1月を表し、以降は11が12月に

  2. JavaScriptのDate.@@toPrimitive()関数とは？日付オブジェクトをプリミティブ値に変換する方法

    JavaScriptのDate.@@toPrimitive()関数は、Dateオブジェクトをプリミティブ値に変換するために使用されます。このメソッドはSymbol.toPrimitiveプロパティを通じて呼び出され、引数に指定したヒント（hint）に応じて、文字列や数値など適切なプリミティブ値を返します。 ヒントの種類と戻り値 「default」：日付を表す文字列が返されます。 「number」：1970年1月1日00:00:00 UTCからの経過ミリ秒数（タイムスタンプ）が数値で返されます。 「string」：「default」と同様に、日付を表す文字列が返されます。 サンプルコード 以