【Node.js24.x】Date::getYear()メソッドの使い方
getYearメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
getYearメソッドは、Node.js環境で利用されるDateオブジェクトが保持する日付情報から、その年を表す数値を実行するメソッドです。このメソッドは、特定のDateインスタンスに対して呼び出すことで、対象の日付の年成分を取得します。
しかし、getYearメソッドには重要な特性があります。このメソッドの戻り値は、現在多くのプログラミング言語で採用されている西暦年数そのものではなく、「西暦年数から1900を引いた値」として表現されます。例えば、Dateオブジェクトが2024年を表す場合、getYearメソッドは「124」という数値を返します。これは、JavaScriptの初期の設計に由来する独特な挙動であり、現代のアプリケーション開発における一般的な年表現とは異なります。
この独特な挙動と、より直感的な年取得メソッドの存在のため、getYearメソッドはNode.jsを含む最新のJavaScript環境では非推奨（deprecated）とされています。新しいコードで年数を取得する際には、西暦年数をそのまま取得できるgetFullYearメソッドを使用することが強く推奨されます。getFullYearメソッドは、例えば2024年であれば「2024」という直感的な数値を返します。getYearメソッドは将来的に言語仕様から削除される可能性もあるため、互換性や保守性を考慮し、getFullYearメソッドへの移行をご検討ください。
構文(syntax)
1const date = new Date('2024-01-01T00:00:00Z'); 2const year = date.getYear(); 3console.log(year);
引数(parameters)
引数なし
引数はありません
戻り値(return)
number
このメソッドは、Dateオブジェクトが表す西暦年を数値で返します。例えば、1999年なら1999、2023年なら2023を返します。