CKTIS / C++
std::chrono::time_point: ponto na linha de um relógio
std::chrono::time_point<Clock, Duration> guarda um deslocamento desde a época do relógio e representa um ponto, não apenas uma duração.
Versão: C++23
Sintaxe
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>, associa uma duration à época de Clock. A construção predefinida indica a época e time_since_epoch() devolve o deslocamento. Somar ou subtrair uma duração move o ponto; subtrair dois pontos do mesmo relógio dá uma duração.
O template de alias std::chrono::sys_time, usado como std::chrono::sys_time<Duration>, representa std::chrono::time_point<std::chrono::system_clock, Duration>, enquanto std::chrono::sys_days é a sua especialização com resolução de dias. Ambos representam pontos do relógio do sistema; std::chrono::sys_days é útil para limites de dias de calendário, mas não associa por si só um fuso horário.
O tipo de relógio faz parte do tipo, logo pontos de relógios diferentes não se subtraem ou comparam sem mapeamento explícito válido. Um número desde a época não é uma data sem a conhecer. time_point_cast, floor, ceil e round mudam resolução, não relógio.
O construtor de conversão só participa na resolução de sobrecarga se is_convertible_v<Duration2, duration> for true. Essa restrição não garante que um valor concreto evite overflow ou perda de precisão de Rep. min() e max() também exigem cuidado. Um ponto de steady_clock não é timestamp de calendário persistente.
Exemplos
#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';
}
Resultado
7
std::chrono::time_point → 7