Open In App

Node.js stats.birthtime Property

Improve
Improve
Like Article
Like
Save
Share
Report

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:




// 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:




// 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



Last Updated : 08 Oct, 2021
Like Article
Save Article
Previous
Next
Share your thoughts in the comments
Similar Reads