【Ruby3.x】File::mtime()メソッドの使い方

mtimeメソッドは、指定されたファイルの最終更新時刻（modification time）を取得するメソッドです。

このメソッドは、Rubyの組み込みクラスであるFileクラスに属しており、クラスメソッドとして呼び出します。引数として、時刻を知りたいファイルのパスを文字列で渡します。例えば、File.mtime("path/to/your/file.txt")のように記述して使用します。

ファイルパスが正しく、対象のファイルが存在する場合、mtimeメソッドはそのファイルが最後に変更された日時を表すTimeオブジェクトを返します。このTimeオブジェクトには、年、月、日、時、分、秒、タイムゾーンといった詳細な時間情報が含まれており、様々な時間の計算や表示に利用できます。ここで言う「最終更新時刻」とは、ファイルの内容が変更されたり、ファイルのメタデータ（例えばパーミッションなど）が変更されたりした際に更新されるタイムスタンプを指します。

もし、指定されたファイルが存在しない場合や、ファイルへのアクセス権がない場合には、Errno::ENOENTのような例外が発生する可能性があります。そのため、実際のアプリケーションで利用する際には、ファイルの存在確認や適切な例外処理を実装することが推奨されます。

mtimeメソッドは、ファイルの更新状況を監視したり、特定の日時以降に更新されたファイルを検索したり、あるいはファイルのバックアップ対象を判断したりするなど、ファイルシステムを操作する多くの場面で非常に有用です。システムエンジニアにとって、ファイルの状態を正確に把握することは、堅牢なシステムを構築する上で不可欠なスキルであり、このメソッドはその基礎を支える重要な機能の一つです。

Copy
1filename = "example.txt"
2File.write(filename, "このファイルを作成します。")
3modification_time = File.mtime(filename)
4puts "ファイルの最終更新時刻: #{modification_time}"
5File.delete(filename)

path

• path: File.mtime メソッドでタイムスタンプを取得したいファイルのパスを指定します。

Time

File.mtime は、ファイルが最後に更新された日時を表す Time オブジェクトを返します。