Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::chrono::time_point : point sur l’axe d’une horloge

std::chrono::time_point<Clock, Duration> stocke un décalage depuis l’époque d’une horloge et représente un point, pas seulement une durée.

Version : C++23

Syntaxe

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> de <chrono> associe une duration à l’époque de Clock. La construction par défaut désigne l’époque ; time_since_epoch() renvoie le décalage. Ajouter ou soustraire une durée déplace le point ; soustraire deux points du même clock donne une durée.

Le modèle d’alias std::chrono::sys_time, employé comme std::chrono::sys_time<Duration>, désigne std::chrono::time_point<std::chrono::system_clock, Duration>, tandis que std::chrono::sys_days est sa spécialisation à la résolution d’un jour. Les deux désignent des points de l’horloge système ; std::chrono::sys_days convient aux limites de jours calendaires, mais n’attache pas à lui seul de fuseau horaire.

Le type d’horloge fait partie du type : sans mapping explicite valide, des points d’horloges différentes ne se comparent ni ne se soustraient. Un décalage seul n’indique pas une date sans connaître l’époque. time_point_cast, floor, ceil et round changent la résolution, pas l’horloge.

Le constructeur de conversion ne participe à la résolution de surcharge que si is_convertible_v<Duration2, duration> vaut true. Cette contrainte ne garantit pas qu’une valeur donnée évite le débordement ou une perte de précision de Rep. min() et max() exigent aussi de l’attention. Un point de steady_clock n’est pas un horodatage calendaire persistant.

Exemples

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

Résultat

7

std::chrono::time_point → 7

Sources