【Node.js24.x】Object::utimes()メソッドの使い方
utimesメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
utimesメソッドは、ファイルシステム上のファイルやディレクトリのアクセス時刻（atime）と変更時刻（mtime）を更新する機能を提供するメソッドです。これらのタイムスタンプは、ファイルがいつ読み込まれたり実行されたりしたかを示すアクセス時刻と、ファイルの内容がいつ最後に書き換えられたかを示す変更時刻という形で、ファイルの重要なメタデータとして管理されています。utimesメソッドを使用すると、プログラムからこれらの時刻を任意の日時に設定し直すことができます。
例えば、バックアップシステムにおいて元のファイルのタイムスタンプを復元したい場合や、特定のファイルをあたかも過去に作成されたかのように見せかけたい場合など、ファイルのタイムスタンプを意図的に操作する必要がある場面で活用されます。このメソッドは、引数として対象となるファイルまたはディレクトリのパス、そして設定したい新しいアクセス時刻と変更時刻の2つのタイムスタンプを受け取ります。Node.jsでは、ファイルシステム操作を提供するfsモジュールの一部として利用され、非同期および同期バージョンの両方が提供されているため、アプリケーションの要件に応じて適切な方法を選択できます。ファイルの整合性やタイムスタンプに基づいた処理を行うシステム開発において、このメソッドはファイルのメタデータ管理に不可欠な役割を果たします。
構文(syntax)
1import { utimes } from 'node:fs/promises'; 2 3await utimes('ファイルパス.txt', new Date(), new Date());
引数(parameters)
path, atime, mtime, callback
- path: string | URL | Buffer | Integer: アクセス時刻と変更時刻を変更するファイルまたはディレクトリのパス
- atime: string | Date | number: ファイルまたはディレクトリの新しいアクセス時刻
- mtime: string | Date | number: ファイルまたはディレクトリの新しい変更時刻
- callback: (err: NodeJS.ErrnoException | null) => void: 処理が完了したときに呼び出されるコールバック関数
戻り値(return)
戻り値なし
戻り値はありません