Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::chrono::time_point: punto sulla linea di uno specifico clock

std::chrono::time_point<Clock, Duration> memorizza una distanza dall’epoca del clock e rappresenta un punto, non solo una durata.

Versione: C++23

Sintassi

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> di <chrono> associa una duration all’epoca di Clock. La costruzione predefinita indica l’epoca e time_since_epoch() restituisce la distanza. Aggiungere o sottrarre una durata sposta il punto; sottrarre due punti dello stesso clock dà una durata.

Il template alias std::chrono::sys_time, usato come std::chrono::sys_time<Duration>, indica std::chrono::time_point<std::chrono::system_clock, Duration>, mentre std::chrono::sys_days è la sua specializzazione con risoluzione di un giorno. Entrambi rappresentano istanti del clock di sistema; std::chrono::sys_days è comodo per i confini dei giorni di calendario, ma da solo non associa un fuso orario.

Il tipo di clock fa parte del tipo, quindi punti di clock diversi non si sottraggono o confrontano senza una mappatura esplicita valida. Un numero dall’epoca non identifica una data senza conoscerne la semantica. time_point_cast, floor, ceil e round cambiano risoluzione, non clock.

Il costruttore di conversione partecipa alla risoluzione dell’overload solo se is_convertible_v<Duration2, duration> è true. Questo vincolo non garantisce che un valore specifico eviti overflow o perdita di precisione di Rep. Anche min() e max() richiedono attenzione. Un punto steady_clock non è un timestamp di calendario persistente.

Esempi

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

Risultato

7

std::chrono::time_point → 7

Fonti