Ruby Time#yearメソッドの使い方

  • Ruby
  • メソッド
最終更新日:

この記事のポイント

Time#yearメソッドは、日付と時刻を扱う際に欠かせない基本的なメソッドです。この記事では以下のポイントを詳しく解説します。

  • Time#yearメソッドは現在の年や指定した日付から年だけを取得できる
  • 基本的な構文はtime_object.yearメソッドで4桁の整数として年が返される
  • 業務システムやWebアプリケーション開発でよく使われる実用的なメソッド

これらのポイントを理解すれば、Rubyでの日付処理が格段に楽になります。

目次

Time#yearメソッドとは？

Time#yearメソッドは、Timeオブジェクトから年の部分だけを整数で取得するメソッドです。このメソッドを使うことで、現在の日時や特定の日付から年だけを簡単に抽出できます。

戻り値は4桁の整数（例：2025）で、プログラム内で年の比較や計算、表示などに活用できます。Time#yearメソッドは日付処理において最も基本的で使用頻度の高いメソッドの一つで、業務システム開発やWebアプリケーション開発では必須の知識といえます。年の取得はさまざまな場面で必要になるため、しっかりと理解しておくことが重要です。

【関連】
Rubyをもっと詳しく学ぶならpaizaラーニング

基本構文

Time#yearメソッドの基本的な構文は非常にシンプルで、Timeオブジェクトに対してyearメソッドを呼び出すだけです。まず現在の日時から年を取得する場合、Time.now.yearと記述します。また、特定の日付を作成してから年を取得することも可能で、Time.new(2024, 12, 25).yearのように書けば、指定した日付の年を得られます。戻り値は必ず整数型で返されるため、数値として計算処理に直接使用できます。エラーが発生することは基本的になく、安全に使用できるメソッドです。

# 現在の年を取得 current_year = Time.now.year puts current_year







出力結果（例）
2025
※このページ内のコードの出力結果の一部で、実行した時刻により変動するものがあります。また、時刻はUTC形式で計算されるため、日本時間での計算結果と異なる場合があります

  
# 特定の日付から年を取得
specific_date = Time.new(2023, 6, 15)
year = specific_date.year
puts year

  


  







出力結果
2023
実用例
ここからは、Time#yearメソッドの実用的な使い方を具体的なコード例とともに紹介します。実際の開発現場でよく使われるパターンを8つのサンプルコードで解説していきます。
各コード例では、メソッドの特徴を活かした実装方法を示し、すぐに実践で使える形で記載しています。初心者の方でも理解しやすいよう、コードの前後に詳しい説明を加えており、なぜそのような実装になるのかも含めて学べるようになっています。これらの例を参考にすることで、Time#yearメソッドのさまざまな活用方法を身につけることができます。
現在の年を取得する基本的な使い方
最も基本的な使用方法として、現在の年を取得してメッセージに表示する例です。システムの起動時やログ出力時によく使われます。以下のコードは現在の年を動的に取得するため、年が変わっても自動的に正しい値が表示されます。

  
# 現在の年を使った挨拶メッセージ
current_year = Time.now.year
animal = "ネコ"
puts "#{current_year}年も#{animal}と一緒に頑張りましょう！"
puts "今年は#{current_year}年です"

  


  







出力結果（例）
2025年もネコと一緒に頑張りましょう！
今年は2025年です
特定の日付から年を抽出
過去や未来の特定の日付から年だけを取り出す例です。データベースに保存されている日付情報の処理でよく使用されます。Timeオブジェクトから必要な年の情報だけを簡単に抽出できます。

  
# 動物の誕生日から年を抽出
birth_date = Time.new(2018, 4, 22, 10, 30)
birth_year = birth_date.year
animal_name = "イヌ"
puts "#{animal_name}が生まれたのは#{birth_year}年です"

  


  







出力結果
イヌが生まれたのは2018年です
年の比較処理
異なる年を比較して条件分岐を行う例です。期限チェックやバージョン管理システムなどで活用できます。年の比較により、時系列の判定や期間の計算が可能になります。

  
# 2つの年を比較する処理
old_date = Time.new(2020, 8, 15)
new_date = Time.new(2025, 8, 15)
animal = "ウサギ"

