Bitcoin Core 29.99.0
P2P Digital Currency
time.h
Go to the documentation of this file.
1// Copyright (c) 2009-2010 Satoshi Nakamoto
2// Copyright (c) 2009-present The Bitcoin Core developers
3// Distributed under the MIT software license, see the accompanying
4// file COPYING or http://www.opensource.org/licenses/mit-license.php.
5
6#ifndef BITCOIN_UTIL_TIME_H
7#define BITCOIN_UTIL_TIME_H
8
9#include <chrono> // IWYU pragma: export
10#include <cstdint>
11#include <optional>
12#include <string>
13#include <string_view>
14
15using namespace std::chrono_literals;
16
18struct NodeClock : public std::chrono::system_clock {
19 using time_point = std::chrono::time_point<NodeClock>;
21 static time_point now() noexcept;
22 static std::time_t to_time_t(const time_point&) = delete; // unused
23 static time_point from_time_t(std::time_t) = delete; // unused
24};
25using NodeSeconds = std::chrono::time_point<NodeClock, std::chrono::seconds>;
26
27using SteadyClock = std::chrono::steady_clock;
28using SteadySeconds = std::chrono::time_point<std::chrono::steady_clock, std::chrono::seconds>;
29using SteadyMilliseconds = std::chrono::time_point<std::chrono::steady_clock, std::chrono::milliseconds>;
30using SteadyMicroseconds = std::chrono::time_point<std::chrono::steady_clock, std::chrono::microseconds>;
31
32using SystemClock = std::chrono::system_clock;
33
38struct MockableSteadyClock : public std::chrono::steady_clock {
39 using time_point = std::chrono::time_point<MockableSteadyClock>;
40
41 using mock_time_point = std::chrono::time_point<MockableSteadyClock, std::chrono::milliseconds>;
42 static constexpr mock_time_point::duration INITIAL_MOCK_TIME{1};
43
45 static time_point now() noexcept;
46 static std::time_t to_time_t(const time_point&) = delete; // unused
47 static time_point from_time_t(std::time_t) = delete; // unused
48
54 static void SetMockTime(mock_time_point::duration mock_time_in);
55
57 static void ClearMockTime();
58};
59
60void UninterruptibleSleep(const std::chrono::microseconds& n);
61
72template <typename Dur1, typename Dur2>
73constexpr auto Ticks(Dur2 d)
74{
75 return std::chrono::duration_cast<Dur1>(d).count();
76}
77template <typename Duration, typename Timepoint>
78constexpr auto TicksSinceEpoch(Timepoint t)
79{
80 return Ticks<Duration>(t.time_since_epoch());
81}
82constexpr int64_t count_seconds(std::chrono::seconds t) { return t.count(); }
83constexpr int64_t count_milliseconds(std::chrono::milliseconds t) { return t.count(); }
84constexpr int64_t count_microseconds(std::chrono::microseconds t) { return t.count(); }
85
86using HoursDouble = std::chrono::duration<double, std::chrono::hours::period>;
87using SecondsDouble = std::chrono::duration<double, std::chrono::seconds::period>;
88using MillisecondsDouble = std::chrono::duration<double, std::chrono::milliseconds::period>;
89
98int64_t GetTime();
99
106void SetMockTime(int64_t nMockTimeIn);
107
109void SetMockTime(std::chrono::seconds mock_time_in);
110
112std::chrono::seconds GetMockTime();
113
118template <typename T>
120{
121 return std::chrono::time_point_cast<typename T::duration>(T::clock::now());
122}
124template <typename T>
126{
127 return Now<std::chrono::time_point<NodeClock, T>>().time_since_epoch();
128}
129
134std::string FormatISO8601DateTime(int64_t nTime);
135std::string FormatISO8601Date(int64_t nTime);
136std::optional<int64_t> ParseISO8601DateTime(std::string_view str);
137
141struct timeval MillisToTimeval(int64_t nTimeout);
142
146struct timeval MillisToTimeval(std::chrono::milliseconds ms);
147
148#endif // BITCOIN_UTIL_TIME_H
Version of SteadyClock that is mockable in the context of tests (set the current value with SetMockTi...
Definition: time.h:38
std::chrono::time_point< MockableSteadyClock, std::chrono::milliseconds > mock_time_point
Definition: time.h:41
std::chrono::time_point< MockableSteadyClock > time_point
Definition: time.h:39
Mockable clock in the context of tests, otherwise the system clock.
Definition: time.h:18
static time_point now() noexcept
Return current system time or mocked time, if set.
Definition: time.cpp:26
std::chrono::time_point< NodeClock > time_point
Definition: time.h:19
static std::time_t to_time_t(const time_point &)=delete
static time_point from_time_t(std::time_t)=delete
constexpr int64_t count_milliseconds(std::chrono::milliseconds t)
Definition: time.h:83
struct timeval MillisToTimeval(int64_t nTimeout)
Convert milliseconds to a struct timeval for e.g.
Definition: time.cpp:119
std::chrono::duration< double, std::chrono::seconds::period > SecondsDouble
Definition: time.h:87
std::chrono::duration< double, std::chrono::hours::period > HoursDouble
Definition: time.h:86
std::chrono::steady_clock SteadyClock
Definition: time.h:27
std::chrono::duration< double, std::chrono::milliseconds::period > MillisecondsDouble
Definition: time.h:88
void UninterruptibleSleep(const std::chrono::microseconds &n)
Definition: time.cpp:20
std::chrono::seconds GetMockTime()
For testing.
Definition: time.cpp:47
int64_t GetTime()
DEPRECATED Use either ClockType::now() or Now<TimePointType>() if a cast is needed.
Definition: time.cpp:76
constexpr auto TicksSinceEpoch(Timepoint t)
Definition: time.h:78
std::string FormatISO8601Date(int64_t nTime)
Definition: time.cpp:87
void SetMockTime(int64_t nMockTimeIn)
DEPRECATED Use SetMockTime with chrono type.
Definition: time.cpp:40
T Now()
Return the current time point cast to the given precision.
Definition: time.h:119
std::chrono::system_clock SystemClock
Definition: time.h:32
constexpr int64_t count_microseconds(std::chrono::microseconds t)
Definition: time.h:84
constexpr int64_t count_seconds(std::chrono::seconds t)
Definition: time.h:82
std::chrono::time_point< std::chrono::steady_clock, std::chrono::microseconds > SteadyMicroseconds
Definition: time.h:30
std::chrono::time_point< NodeClock, std::chrono::seconds > NodeSeconds
Definition: time.h:25
std::optional< int64_t > ParseISO8601DateTime(std::string_view str)
Definition: time.cpp:95
std::chrono::time_point< std::chrono::steady_clock, std::chrono::seconds > SteadySeconds
Definition: time.h:28
constexpr auto Ticks(Dur2 d)
Helper to count the seconds of a duration/time_point.
Definition: time.h:73
std::string FormatISO8601DateTime(int64_t nTime)
ISO 8601 formatting is preferred.
Definition: time.cpp:78
std::chrono::time_point< std::chrono::steady_clock, std::chrono::milliseconds > SteadyMilliseconds
Definition: time.h:29