Time Shield Library 2.0.0
C++ library for working with time
Loading...
Searching...
No Matches
ole_automation_conversions.hpp
Go to the documentation of this file.
1// SPDX-License-Identifier: MIT
2#pragma once
3#ifndef TIME_SHIELD_HEADER_CONVERSIONS_OLE_AUTOMATION_CONVERSIONS_HPP_INCLUDED
4#define TIME_SHIELD_HEADER_CONVERSIONS_OLE_AUTOMATION_CONVERSIONS_HPP_INCLUDED
5
20
21#include <time_shield/core.hpp>
23
24#include <cstdint>
25#include <limits>
26
27namespace time_shield {
28
29 namespace detail {
30
31 TIME_SHIELD_CONSTEXPR inline bool oadate_can_cast_to_i64(oadate_t value) noexcept {
32 return value >= static_cast<oadate_t>((std::numeric_limits<int64_t>::min)())
33 && value <= static_cast<oadate_t>((std::numeric_limits<int64_t>::max)());
34 }
35
36 TIME_SHIELD_CONSTEXPR inline oadate_t oadate_abs(oadate_t value) noexcept {
37 return value < 0 ? -value : value;
38 }
39
40 TIME_SHIELD_CONSTEXPR inline oadate_t oadate_trunc_toward_zero(oadate_t value) noexcept {
41 if (!oadate_can_cast_to_i64(value)) {
42 return value;
43 }
44 return static_cast<oadate_t>(static_cast<int64_t>(value));
45 }
46
47 TIME_SHIELD_CONSTEXPR inline oadate_t oadate_floor_value(oadate_t value) noexcept {
48 const oadate_t truncated = oadate_trunc_toward_zero(value);
49 if (truncated == value) {
50 return truncated;
51 }
52 if (value < 0) {
53 return truncated - static_cast<oadate_t>(1.0);
54 }
55 return truncated;
56 }
57
58 TIME_SHIELD_CONSTEXPR inline bool oadate_has_fraction(oadate_t value) noexcept {
59 if (!oadate_can_cast_to_i64(value)) {
60 return false;
61 }
62 return oadate_trunc_toward_zero(value) != value;
63 }
64
65 TIME_SHIELD_CONSTEXPR inline oadate_t linear_days_to_oadate(oadate_t linear_days) noexcept {
66 if (linear_days < 0 && oadate_has_fraction(linear_days)) {
67 const oadate_t whole_days = oadate_floor_value(linear_days);
68 const oadate_t fraction = linear_days - whole_days;
69 return whole_days - fraction;
70 }
71 return linear_days;
72 }
73
74 TIME_SHIELD_CONSTEXPR inline oadate_t oadate_to_linear_days(oadate_t oa) noexcept {
75 if (oa < 0 && oadate_has_fraction(oa)) {
76 const oadate_t whole_days = oadate_trunc_toward_zero(oa);
77 const oadate_t fraction = oadate_abs(oa - whole_days);
78 return whole_days + fraction;
79 }
80 return oa;
81 }
82
83 } // namespace detail
84
88 TIME_SHIELD_CONSTEXPR inline oadate_t ts_to_oadate(ts_t ts) noexcept {
89 const oadate_t linear_days = static_cast<oadate_t>(OLE_EPOCH)
90 + static_cast<oadate_t>(ts) / static_cast<oadate_t>(SEC_PER_DAY);
91 return detail::linear_days_to_oadate(linear_days);
92 }
93
97 TIME_SHIELD_CONSTEXPR inline oadate_t fts_to_oadate(fts_t ts) noexcept {
98 const oadate_t linear_days = static_cast<oadate_t>(OLE_EPOCH)
99 + static_cast<oadate_t>(ts) / static_cast<oadate_t>(SEC_PER_DAY);
100 return detail::linear_days_to_oadate(linear_days);
101 }
102
106 TIME_SHIELD_CONSTEXPR inline oadate_t ts_ms_to_oadate(ts_ms_t ts_ms) noexcept {
107 const oadate_t linear_days = static_cast<oadate_t>(OLE_EPOCH)
108 + static_cast<oadate_t>(ts_ms) / static_cast<oadate_t>(MS_PER_DAY);
109 return detail::linear_days_to_oadate(linear_days);
110 }
111
115 TIME_SHIELD_CONSTEXPR inline ts_t oadate_to_ts(oadate_t oa) noexcept {
116 const oadate_t linear_days = detail::oadate_to_linear_days(oa);
117 const oadate_t seconds = (linear_days - static_cast<oadate_t>(OLE_EPOCH))
118 * static_cast<oadate_t>(SEC_PER_DAY);
119 return static_cast<ts_t>(seconds);
120 }
121
125 TIME_SHIELD_CONSTEXPR inline fts_t oadate_to_fts(oadate_t oa) noexcept {
126 const oadate_t linear_days = detail::oadate_to_linear_days(oa);
127 return static_cast<fts_t>((linear_days - static_cast<oadate_t>(OLE_EPOCH))
128 * static_cast<oadate_t>(SEC_PER_DAY));
129 }
130
134 TIME_SHIELD_CONSTEXPR inline ts_ms_t oadate_to_ts_ms(oadate_t oa) noexcept {
135 const oadate_t linear_days = detail::oadate_to_linear_days(oa);
136 const oadate_t ms = (linear_days - static_cast<oadate_t>(OLE_EPOCH))
137 * static_cast<oadate_t>(MS_PER_DAY);
138 return static_cast<ts_ms_t>(ms);
139 }
140
146 template<class T1, class T2, class T3>
147 TIME_SHIELD_CONSTEXPR inline oadate_t to_oadate(
148 T1 year, T2 month, T2 day,
149 T2 hour = 0, T2 min = 0, T2 sec = 0, T3 ms = 0) noexcept {
150 // Use existing conversion to floating timestamp (seconds).
151 const fts_t fts = to_ftimestamp(year, month, day, hour, min, sec, ms);
152 return fts_to_oadate(fts);
153 }
154
155} // namespace time_shield
156
157#endif // TIME_SHIELD_HEADER_CONVERSIONS_OLE_AUTOMATION_CONVERSIONS_HPP_INCLUDED
Conversions involving DateTimeStruct and day boundary helpers.
constexpr int64_t OLE_EPOCH
OLE automation date since UNIX epoch.
constexpr int64_t MS_PER_DAY
Milliseconds per day.
Definition constants.hpp:97
constexpr int64_t SEC_PER_DAY
Seconds per day.
TIME_SHIELD_CONSTEXPR T year(ts_t ts=time_shield::ts())
Alias for year_of function.
TIME_SHIELD_CONSTEXPR fts_t to_ftimestamp(T1 year, T2 month, T2 day, T2 hour=0, T2 min=0, T2 sec=0, T3 ms=0)
Converts a date and time to a floating-point timestamp.
int64_t ts_t
Unix timestamp in seconds since 1970‑01‑01T00:00:00Z.
Definition types.hpp:48
int64_t ts_ms_t
Unix timestamp in milliseconds since epoch.
Definition types.hpp:49
double fts_t
Floating-point timestamp (fractional seconds since epoch).
Definition types.hpp:51
double oadate_t
OLE Automation date (days since 1899‑12‑30, as double).
Definition types.hpp:54
ts_t ts() noexcept
Get the current UTC timestamp in seconds.
ts_ms_t ts_ms() noexcept
Get the current UTC timestamp in milliseconds.
fts_t fts() noexcept
Get the current UTC timestamp in floating-point seconds.
TIME_SHIELD_CONSTEXPR oadate_t oadate_to_linear_days(oadate_t oa) noexcept
TIME_SHIELD_CONSTEXPR oadate_t linear_days_to_oadate(oadate_t linear_days) noexcept
TIME_SHIELD_CONSTEXPR oadate_t oadate_trunc_toward_zero(oadate_t value) noexcept
TIME_SHIELD_CONSTEXPR oadate_t oadate_floor_value(oadate_t value) noexcept
TIME_SHIELD_CONSTEXPR oadate_t oadate_abs(oadate_t value) noexcept
TIME_SHIELD_CONSTEXPR bool oadate_can_cast_to_i64(oadate_t value) noexcept
TIME_SHIELD_CONSTEXPR bool oadate_has_fraction(oadate_t value) noexcept
Main namespace for the Time Shield library.
TIME_SHIELD_CONSTEXPR oadate_t ts_ms_to_oadate(ts_ms_t ts_ms) noexcept
Convert Unix timestamp (milliseconds) to OA date.
TIME_SHIELD_CONSTEXPR oadate_t ts_to_oadate(ts_t ts) noexcept
Convert Unix timestamp (seconds) to OA date.
TIME_SHIELD_CONSTEXPR ts_t oadate_to_ts(oadate_t oa) noexcept
Convert OA date to Unix timestamp (seconds).
TIME_SHIELD_CONSTEXPR oadate_t to_oadate(T1 year, T2 month, T2 day, T2 hour=0, T2 min=0, T2 sec=0, T3 ms=0) noexcept
Build OA date from calendar components (Gregorian).
TIME_SHIELD_CONSTEXPR fts_t oadate_to_fts(oadate_t oa) noexcept
Convert OA date to Unix timestamp (floating seconds).
TIME_SHIELD_CONSTEXPR ts_ms_t oadate_to_ts_ms(oadate_t oa) noexcept
Convert OA date to Unix timestamp (milliseconds).
TIME_SHIELD_CONSTEXPR oadate_t fts_to_oadate(fts_t ts) noexcept
Convert Unix timestamp (floating seconds) to OA date.