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

The stats.birthtimeMs property is an inbuilt application programming interface of the fs.Stats class is used to get the timestamp when the file is created since the POSIX epoch expressed in milliseconds.

Syntax:

stats.birthtimeMs;

Return Value: It returns a number or BigInt value that represents the timestamp when the file is created since the POSIX epoch expressed in milliseconds.

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

Example 1:

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

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

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

    // The timestamp when the file
    // is created (in MS)
    console.log("using stat: "
            + stats.birthtimeMs);
});

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

    // The timestamp when the file
    // is created (in MS)
    console.log("using lstat: "
            + stats.birthtimeMs);
});

Output:

using stat: 1589375311991.9453
using lstat: 1592667100334.387

Example 2:

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

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

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

    // The timestamp when the file
    // is created (in MS)
    console.log("using stat synchronous: "
            + stats.birthtimeMs);
})().catch(console.error)

Output:

using stat synchronous: 1592667100334.387

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_birthtimems