Node.js stats.mtime Property

The stats.mtime property is an inbuilt application programming interface of the fs.Stats class is used to get the timestamp when the file is modified last time.

Syntax:

stats.mtime;

Parameters: Properties does not have any parameter.

Return Value: It returns a Date which represents the timestamp when the file is modified last time.

Below examples illustrate the use of stats.mtime property in Node.js:

Example 1:

// Node.js program to demonstrate the
// stats.mtime Property

// Accessing fs module
const fs = require('fs');

// Calling fs.Stats stats.mtime
// using stat
fs.stat('./', (err, stats) => {
    if (err) throw err;

    // The timestamp when the file
    // is last modified
    console.log("Using stat: " + stats.mtime);
});

//using lstat
fs.lstat('./filename.txt', (err, stats) => {
    if (err) throw err;

    // The timestamp when the file
    // is last modified
    console.log("Using lstat: " + stats.mtime);
});

Output:

Using stat: Sun Jun 21 2020 01:08:08 GMT+0530 (India Standard Time)
Using lstat: Sun Jun 21 2020 01:10:16 GMT+0530 (India Standard Time)

Example 2:

// Node.js program to demonstrate the
// stats.mtime Property

// Accessing fs module
const fs = require('fs').promises;

// Calling fs.Stats stats.mtime
(async () => {
    const stats = await fs.stat('./filename.txt');

    // The timestamp when the file
    // is last modified
    console.log("Using stat synchronous: "
                + stats.mtime);
})().catch(console.error)

Output:

Using stat synchronous: Sun Jun 21 2020 01:10:16 GMT+0530
                                    (India Standard Time)

Note: The above program will compile and run by using the node filename.js command and use the file_path correctly.

Reference: https://nodejs.org/api/fs.html#fs_stats_mtime