Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::chrono::time_point: punkt na osi konkretnego zegara

std::chrono::time_point<Clock, Duration> przechowuje odstęp od epoki zegara i reprezentuje punkt, nie sam czas trwania.

Wersja: C++23

Składnia

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> z <chrono> wiąże duration z epoką typu Clock. Konstruktor domyślny oznacza epokę, a time_since_epoch() zwraca przechowywany odstęp. Dodanie lub odjęcie duration przesuwa punkt; odjęcie dwóch punktów tego samego zegara daje czas trwania.

Szablon aliasu std::chrono::sys_time, użyty jako std::chrono::sys_time<Duration>, oznacza std::chrono::time_point<std::chrono::system_clock, Duration>, a std::chrono::sys_days jest jego specjalizacją z dokładnością do dni. Oba typy opisują punkty zegara systemowego; std::chrono::sys_days jest wygodny dla granic dni kalendarzowych, lecz sam nie dołącza strefy czasowej.

Typ zegara jest częścią typu, więc punktów z różnych zegarów nie odejmuje się ani nie porównuje bez jawnego, poprawnego mapowania. Sama liczba od epoki nie określa daty, jeśli semantyka epoki zegara nie jest znana. time_point_cast, floor, ceil i round zmieniają rozdzielczość, nie zegar.

Konstruktor konwertujący uczestniczy w rozwiązywaniu przeciążeń tylko wtedy, gdy is_convertible_v<Duration2, duration> ma wartość true. Ten warunek nie gwarantuje, że konkretna wartość uniknie przepełnienia ani utraty precyzji Rep. min() i max() także wymagają uwagi. Punkt z steady_clock nie jest trwałym znacznikiem kalendarzowym.

Przykłady

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

Wynik

7

std::chrono::time_point → 7

Źródła