if new_date.year > old_date.year
  puts "#{animal}は#{old_date.year}年からすくすく成長してます"
end

  


  







出力結果
ウサギは2020年からすくすく成長してます
生年月日から年齢を計算
生年月日から現在の年齢を計算する実用的な例です。会員管理システムや年齢制限のあるサービスで使用されます。以下のコードは年の差分を利用してシンプルに年齢計算を行っています。

  
# 動物の年齢を計算
birth_year = Time.new(2019, 3, 10).year
current_year = Time.now.year
age = current_year - birth_year
animal = "パンダ"
puts "#{animal}は#{age}歳になりました"

  


  







出力結果（例）
パンダは6歳になりました
ログファイル名に年を含める
システムのログファイル名に年を含めて管理する例です。運用システムでログを年別に分類する際に使用されます。年を含めることでファイルの整理と管理が効率的になります。

  
# 年別ログファイル名の生成
log_year = Time.now.year
animal_type = "サル"
log_filename = "#{animal_type}_activity_#{log_year}.log"
puts "ログファイル名: #{log_filename}"
puts "#{log_year}年のデータを記録します"

  


  







出力結果（例）
ログファイル名: サル_activity_2025.log
2025年のデータを記録します
年度判定
日本の年度（4月始まり）を判定する例です。学校や企業の業務システムでよく使用される実装パターンです。月の条件により適切な年度を判定できます。

  
# 年度の判定処理
current_time = Time.new(2024, 3, 15)
year = current_time.year
fiscal_year = current_time.month >= 4 ? year : year - 1
animal = "シカ"
puts "#{animal}の記録: #{fiscal_year}年度"

  


  







出力結果
シカの記録: 2023年度
複数の日付から年のリストを作成
複数の日付データから年だけを抽出してリスト化する例です。データ分析や統計処理でよく使用されます。mapメソッドと組み合わせることで効率的にデータ処理ができます。

  
# 複数の日付から年のリストを作成
dates = [Time.new(2021, 5, 1), Time.new(2022, 8, 20), Time.new(2024, 1, 10)]
years = dates.map(&:year)
animal = "ライオン"
puts "#{animal}の記録年: #{years.join(', ')}"

  


  







出力結果
ライオンの記録年: 2021, 2022, 2024
年の範囲チェック
指定した年の範囲内かどうかをチェックする例です。データの妥当性検証や期間限定機能で使用されます。範囲オブジェクトを使って年の妥当性を簡単にチェックできます。

  
# 年の範囲チェック
check_date = Time.new(2023, 7, 28)
target_year = check_date.year
min_year, max_year = 2020, 2025
animal = "ゾウ"

if (min_year..max_year).include?(target_year)
  puts "#{animal}のデータ(#{target_year}年)は有効です"
end

  


  







出力結果
ゾウのデータ(2023年)は有効です
まとめ
Time#yearメソッドは、日付処理において非常に重要で実用的なメソッドです。基本的な構文から実用例まで見てきましたが、このメソッドの理解により、Rubyでの時間処理がより効率的になります。現在の年の取得から複雑な年度判定まで、さまざまな場面で活用できる汎用性の高いメソッドといえるでしょう。
Time#yearメソッドの活躍する場面
    

  • 業務システムでの年度管理や期間判定処理
    • 

  • ログファイルやデータの年別分類システム
    • 

  • 年齢計算や期限チェック機能の実装
    • 

重要なポイント
    

  • 戻り値は必ず4桁の整数で安全に計算処理可能
    • 

  • 現在日時と特定日時の両方から年を取得できる
    • 

  • 他のメソッドとの組み合わせで高度な処理が可能
    • 

実際の開発現場では必須の知識であり、マスターしておくことで開発効率が大幅に向上します。今回紹介したコード例を参考に、実際の開発で積極的に活用してみてください。
レベルを更に上げたい方はpaizaプログラミングスキルチェックへ





























  1. paizaラーニングトップ
  2. リファレンス
  3. Rubyのリファレンス記事一覧
  4. Ruby Time#yearメソッドの使い方