Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【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桁の数値で返します。

関連コンテンツ

関連プログラミング言語