time_utils.h

Go to the documentation of this file.

// BSD 3-Clause License
// Copyright (c) 2025, 🍀☀🌕🌥 🌊
// See the LICENSE file in the project root for full license information.
 
#pragma once
 
#include <chrono>
#include <string>
#include <sstream>
#include <iomanip>
#include <ctime>
 
namespace kcenon::logger::utils {
 
class time_utils {
public:
    static std::string format_timestamp(
        const std::chrono::system_clock::time_point& tp
    ) {
        auto time_t = std::chrono::system_clock::to_time_t(tp);
        std::tm tm_buf{};
 
#ifdef _WIN32
        localtime_s(&tm_buf, &time_t);  // Windows thread-safe version
#else
        localtime_r(&time_t, &tm_buf);  // POSIX thread-safe version
#endif
 
        // Format base timestamp
        char buffer[32];
        std::strftime(buffer, sizeof(buffer), "%Y-%m-%d %H:%M:%S", &tm_buf);
 
        // Add milliseconds
        auto ms = std::chrono::duration_cast<std::chrono::milliseconds>(
            tp.time_since_epoch()
        ) % 1000;
 
        std::ostringstream oss;
        oss << buffer << "."
            << std::setfill('0') << std::setw(3) << ms.count();
 
        return oss.str();
    }
 
    static std::string format_iso8601(
        const std::chrono::system_clock::time_point& tp
    ) {
        auto time_t = std::chrono::system_clock::to_time_t(tp);
        std::tm tm_buf{};
 
#ifdef _WIN32
        gmtime_s(&tm_buf, &time_t);  // Windows thread-safe version (UTC)
#else
        gmtime_r(&time_t, &tm_buf);  // POSIX thread-safe version (UTC)
#endif
 
        // Format base timestamp (ISO 8601)
        char buffer[32];
        std::strftime(buffer, sizeof(buffer), "%Y-%m-%dT%H:%M:%S", &tm_buf);
 
        // Add milliseconds
        auto ms = std::chrono::duration_cast<std::chrono::milliseconds>(
            tp.time_since_epoch()
        ) % 1000;
 
        std::ostringstream oss;
        oss << buffer << "."
            << std::setfill('0') << std::setw(3) << ms.count()
            << "Z";  // UTC timezone indicator
 
        return oss.str();
    }
 
    static std::string format_compact(
        const std::chrono::system_clock::time_point& tp
    ) {
        auto time_t = std::chrono::system_clock::to_time_t(tp);
        std::tm tm_buf{};
 
#ifdef _WIN32
        localtime_s(&tm_buf, &time_t);
#else
        localtime_r(&time_t, &tm_buf);
#endif
 
        // Format compact timestamp
        char buffer[32];
        std::strftime(buffer, sizeof(buffer), "%Y%m%d%H%M%S", &tm_buf);
 
        // Add milliseconds
        auto ms = std::chrono::duration_cast<std::chrono::milliseconds>(
            tp.time_since_epoch()
        ) % 1000;
 
        std::ostringstream oss;
        oss << buffer
            << std::setfill('0') << std::setw(3) << ms.count();
 
        return oss.str();
    }
 
    static std::string format_for_rotation(
        const std::chrono::system_clock::time_point& tp,
        bool include_hour = false
    ) {
        auto time_t = std::chrono::system_clock::to_time_t(tp);
        std::tm tm_buf{};
 
#ifdef _WIN32
        localtime_s(&tm_buf, &time_t);
#else
        localtime_r(&time_t, &tm_buf);
#endif
 
        char buffer[32];
        if (include_hour) {
            std::strftime(buffer, sizeof(buffer), "%Y%m%d_%H", &tm_buf);
        } else {
            std::strftime(buffer, sizeof(buffer), "%Y%m%d", &tm_buf);
        }
 
        return std::string(buffer);
    }
 
    static std::chrono::system_clock::time_point now() {
        return std::chrono::system_clock::now();
    }
};
 
} // namespace kcenon::logger::utils