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

JavaScriptのDate.getUTCMonth()関数とは？使い方をわかりやすく解説

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

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

DateオブジェクトのgetUTCMonth()関数は、協定世界時（UTC）に基づいて、対象となる日付の「月」を返します。返り値は0始まりで、0が1月、1が2月というように対応しています。

構文

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

dateObj.getUTCMonth();

使用例

<html>
<head>
    <title>JavaScript Example</title>
</head>
<body>
    <script type="text/javascript">
        var dateObj = new Date('September 26, 1989 12:4:25:96');
        document.write(dateObj.getUTCMonth());
    </script>
</body>
</html>

実行結果

8

9月は0始まりのカウントで8番目に相当するため、結果は「8」となります。

月を指定せずにDateオブジェクトを作成した場合

Dateオブジェクトの作成時に月を指定しなかった場合は、この関数は協定世界時に基づいて 0 を返します。

<html>
<head>
    <title>JavaScript Example</title>
</head>
<body>
    <script type="text/javascript">
        var dateObj = new Date('1989 12:4:25:96');
        document.write(dateObj.getUTCMonth());
    </script>
</body>
</html>

実行結果

0

引数なしでDateオブジェクトを作成した場合

同様に、Dateオブジェクトの作成時に引数を一切渡さなかった場合は、現在の日時が採用され、協定世界時に基づいた現在の月が返されます。

<html>
<head>
    <title>JavaScript Example</title>
</head>
<body>
    <script type="text/javascript">
        var dateObj = new Date();
        document.write("Month of the year: " + dateObj.getUTCMonth());
    </script>
</body>
</html>

実行結果

Month of the year: 9

まとめ

  • getUTCMonth() はUTC基準で月を0〜11の数値として返す
  • 1月＝0、12月＝11 である点に注意が必要
  • 月を省略した日付文字列から生成した場合は 0 を返す
  • 引数なしで生成した場合は現在の月を返す

実際の開発では、取得した値に1を足して表示に使うケースが多いため、「戻り値は0始まり」という仕様を必ず覚えておきましょう。

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