ORE Studio 0.0.4
Loading...
Searching...
No Matches
time_utils.hpp
1/* -*- mode: c++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*-
2 *
3 * Copyright (C) 2025 Marco Craveiro <marco.craveiro@gmail.com>
4 *
5 * This program is free software; you can redistribute it and/or modify it under
6 * the terms of the GNU General Public License as published by the Free Software
7 * Foundation; either version 3 of the License, or (at your option) any later
8 * version.
9 *
10 * This program is distributed in the hope that it will be useful, but WITHOUT
11 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
12 * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
13 * details.
14 *
15 * You should have received a copy of the GNU General Public License along with
16 * this program; if not, write to the Free Software Foundation, Inc., 51
17 * Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
18 *
19 */
20#ifndef ORES_PLATFORM_TIME_TIME_UTILS_HPP
21#define ORES_PLATFORM_TIME_TIME_UTILS_HPP
22
23#include <ctime>
24#include <chrono>
25#include <filesystem>
26#include <string>
27#include <string_view>
28
29namespace ores::platform::time {
30
34class time_utils final {
35public:
46 static std::tm* gmtime_safe(const std::time_t* time, std::tm* result);
47
58 static std::tm* localtime_safe(const std::time_t* time, std::tm* result);
59
70 static std::time_t timegm_safe(std::tm* tm);
71
83 static std::chrono::system_clock::time_point
84 to_time_point_utc(std::tm tm);
85
99 static std::chrono::system_clock::time_point
100 to_time_point_local(std::tm tm);
101
113 static std::chrono::year_month_day parse_date(std::string_view s);
114
124 static std::string format_date_compact(std::chrono::year_month_day date);
125
135 static std::string format_date_iso(std::chrono::year_month_day date);
136
148 static std::chrono::system_clock::time_point
149 file_time_to_system_clock(std::filesystem::file_time_type ft);
150};
151
152}
153
154#endif
Time and datetime utilities.
Definition datetime.hpp:26
Cross-platform time utilities.
Definition time_utils.hpp:34
static std::chrono::system_clock::time_point to_time_point_local(std::tm tm)
Converts a local-time tm struct directly to a system_clock::time_point.
Definition time_utils.cpp:68
static std::string format_date_compact(std::chrono::year_month_day date)
Formats a calendar date as YYYYMMDD (e.g. "20160205").
Definition time_utils.cpp:106
static std::tm * gmtime_safe(const std::time_t *time, std::tm *result)
Converts time_t to UTC tm struct (cross-platform).
Definition time_utils.cpp:30
static std::tm * localtime_safe(const std::time_t *time, std::tm *result)
Converts time_t to local tm struct (cross-platform).
Definition time_utils.cpp:43
static std::chrono::system_clock::time_point file_time_to_system_clock(std::filesystem::file_time_type ft)
Converts a filesystem file_time_type to a system_clock::time_point.
Definition time_utils.cpp:121
static std::string format_date_iso(std::chrono::year_month_day date)
Formats a calendar date as YYYY-MM-DD (ISO 8601, e.g. "2016-02-05").
Definition time_utils.cpp:113
static std::chrono::year_month_day parse_date(std::string_view s)
Parses a calendar date string in YYYYMMDD or YYYY-MM-DD format.
Definition time_utils.cpp:73
static std::chrono::system_clock::time_point to_time_point_utc(std::tm tm)
Converts a UTC tm struct directly to a system_clock::time_point.
Definition time_utils.cpp:64
static std::time_t timegm_safe(std::tm *tm)
Converts a UTC tm struct to time_t (cross-platform).
Definition time_utils.cpp:56