Node.js stats.birthtime Property

The stats.birthtime property is an inbuilt application programming interface of the fs.Stats class is used to get the timestamp when the file is created. Syntax:

stats.birthtime

Return Value: It returns a Date that represents the timestamp when the file has been created. Below examples illustrate the use of stats.birthtime property in Node.js: Example 1:

javascript

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

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

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

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

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

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

Output:

Using stat: Wed May 13 2020 18:38:31 GMT+0530 (India Standard Time)
Using lstat: Sun Jun 21 2020 01:22:55 GMT+0530 (India Standard Time)

Example 2:

javascript

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

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

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

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

Output:

Using stat synchronous: Sun Jun 21 2020 01:22:55 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_birthtime

Node.js stats.birthtime Property

Explore