WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::chrono::time_point: Punkt auf der Achse einer bestimmten Uhr

std::chrono::time_point<Clock, Duration> speichert einen Abstand zur Uhrenepoche und stellt einen Punkt statt nur einer Dauer dar.

Version: C++23

Syntax

template<class Clock, class Duration = typename Clock::duration>
class time_point;

constexpr Duration time_since_epoch() const;

template<class Duration>
using sys_time = time_point<system_clock, Duration>;
using sys_days = sys_time<days>;

std::chrono::time_point<Clock, Duration> aus <chrono> verbindet eine duration mit der Epoche von Clock. Standardkonstruktion bezeichnet die Epoche; time_since_epoch() liefert den Abstand. Addition oder Subtraktion einer Dauer verschiebt den Punkt; die Differenz zweier Punkte derselben Uhr ist eine Dauer.

Das Alias-Template std::chrono::sys_time, verwendet als std::chrono::sys_time<Duration>, bezeichnet std::chrono::time_point<std::chrono::system_clock, Duration>, während std::chrono::sys_days dessen Spezialisierung mit Tagesauflösung ist. Beide bezeichnen Systemzeitpunkte; std::chrono::sys_days eignet sich für Kalendertagsgrenzen, enthält aber selbst keine Zeitzone.

Der Uhrtyp ist Teil des Typs. Punkte verschiedener Uhren lassen sich ohne explizite gültige Abbildung nicht subtrahieren oder vergleichen. Eine Zahl ab Epoche bestimmt ohne deren Semantik kein Datum. time_point_cast, floor, ceil und round ändern die Auflösung, nicht die Uhr.

Der konvertierende Konstruktor nimmt nur dann an der Überladungsauflösung teil, wenn is_convertible_v<Duration2, duration> den Wert true hat. Diese Einschränkung garantiert für einen konkreten Wert weder Schutz vor Überlauf noch vor Verlust an Rep-Genauigkeit. Auch min() und max() brauchen Beachtung. Ein steady_clock-Punkt ist kein dauerhafter Kalenderzeitstempel.

Beispiele

#include <chrono>
#include <iostream>

int main() {
    using Point = std::chrono::time_point<std::chrono::system_clock, std::chrono::seconds>;
    Point point{std::chrono::seconds{3}};
    point += std::chrono::seconds{4};
    std::cout << point.time_since_epoch().count() << '\n';
}

Ergebnis

7

std::chrono::time_point → 7

Quellen