【Node.js24.x】Date::getFullYear()メソッドの使い方
getFullYearメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
getFullYearメソッドは、Node.jsの組み込みオブジェクトであるDateクラスのインスタンスから、その日付が示す「年」の値を正確に取得するために使用されるメソッドです。このメソッドをDateオブジェクトのインスタンスに対して呼び出すと、その日付が示す西暦の年を4桁の整数値として抽出できます。例えば、2024年1月1日のDateオブジェクトに対してこのメソッドを実行すると、「2024」という数値が戻り値として返されます。
この機能は、特定の日付情報から年だけを取り出して表示したり、年を基準とした比較や計算を行ったりする際に非常に便利です。getFullYearメソッドが返す年は、システムが設定しているローカルタイムゾーンに基づいて計算されます。もし協定世界時(UTC)における年を取得する必要がある場合は、代わりにgetUTCFullYearメソッドを使用してください。
getFullYearメソッドは引数を必要とせず、常に現在のDateインスタンスが持つ年情報のみを返します。Dateオブジェクトを扱う上で、日付の構成要素である年を正確に、かつ簡潔に取得するための基本的な手段として、多くのプログラマに利用されています。このメソッドを用いることで、日付の操作がより直感的かつ安全に行えるようになります。
構文(syntax)
1const date = new Date(); 2const year = date.getFullYear();
引数(parameters)
引数なし
引数はありません
戻り値(return)
number
指定されたDateオブジェクトの年を4桁の数値で返します。