std::chrono::year_month_day:: operator sys_days, std::chrono::year_month_day:: operator local_days
From de.cppreference.net
<
cpp
|
chrono
|
year month day
|
constexpr
operator
std::
chrono
::
sys_days
(
)
const
noexcept
;
|
(1) | (seit C++20) |
|
constexpr
explicit
operator
std::
chrono
::
local_days
(
)
const
noexcept
;
|
(2) | (seit C++20) |
Konvertiert
*
this
zu einem
std::chrono::time_point
, das dasselbe Datum wie dieses
year_month_day
repräsentiert.
1)
Wenn
ok()
true
ist, enthält der Rückgabewert eine Anzahl von Tagen ab der
std::chrono::system_clock
Epoche (1970-01-01) bis zu
*
this
. Das Ergebnis ist negativ, wenn
*
this
ein Datum vor dieser Epoche repräsentiert.
Andernfalls, wenn das gespeicherte Jahr und Monat gültig sind (
year
(
)
.
ok
(
)
&&
month
(
)
.
ok
(
)
ist
true
), dann ist der zurückgegebene Wert
sys_days
(
year
(
)
/
month
(
)
/
1d
)
+
(
day
(
)
-
1d
)
.
Andernfalls (wenn
year
(
)
.
ok
(
)
&&
month
(
)
.
ok
(
)
false
ist), ist der Rückgabewert nicht spezifiziert.
Ein
std::chrono::sys_days
im Bereich
[
std::
chrono
::
days
{
-
12687428
}
,
std::
chrono
::
days
{
11248737
}
]
, der nach Konvertierung in
year_month_day
und zurück denselben Wert ergibt.
2)
Gleich wie
(1)
gibt aber
local_days
zurück. Entspricht
return
local_days
(
sys_days
(
*
this
)
.
time_since_epoch
(
)
)
;
.
Hinweise
Die Konvertierung zu
std::chrono::sys_days
und zurück kann verwendet werden, um einen
year_month_day
zu normalisieren, der einen ungültigen Tag, aber ein gültiges Jahr und einen gültigen Monat enthält:
using namespace std::chrono; auto ymd = 2017y/January/0; ymd = sys_days{ymd}; // ymd ist jetzt 2016y/December/31
Die Normalisierung von Jahr und Monat kann durch Addition (oder Subtraktion) von null std::chrono::months erfolgen:
using namespace std::chrono; constexpr year_month_day normalize(year_month_day ymd) { ymd += months{0}; // normalisiert Jahr und Monat return sys_days{ymd}; // normalisiert Tag } static_assert(normalize(2017y/33/59) == 2019y/10/29);
Beispiel
Diesen Code ausführen
#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"; } }
Mögliche Ausgabe:
2020-11-15 was 1014 day(s) ago 2120-11-15 is 35510 day(s) from now 2023-08-26 is today!