【PHP8.x】getATimeメソッドの使い方

getATimeメソッドは、PHPのFilesystemIteratorクラスにおいて、現在イテレート（順に処理）しているファイルまたはディレクトリの最終アクセス時刻を取得するメソッドです。このメソッドは、ファイルやディレクトリが最後に読み込まれたり、実行されたりした日時を特定するために使用されます。

最終アクセス時刻とは、オペレーティングシステムが記録する情報の一つで、ファイルの内容が参照されたり、ディレクトリ内の項目がリスト表示されたりしたときに更新されます。例えば、テキストファイルをエディタで開いて内容を読んだり、画像ファイルを表示したりすると、この時刻が更新されることがあります。

getATimeメソッドは、取得したアクセス時刻をUNIXタイムスタンプという形式の整数値で返します。UNIXタイムスタンプは、1970年1月1日00:00:00 UTCからの経過秒数を表す数値であり、PHPのdate()関数などと組み合わせることで、人間が読みやすい日付や時刻の形式に変換することができます。

もしファイルシステムの制約によりアクセス時刻が取得できなかった場合や、エラーが発生した場合には、このメソッドはfalseを返します。ファイルの活動状況の追跡や、特定の基準に基づくファイル管理を行う際に有用なメソッドです。

Copy
1<?php
2
3$directoryPath = __DIR__;
4
5// 指定されたディレクトリのイテレータを作成します
6$iterator = new FilesystemIterator($directoryPath);
7
8// ディレクトリ内の各ファイルまたはディレクトリを反復処理します
9foreach ($iterator as $fileInfo) {
10    // 現在のファイルまたはディレクトリの最終アクセス時刻をUnixタイムスタンプで取得します
11    $accessTime = $fileInfo->getATime();
12
13    // 例として、ファイル名と整形されたアクセス時刻を表示します
14    echo "ファイル名: " . $fileInfo->getFilename() . ", 最終アクセス時刻: " . date('Y-m-d H:i:s', $accessTime) . PHP_EOL;
15}

引数なし

引数はありません

int

このメソッドは、エントリの最終アクセス時刻をUnixタイムスタンプ形式の整数で返します。