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

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

Dateオブジェクトとは

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

Dateオブジェクトを作成すると、さまざまなメソッドを使ってそのオブジェクトを操作できるようになります。ほとんどのメソッドは、ローカル時間またはUTC（協定世界時／GMT）のいずれかの時刻をもとに、オブジェクトが持つ年・月・日・時・分・秒・ミリ秒の各フィールドを取得・設定するためのものです。

DateオブジェクトのgetMonth()関数は、その日付の「月」を返します。戻り値は0始まりで、0が1月、1が2月、2が3月といった具合に対応します。

構文

構文は次のとおりです。

dateObj.getMonth();

使用例1：日付文字列を指定した場合

次の例では、日付文字列を指定してDateオブジェクトを作成し、getMonth()で月を取得しています。

<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("Month of the year: "+dateObj.getMonth());
    </script>
</body>
</html>

出力結果

Month of the year: 8

9月を指定してDateオブジェクトを作成しているため、0始まりの月番号である「8」が返されます。

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

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

<html>
<head>
    <title>JavaScript Example</title>
</head>
<body>
    <script type="text/javascript">
        var dateObj = new Date('89 12:4:25:96');
        document.write("Month of the year: "+dateObj.getMonth());
    </script>
</body>
</html>

出力結果

Month of the year: 0

使用例3：引数を何も渡さなかった場合

同様に、Dateオブジェクトの作成時に引数を一切渡さなかった場合は、実行した時点の「現在の年・現在の月」にもとづく値が返されます。

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

出力結果

Month of the year: 9

この出力例は10月に実行した場合のもので、実際に表示される数値はスクリプトを実行したタイミングによって変わります。

注意点

getMonth()は0始まりの値を返すため、人間が普段使う月の表記（1〜12月）とずれやすい点に注意が必要です。画面に表示する用途では、戻り値に1を加えて補正するか、toLocaleString()などのローカライズ対応メソッドを活用すると、意図しない表示ずれを防げます。

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