【Node.js24.x】Object::futimes()メソッドの使い方

futimesメソッドは、開いているファイルのアクセス時刻と更新時刻を変更するために使用されるメソッドです。このメソッドは、ファイルディスクリプタによって識別される特定のファイルに対し、その最終アクセス時刻（atime）と最終更新時刻（mtime）を任意の値に設定する機能を提供します。

Node.jsにおいては通常、fsモジュールを介して非同期的に提供され、ファイルシステムのタイムスタンプを操作する際に利用されます。atimeはファイルが最後に読み取られた時刻を、mtimeはファイルの内容が最後に書き換えられた時刻を表します。これらの時刻は、UNIXエポックからのミリ秒数、またはJavaScriptのDateオブジェクトとして指定することが可能です。

主に、バックアップシステムやファイル同期ツールなど、ファイルのメタデータを厳密に管理する必要があるアプリケーションで、ファイルのタイムスタンプを特定の状態に復元したり、整合性を維持したりするために活用されます。fs.open()などの操作で取得したファイルディスクリプタを用いることで、開かれたファイルに対してこの操作を実行できます。メソッドの実行結果は、コールバック関数を通じて通知されるか、Promiseとして解決され、エラー発生時には適切な情報が提供されます。この機能により、開発者はファイルシステムのタイムスタンプをプログラムから柔軟かつ正確に制御することが可能になります。

Copy
1import { futimes } from 'node:fs/promises';
2
3const fileDescriptor = 3;
4const accessTime = new Date();
5const modificationTime = Date.now() / 1000;
6
7await futimes(fileDescriptor, accessTime, modificationTime);

fd, atime, mtime, callback

• fd: number: ファイルディスクリプタ。操作対象のファイルを表す番号。
• atime: number | Date: アクセス時刻。ファイルの最終アクセス時刻。
• mtime: number | Date: 更新時刻。ファイルの最終更新時刻。
• callback: Function: 処理完了後に実行されるコールバック関数。エラー情報が第一引数として渡されます。

戻り値なし

戻り値はありません