cpp / latest / filesystem / file_time_type.html /

std::filesystem::file_time_type

Defined in header <filesystem>
using file_time_type = std::chrono::time_point</*trivial-clock*/>;
(since C++17)
(until C++20)
using file_time_type = std::chrono::time_point<std::chrono::file_clock>;
(since C++20)

Represents file time.

trivial-clock is an implementation-defined type that satisfies TrivialClock and is sufficient to represent the resolution and range of the file time values offered by the filesystem.

(until C++20)

Example

#include <iostream>
#include <chrono>
#include <iomanip>
#include <fstream>
#include <filesystem>
 
using namespace std::chrono_literals;
int main()
{
    auto p = std::filesystem::temp_directory_path() / "example.bin";
    std::ofstream(p.c_str()).put('a'); // create file
 
    auto print_last_write_time = [](std::filesystem::file_time_type const& ftime) {
        std::time_t cftime = std::chrono::system_clock::to_time_t(
            std::chrono::file_clock::to_sys(ftime));
        std::cout << "File write time is " << std::asctime(std::localtime(&cftime));
    };
 
    auto ftime = std::filesystem::last_write_time(p);
    print_last_write_time(ftime);
 
    std::filesystem::last_write_time(p, ftime + 1h); // move file write time 1 hour to the future
    ftime = std::filesystem::last_write_time(p); // read back from the filesystem
    print_last_write_time(ftime);
 
    std::filesystem::remove(p);
}

Possible output:

File write time is Sun May  9 23:29:58 2021
File write time is Mon May 10 00:29:58 2021

See also

(C++17)
gets or sets the time of the last data modification
(function)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/filesystem/file_time_type