CKTIS / C++
%F y %R en C++ chrono: desfase UTC fijo frente a zona horaria con nombre
`%F` muestra la fecha y `%R` muestra horas y minutos en formato de 24 horas. Ambos dan formato al valor recibido; las reglas de zona se aplican al convertirlo.
Versión: ISO C++23; implementation support may vary
Sintaxis
std::format("{:%F %R}", time_point)
std::chrono::zoned_time{std::chrono::locate_zone("Europe/Warsaw"), instant}En std::format("{:%F %R}", time_point), los especificadores tras los dos puntos dan formato a un valor de std::chrono. %F equivale a %Y-%m-%d (año, mes y día), y %R equivale a %H:%M (horas y minutos en formato de 24 horas, con ceros a la izquierda). %R omite los segundos sin redondear. Ninguno de los dos especificadores convierte entre zonas horarias ni muestra el desfase respecto de UTC.
std::chrono::sys_seconds representa un instante cuya fecha y hora se formatean en UTC. Para mostrar un desfase fijo de UTC+01:00, el ejemplo suma std::chrono::hours{1} al tiempo transcurrido desde la época de referencia y construye un std::chrono::local_seconds con el resultado. Este valor contiene la fecha y la hora locales, pero no una zona ni un desfase. EU_WARSAW es solo una etiqueta de la aplicación: no es un identificador de IANA ni aplica reglas de horario de verano.
Para aplicar las reglas de Varsovia, usa std::chrono::zoned_time{std::chrono::locate_zone("Europe/Warsaw"), instant}. La base de datos de zonas horarias de IANA determina el desfase vigente en ese instante, teniendo en cuenta los cambios de horario de verano. La búsqueda puede lanzar std::runtime_error si la base de datos no está disponible o si no se encuentra el nombre.
Estas funciones se incorporaron al estándar en C++20 y forman parte de ISO C++23, pero su disponibilidad depende de la biblioteca estándar. El ejemplo requiere el formateo de chrono, pero no una base de datos de zonas horarias.
Ejemplos
#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);
}Resultado
UTC: 2024-07-01 23:30 EU_WARSAW (fixed UTC+01:00): 2024-07-02 00:30
Al sumar una hora a `2024-07-01 23:30:45` UTC se obtiene `2024-07-02 00:30:45`. `%R` muestra `00:30`. La segunda línea muestra el resultado del desfase fijo, no de una conversión según las reglas de Varsovia.
Lecciones relacionadas
- C++ · Lección 50 · Avanzado · Versión: 3
Fuentes
- 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)