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

JavaScriptのDate.getUTCMinutes()メソッドの使い方を徹底解説

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

var dateObj = new Date();

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

getUTCMinutes()メソッドとは

getUTCMinutes()は、Dateオブジェクトが保持する日時のうち「分」を表す0〜59の整数を、協定世界時（UTC）に基づいて返すメソッドです。

構文

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

dateObj.getUTCMinutes();

引数は不要で、呼び出し元のDateオブジェクトが持つ日時情報をもとに、UTCの「分」が計算されて返されます。

使用例1：指定した日時から「分」を取得する

次の例では、文字列で日時を指定してDateオブジェクトを作成し、UTCに基づく「分」を取得して表示しています。

<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(dateObj.getUTCMinutes());
   </script>
</body>
</html>

出力結果

34

ローカル時刻では「4分」ですが、UTCでは「34分」と表示されています。これは、実行環境のタイムゾーンがUTCと30分単位でずれている場合（例：インド標準時 GMT+05:30 など）、その差が変換時に反映されるためです。タイムゾーンによっては、ローカル時刻とUTCで「分」の値が異なることがある点に注意してください。

使用例2：「分」を指定しない場合

Dateオブジェクトの作成時に時刻の「分」を省略した場合、このメソッドはUTCに基づいて0を返します。

<html>
<head>
   <title>JavaScript Example</title>
</head>
<body>
   <script type="text/javascript">
      var dataobj = new Date('September 26, 1989 GMT+11:00');
      document.write("Minutes: "+dataobj.getUTCMinutes());
   </script>
</body>
</html>

出力結果

Minutes: 0

使用例3：現在の時刻から「分」を取得する

同様に、Dateオブジェクトのコンストラクタに何も渡さなかった場合は現在の日時が設定されるため、このメソッドは現在時刻におけるUTCの「分」を返します。

<html>
<head>
   <title>JavaScript Example</title>
</head>
<body>
   <script type="text/javascript">
      var dateObj = new Date();
      document.write("Minutes: "+dateObj.getUTCMinutes());
   </script>
</body>
</html>

出力結果

Minutes: 44

まとめ

  • getUTCMinutes()は、UTC（協定世界時）に基づいて「分」を0〜59の整数で返すメソッドである
  • 日時の作成時に「分」を指定しない場合は0が返る
  • コンストラクタに引数を渡さなければ、現在時刻のUTCにおける「分」が返る

なお、ローカル時刻を基準に「分」を取得したい場合はgetMinutes()を、UTC基準で「分」を設定したい場合はsetUTCMinutes()を使用してください。

  1. JavaScriptのDate.toDateString()メソッドの使い方を徹底解説

    Dateオブジェクトは、JavaScript言語に標準で組み込まれているデータ型です。Dateオブジェクトは、以下のようにnew Date()を使って生成します。一度Dateオブジェクトを作成すると、さまざまなメソッドを使ってそのオブジェクトを操作できます。ほとんどのメソッドは、ローカル時間またはUTC（協定世界時・グリニッジ標準時）のいずれかを基準として、オブジェクトが持つ年、月、日、時、分、秒、ミリ秒の各フィールドを取得・設定するためのものです。その中でもtoDateString()メソッドは、時刻情報を除いた「日付部分のみ」を文字列として返すメソッドです。構文toDateString()

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

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