CKTIS / C++
%F et %R dans C++ chrono : décalage UTC fixe ou fuseau horaire nommé
`%F` affiche la date, et `%R` l’heure et les minutes au format 24 heures. Ils formatent la valeur fournie ; les règles du fuseau interviennent lors de la conversion.
Version : ISO C++23; implementation support may vary
Syntaxe
std::format("{:%F %R}", time_point)
std::chrono::zoned_time{std::chrono::locate_zone("Europe/Warsaw"), instant}Dans std::format("{:%F %R}", time_point), les spécificateurs placés après les deux-points formatent une valeur de std::chrono. %F équivaut à %Y-%m-%d (année, mois, jour). %R équivaut à %H:%M (heures et minutes au format 24 heures, avec des zéros initiaux). %R omet les secondes sans arrondir. Aucun des deux spécificateurs ne convertit la valeur vers un autre fuseau ni n’affiche de décalage UTC.
std::chrono::sys_seconds représente un instant dont la date et l’heure sont formatées en UTC. Pour afficher un décalage fixe de UTC+01:00, l’exemple ajoute std::chrono::hours{1} au temps écoulé depuis l’époque de référence et construit une valeur std::chrono::local_seconds à partir du résultat. Cette valeur contient la date et l’heure locales, sans fuseau ni décalage. EU_WARSAW est une simple étiquette de l’application : ce n’est pas un identifiant IANA et elle n’applique aucune règle d’heure d’été.
Pour appliquer les règles de Varsovie, utilisez std::chrono::zoned_time{std::chrono::locate_zone("Europe/Warsaw"), instant}. La base de données IANA des fuseaux horaires détermine le décalage en vigueur à cet instant, en tenant compte des changements d’heure. La recherche peut lever std::runtime_error si la base est indisponible ou si le nom n’y figure pas.
Ces fonctionnalités sont normalisées depuis C++20 et font partie d’ISO C++23, mais leur prise en charge varie selon la bibliothèque standard. L’exemple requiert le formatage de chrono, mais pas de base de données de fuseaux horaires.
Exemples
#include <chrono>
#include <format>
#include <iostream>
int main() {
using namespace std::chrono;
const sys_seconds instant = sys_days{year{2024}/July/1}
+ hours{23} + minutes{30} + seconds{45};
const local_seconds fixed_local{instant.time_since_epoch() + hours{1}};
std::cout << std::format("UTC: {:%F %R}\n", instant)
<< std::format("EU_WARSAW (fixed UTC+01:00): {:%F %R}\n",
fixed_local);
}Résultat
UTC: 2024-07-01 23:30 EU_WARSAW (fixed UTC+01:00): 2024-07-02 00:30
Une heure après `2024-07-01 23:30:45` UTC, il est `2024-07-02 00:30:45`. `%R` affiche `00:30`. La seconde ligne montre le résultat du décalage fixe, pas celui d’une conversion selon les règles de Varsovie.
Leçons associées
- C++ · Leçon 50 · Avancé · Version : 3
Sources
- C++ working draft — Formatting [time.format]
- C++ working draft — Local time [time.clock.local]
- C++ working draft — Time zones [time.zone]
- C++ working draft — Class template zoned_time [time.zone.zonedtime]
- C++ working draft — Time zone database access [time.zone.db.access]
- C++ working draft — Class tzdb [time.zone.db.tzdb]
- C++ Draft International Standard (N4860)