Node.js fs.filehandle.utimes() Method
Last Updated :
28 Dec, 2022
The fs.filehandle.utimes() method is an inbuilt application programming interface of class fs.filehandle within File System module which is used to change the time stamp of this file system.
Syntax:
const filehandle.utimes(atime, mtime)
Parameter: This method accepts two parameters as mentioned above and described below:
- atime: Access timestamp is the last time the file was read.
- mtime: Modified timestamp signifies the last time the contents of a file were modified.
Return Value: This method returns an pending promise which contains no value in it.
Below programs illustrates the use of fs.filehandle.utimes() method in Node.js:
Example 1: Filename: index.js
JavaScript
// Node.js program to demonstrate the
// filehandle.utimes() method
const fs = require('fs');
const fsPromises = fs.promises;
console.log("content of the file before operation :- "
+ fs.readFileSync('example.txt', 'utf8'));
// File cTime before operation
fs.stat('example.txt', (err, stats) => {
if (err) throw err;
console.log("CTime of the file before operation: "
+ stats.ctime);
});
// Initiating asynchronise function
async function funct() {
// Initializing following variables
let filehandle = null;
let prom = null;
try {
// Creating and initiating filehandle
filehandle = await
fsPromises.open('example.txt', 'r+');
// Changing the timestamp of the file
// by using utimes() method
prom = filehandle.utimes(0, 10);
} finally {
if (filehandle) {
// File cTime after operation
(filehandle.stat(true))
.then(function (result) {
console.log("CTime of the file "
+ "after operation :- "
+ result.ctime);
})
console.log("content of the file "
+ "after operation : " +
fs.readFileSync('example.txt', 'utf8'));
// Close the file if it is opened.
await filehandle.close();
}
}
}
funct().catch(console.error);
Directory structure before running the program:

Directory structure after running the program:

Run index.js file using the following command:
node index.js
Output:
content of the file before operation : Content of example.txt file
CTime of the file before operation: Tue Jul 07 2020 09:21:11 GMT+0530 (India Standard Time)
content of the file after operation : Content of example.txt file
CTime of the file after operation :- Tue Jul 07 2020 09:53:15 GMT+0530 (India Standard Time)
Example 2: Filename: index.js
JavaScript
// Node.js program to demonstrate the
// filehandle.utimes() method
const fs = require('fs');
const fsPromises = fs.promises;
// Data for the new file
let data = "This is a file containing"
+ " a collection of books.";
// Name of the file to be created
let file = "books.txt";
// Creating the new file 'books.txt'
fs.writeFile(file, data, (err) => {
// Catching error
if (err) {
console.log(err);
}
});
// Using fs.exists() method
fs.exists(file, (exists) => {
if (exists) {
console.log(
"content of file before operation: "
+ (fs.readFileSync(file)));
}
});
// File cTime before operation
fs.stat(file, (err, stats) => {
if (err) throw err;
console.log(
"CTime of the file before operation: "
+ stats.ctime);
});
// Initiating asynchronise function
async function funct() {
// Initializing filehandle
let filehandle = null;
try {
// Creating and initiating filehandle
filehandle = await
fsPromises.open(file, 'r+');
// Changing the timestamp of the file
// by using utimes() method
prom = filehandle.utimes(0, 20);
} finally {
if (filehandle) {
// Close the file if it is opened.
// file cTime after operation
(filehandle.stat(true))
.then(function (result) {
console.log("CTime of the file "
+ "after operation :- "
+ result.ctime);
})
console.log("content of file after"
+ " operation: " +
(fs.readFileSync(file)));
await filehandle.close();
}
}
}
funct().catch(console.error);
Directory structure before running the program:

Directory structure after running the program:

Run index.js file using the following command:
node index.js
Output:
content of file before operation: This is a file containing a collection of books.
CTime of the file before operation: Tue Jul 07 2020 09:56:52 GMT+0530 (India Standard Time)
content of file after operation: This is a file containing a collection of books.
CTime of the file after operation: Tue Jul 07 2020 09:57:09 GMT+0530 (India Standard Time)
Reference: https://nodejs.org/dist/latest-v12.x/docs/api/fs.html#fs_filehandle_utimes_atime_mtime
Similar Reads
Node JS fs.readFile() Method âIn Node.js, the fs.readFile() method is a fundamental tool for reading files asynchronously, allowing your application to remain responsive while accessing file data. This method is part of Node.js's File System (fs) module, which provides an API for interacting with the file system.Syntaxfs.readFi
3 min read
Node.js fs.exists() Method The fs exists method in node is used to check if the input file or the directory exists or not. It is an inbuilt application programming interface of fs module which provides an API for interacting with the file system in a manner closely modeled around POSIX functions. Syntax:fs.exists( path, callb
2 min read
Node fs.existsSync() Method In Node.js, the fs.existsSync() method checks if a file or folder exists at a given path. It's synchronous, meaning it pauses the program until it finds the result (either true if it exists, or false if it doesn't). Because it stops everything while it works, itâs best used for quick checks in small
3 min read
Node fs.mkdir() Method The fs.mkdir() method in Node.js is used to create a directory asynchronously.Syntaxfs.mkdir(path, mode, callback)Parameters: This method accepts three parameters as mentioned above and described below: path: This parameter holds the path of the directory that has to be created.mode: This parameter
2 min read
Node.js fs.truncate() Method The fs.truncate() method in node.js is used to change the size of the file i.e either increase or decrease the file size. This method changes the length of the file at the path by len bytes. If len represents a length shorter than the file's current length, the file is truncated to that length. If i
2 min read
Node.js fs.renameSync() Method In Node.js, the fs.renameSync() method is part of the built-in File System (fs) module and is used to rename or move files and directories synchronously. This method is useful when you need to quickly change a file's name or move it to a different directory synchronously. It blocks the execution of
3 min read
Node.js fs.rmdir() Method The fs.rmdir() method is used to delete a directory at the given path. It can also be used recursively to remove nested directories.Syntax: fs.rmdir( path, options, callback )Parameters: This method accepts three parameters as mentioned above and described below: path: It holds the path of the direc
3 min read
Node.js fs.stat() Method The fs.stat() method is used to return information about the given file or directory. It returns an fs.Stat object which has several properties and methods to get details about the file or directory. Syntax:fs.stat( path, options, callback )Parameters: This method accept three parameters as mentione
3 min read
Node.js fs.mkdtempSync() Method The fs.mkdtempSync() method is an inbuilt application programming interface of fs module which provides an API for interacting with the file system in a manner closely modeled around standard POSIX functions. The fs.mkdtempSync() method creates a unique temporary directory. This is the synchronous v
2 min read
Node.js fs.realpath() Method The fs.realPath() method is used to compute the canonical pathname of the given path. It does so by resolving the ., .. and the symbolic links in the path. Syntax: fs.realpath( path, options, callback ) Parameters: This method accept three parameters as mentioned above and described below: path: It
3 min read