std::chrono::year_month_day:: operator sys_days, std::chrono::year_month_day:: operator local_days
From cppreference.net
<
cpp
|
chrono
|
year month day
|
constexpr
operator
std::
chrono
::
sys_days
(
)
const
noexcept
;
|
(1) | (C++20以降) |
|
constexpr
explicit
operator
std::
chrono
::
local_days
(
)
const
noexcept
;
|
(2) | (C++20以降) |
*
this
を、この
year_month_day
と同じ日付を表す
std::chrono::time_point
に変換します。
1)
ok()
が
true
の場合、戻り値は
std::chrono::system_clock
エポック(1970-01-01)から
*
this
までの日数を保持する。
*
this
がエポックより前の日付を表す場合、結果は負の値となる。
そうでなければ、格納されている年と月が有効な場合(
year
(
)
.
ok
(
)
&&
month
(
)
.
ok
(
)
が
true
の場合)、返される値は
sys_days
(
year
(
)
/
month
(
)
/
1d
)
+
(
day
(
)
-
1d
)
です。
それ以外の場合(
year
(
)
.
ok
(
)
&&
month
(
)
.
ok
(
)
が
false
の場合)、戻り値は未規定です。
A
std::chrono::sys_days
が範囲
[
std::
chrono
::
days
{
-
12687428
}
,
std::
chrono
::
days
{
11248737
}
]
内にある場合、
year_month_day
に変換して戻しても同じ値が得られる。
2)
(1)
と同じですが、
local_days
を返します。以下と同等です:
return
local_days
(
sys_days
(
*
this
)
.
time_since_epoch
(
)
)
;
。
注記
std::chrono::sys_days
への変換と逆変換は、無効な日付を持つが有効な年と月を含む
year_month_day
を正規化するために使用できます:
using namespace std::chrono; auto ymd = 2017y/January/0; ymd = sys_days{ymd}; // ymd は現在 2016y/December/31 です
年と月の正規化は、ゼロの std::chrono::months を加算(または減算)することで実行できます:
using namespace std::chrono; constexpr year_month_day normalize(year_month_day ymd) { ymd += months{0}; // 年と月を正規化 return sys_days{ymd}; // 日を正規化 } static_assert(normalize(2017y/33/59) == 2019y/10/29);
例
このコードを実行
#include <chrono> #include <iostream> int main() { using namespace std::chrono; const auto today = sys_days{std::chrono::floor<days>(system_clock::now())}; for (const year_month_day ymd : {{November/15/2020}, {November/15/2120}, today}) { std::cout << ymd; const auto delta = (sys_days{ymd} - today).count(); (delta < 0) ? std::cout << " was " << -delta << " day(s) ago\n" : (delta > 0) ? std::cout << " is " << delta << " day(s) from now\n" : std::cout << " is today!\n"; } }
出力例:
2020-11-15 was 1014 day(s) ago 2120-11-15 is 35510 day(s) from now 2023-08-26 is today!