Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes