【Ruby3.x】File::Stat::birthtime()メソッドの使い方
birthtimeメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
birthtimeメソッドは、ファイルの作成時刻を取得するメソッドです。このメソッドは、File::Statクラスのインスタンスに対して呼び出され、ファイルシステム上で指定されたファイルが最初に作成された日時をTimeオブジェクトとして返します。
File::Statオブジェクトは、File.stat("ファイルパス")やFile.lstat("ファイルパス")などのメソッドを使用して取得できます。その後、取得したFile::Statオブジェクトに対して.birthtimeと呼び出すことで、そのファイルの作成時刻を確認できます。例えば、File.stat("document.txt").birthtimeと記述すると、「document.txt」というファイルの作成時刻が取得されます。
この作成時刻は、ファイルの内容が最後に更新された時刻（mtime）や、ファイルが最後に読み書きされた時刻（atime）とは異なり、ファイルが「いつ生まれたか」を示す情報です。ただし、オペレーティングシステムやファイルシステムの仕様によっては、作成時刻の情報を正確に保持していない場合があります。その場合、このメソッドはファイルのinodeが最後に変更された時刻（ctime）と同じ値を返すことがありますので、使用する際は環境に依存する可能性を考慮してください。ファイルの履歴を調査する際などに役立つ、基本的ながらも重要な情報を提供するメソッドです。
構文(syntax)
1File.stat(__FILE__).birthtime
引数(parameters)
引数なし
引数はありません
戻り値(return)
Time
File::Stat#birthtime は、ファイルが作成された日時を表す Time オブジェクトを返します。