Node.js stats.ctimeMs Property from fs.Stats Class

The stats.ctimeMs property is an inbuilt application programming interface of the fs.Stats class that is used to get the timestamp when the file status has been changed last time since the POSIX epoch expressed in milliseconds.

Syntax:

stats.ctimeMs;

Return Value: It returns a number or BigInt value that represents the timestamp when the file status has been changed last time since the POSIX epoch expressed in milliseconds.

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

Example 1:

// Node.js program to demonstrate the
// stats.ctimeMs property

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

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

    // The timestamp when the file status
    // has been changed last time (in MS)
    console.log("using stat: " + stats.ctimeMs);
});

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

    // The timestamp when the file status
    // has been changed last time (in MS)
    console.log("using lstat: " + stats.ctimeMs);
});

Output:

using stat: 1592665604516.1057
using lstat: 1592665807796.265

Example 2:

// Node.js program to demonstrate the
// stats.ctimeMs property

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

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

    // The timestamp when the file status
    // has been changed last time (in MS)
    console.log("using stat synchronous: "
            + stats.ctimeMs);
})().catch(console.error)

Output:

using stat synchronous: 1592665807796.265

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_ctimems