KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::chrono::time_point: punt op de tijdlijn van een klok

std::chrono::time_point<Clock, Duration> bewaart een offset vanaf een klok-epoch en stelt een punt voor, niet alleen een tijdsduur.

Versie: 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> uit <chrono> koppelt een duration aan de epoch van Clock. Standaardconstructie is de epoch; time_since_epoch() geeft de offset. Een duur optellen of aftrekken verplaatst het punt; twee punten van dezelfde klok aftrekken geeft een duur.

De aliastemplate std::chrono::sys_time, gebruikt als std::chrono::sys_time<Duration>, duidt std::chrono::time_point<std::chrono::system_clock, Duration> aan, terwijl std::chrono::sys_days de specialisatie met dagresolutie is. Beide duiden systeemkloktijdstippen aan; std::chrono::sys_days is handig voor kalenderdaggrenzen, maar koppelt zelf geen tijdzone.

Het kloktype is deel van het type. Punten van verschillende klokken zijn zonder expliciete geldige mapping niet vergelijkbaar of aftrekbaar. Een numerieke offset bepaalt zonder epoch-semantiek geen datum. time_point_cast, floor, ceil en round wijzigen resolutie, niet klok.

De converterende constructor doet alleen mee aan overloadresolutie als is_convertible_v<Duration2, duration> true is. Die beperking garandeert niet dat een concrete waarde overflow of verlies van Rep-precisie vermijdt. Ook min() en max() vragen aandacht. Een steady_clock-punt is geen blijvende kalender-timestamp.

Voorbeelden

#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';
}

Resultaat

7

std::chrono::time_point → 7

Bronnen