std::chrono:: utc_clock

Défini dans l'en-tête <chrono>
class utc_clock ;		(depuis C++20)

L'horloge std::chrono::utc_clock est une Clock qui représente le temps universel coordonné (UTC). Elle mesure le temps depuis le 1ᵉʳ janvier 1970, jeudi, 00:00:00 UTC, incluant les secondes intercalaires.

utc_clock satisfait aux exigences Clock . Il ne satisfait pas aux exigences TrivialClock à moins que l'implémentation ne puisse garantir que now() ne lève pas d'exception.

Table des matières 1 Famille de points temporels 2 Types membres 3 Constantes membres 4 Fonctions membres 5 Fonctions non membres 6 Classes auxiliaires 7 Notes

Famille de points temporels

Défini dans l'espace de noms std::chrono
template < class Duration > using utc_time = std:: chrono :: time_point < std :: chrono :: utc_clock , Duration > ;		(depuis C++20)
using utc_seconds = utc_time < std:: chrono :: seconds > ;		(depuis C++20)

operator<< (std::chrono::utc_time) (C++20)	effectue une sortie de flux sur un utc_time (modèle de fonction)
from_stream (std::chrono::utc_time) (C++20)	analyse un utc_time à partir d'un flux selon le format fourni (modèle de fonction)
std::formatter <std::chrono::utc_time> (C++20)	support de formatage pour utc_time (spécialisation de modèle de classe)

Types membres

Type de membre	Définition
rep	type arithmétique signé représentant le nombre de ticks dans la durée de l'horloge
period	un std::ratio représentant la période de tick de l'horloge, en secondes
duration	std:: chrono :: duration < rep, period > , capable de représenter des durées négatives
time_point	std:: chrono :: time_point < std :: chrono :: utc_clock >

Constantes membres

constexpr bool is_steady [static]

true si le temps entre les ticks est toujours constant, c'est-à-dire que les appels à now() renvoient des valeurs qui augmentent de manière monotone même en cas d'ajustement d'horloge externe, sinon false (constante membre statique publique)

Fonctions membres

now [static]	retourne un std::chrono::time_point représentant le point actuel dans le temps (fonction membre publique statique)
to_sys [static]	convertit utc_time en sys_time (fonction membre publique statique)
from_sys [static]	convertit sys_time en utc_time (fonction membre publique statique)

Fonctions non membres

get_leap_second_info (C++20)

obtient les informations d'insertion de seconde intercalaire à partir d'un utc_time object (modèle de fonction)

Classes d'assistance

leap_second_info (C++20)

Informations sur l'insertion des secondes intercalaires (classe)

Notes

L'époque UTC officielle est le 1er janvier 1972. utc_clock utilise le 1er janvier 1970 à la place pour être cohérent avec std::chrono::system_clock .