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

JavaScriptのDate.getMinutes()メソッドとは？使い方をサンプル付きで解説

Dateオブジェクトは、JavaScript言語に組み込まれているデータ型の一つです。Dateオブジェクトは、new Date() を使って次のように生成します。

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

本記事で解説する getMinutes() メソッドは、Dateオブジェクトが保持する日時のうち「分」の部分を返します。戻り値は 0〜59 の整数です。

構文

getMinutes() メソッドの構文は以下のとおりです。引数は不要で、対象となるDateオブジェクトに対して呼び出します。

dateObj.getMinutes();

使用例1：日時を指定して分を取得する

次の例では、日時を文字列で指定してDateオブジェクトを生成し、その「分」を取得しています。

<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("Minutes: "+dateObj.getMinutes());
   </script>
</body>
</html>

実行結果

Minutes: 4

指定した時刻が「12時4分」であるため、「4」が出力されます。

使用例2：分を指定しなかった場合

日付オブジェクトの生成時に時刻の「分」を省略した場合、このメソッドは 0 を返します。

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

実行結果

Minutes: 0

時刻が指定されていないため、分はデフォルト値の「0」として扱われます。

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

コンストラクタに何も引数を渡さずにDateオブジェクトを生成した場合、このメソッドは現在の時刻の「分」を返します。実行するタイミングによって結果は異なります。

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

実行結果

Minutes: 30

この例では、スクリプトを実行した瞬間の時刻が「30分」だったため、「30」が出力されています。

まとめ

  • getMinutes() は、Dateオブジェクトの「分」（0〜59）を数値で返すメソッド。
  • 日時の生成時に分を省略した場合は 0 が返る。
  • 引数なしで new Date() を使えば、現在時刻の分を取得できる。

なお、古い document.write() は現在では非推奨とされているため、実際の開発では console.log() を使って確認するのが一般的です。

  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」と同様に、日付を表す文字列が返されます。 サンプルコード 以