std::chrono::format

C++

Language

Headers

Freestanding and hosted implementations

Named requirements

Language support library

Concepts library (C++20)

Diagnostics library

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

Filesystem library (C++17)

Technical Specifications

Utilities library

Type support (basic types, RTTI, type traits)
Dynamic memory management
Error handling
Program utilities
Variadic functions
Library feature-test macros
Date and time
Function objects
initializer_list (C++11)
bitset
hash (C++11)
integer_sequence (C++14)
Relational operators (deprecated)
rel_ops::operator!=rel_ops::operator>rel_ops::operator<=rel_ops::operator>=
Comparisons (C++20)
strong_order weak_order partial_order strong_equal weak_equal	strong_ordering weak_ordering partial_ordering strong_equality weak_equality	is_eqis_neqis_ltis_lteqis_gtis_gteq
common_comparison_category
Common vocabulary types
pair tuple (C++11) apply (C++17) make_from_tuple (C++17)	optional (C++17) any (C++17) variant (C++17)
Swap, forward and move
swap
exchange (C++14)
forward (C++11)
move (C++11)
move_if_noexcept (C++11)
Elementary string conversions
to_chars (C++17)
from_chars (C++17)
chars_format (C++17)
Type operations
declval (C++11)
as_const (C++17)

Date and time utilities

duration (C++11) time_point (C++11) time_of_day (C++20)	clock_time_conversion (C++20) clock_cast (C++20)
Clocks
system_clock (C++11) steady_clock (C++11) high_resolution_clock (C++11) is_clock (C++20)	utc_clock (C++20) tai_clock (C++20) gps_clock (C++20) file_clock (C++20) local_t (C++20)
Calendars
day (C++20) month (C++20) year (C++20) weekday (C++20) operator/ (C++20) year_month_day (C++20) year_month_day_last (C++20) year_month_weekday (C++20) year_month_weekday_last (C++20)	weekday_indexed (C++20) weekday_last (C++20) month_day (C++20) month_day_last (C++20) month_weekday (C++20) month_weekday_last (C++20) year_month (C++20)
Time zones
tzdb (C++20) tzdb_list (C++20) get_tzdbget_tzdb_listreload_tzdbremote_version (C++20)(C++20)(C++20)(C++20)	time_zone (C++20) locate_zone (C++20) current_zone (C++20) zoned_time (C++20) link (C++20) leap (C++20)
C-style date and time

template< class CharT, class Streamable> std::basic_string<CharT> format(const CharT* fmt, const Streamable& s);	(1)	(since C++20)
template<class CharT, class Streamable> std::basic_string<CharT> format(const std::locale& loc, const CharT* fmt, const Streamable& s);	(2)	(since C++20)
template<class CharT, class Traits, class Alloc, class Streamable> std::basic_string<CharT, Traits, Alloc> format(const std::basic_string<CharT, Traits, Alloc>& fmt, const Streamable& s);	(3)	(since C++20)
template<class CharT, class Traits, class Alloc, class Streamable> std::basic_string<CharT, Traits, Alloc> format(const std::locale& loc, const std::basic_string<CharT, Traits, Alloc>& fmt, const Streamable& s);	(4)	(since C++20)

Formats the streamable object s using the format string fmt and the locale loc (if provided).

These function templates behave as if they

• construct a std::basic_ostringstream<CharT, Traits, Alloc> os (where Traits is std::char_traits<CharT> and Alloc is std::allocator<CharT> for (1,2));
• execute os.exceptions(std::ios_base::failbit|std::ios_base::badbit);
• call os.imbue(loc) (for overloads (2,4) only);
• call to_stream(os, fmt, s) (for (1,2)) or to_stream(os, fmt.c_str(), s) (for (3,4)), where to_stream is called unqualified to enable argument-dependent lookup;
• then return os.str().

1-2) These overloads only participate in overload resolution if to_stream(std::declval<std::basic_ostream<CharT>&>(), fmt, s) is a valid expression.

3-4) These overloads only participate in overload resolution if to_stream(std::declval<std::basic_ostringstream<CharT, Traits, Alloc>&>(), fmt.c_str(), s) is a valid expression.

Format string

The format string consists of zero or more conversion specifiers and ordinary characters. All ordinary characters, excluding the terminating null character, are written into the output stream without modification. Each unmodified conversion specifier begins with a % character followed by a character that determines the behavior of the specifier. Some conversion specifiers have a modified form in which an E or O modifier character is inserted after the % character. Each conversion specifier is replaced by appropriate characters in the output as described below.

A character sequence in the format string that begins with a % but does not match one of the format specifiers below is interpreted as ordinary characters.

The following format specifiers are available:

Conversion specifier	Explanation
%%	Writes a literal % character.
%n	Writes a newline character.
%t	Writes a horizontal tab character.
Year
%C %EC	Writes the year divided by 100 using floored division. If the result is a single decimal digit, it is prefixed with 0. The modified command %EC writes the locale's alternative representation of the century.
%y	Writes the last two decimal digits of the year. If the result is a single digit it is prefixed by 0.
%Y	Writes the year as a decimal number. If the result is less than four digits it is left-padded with 0 to four digits.
Month
%b %h	Writes the locale's abbreviated month name.
%B	Writes the locale's full month name.
%m %Om	Writes the month as a decimal number (January is 01). If the result is a single digit, it is prefixed with 0. The modified command %Om writes the locale's alternative representation.
Day
%d %Od	Writes the day of month as a decimal number. If the result is a single decimal digit, it is prefixed with 0. The modified command %Od writes the locale's alternative representation.
%e %Oe	Writes the day of month as a decimal number. If the result is a single decimal digit, it is prefixed with a space. The modified command %Oe writes the locale's alternative representation.
Day of the week
%a	Writes the locale's abbreviated weekday name.
%A	Writes the locale's full weekday name.
%u %Ou	Writes the ISO weekday as a decimal number (1-7), where Monday is 1. The modified command %Ou writes the locale's alternative representation.
%w %Ow	Writes the weekday as a decimal number (0-6), where Sunday is 0. The modified command %Ow writes the locale's alternative representation.
ISO 8601 week-based year
In ISO 8601 weeks begin with Monday and the first week of the year must satisfy the following requirements: Includes January 4 Includes first Thursday of the year
%g	Writes the last two decimal digits of the ISO 8601 week-based year. If the result is a single digit it is prefixed by 0.
%G	Writes the ISO 8601 week-based year as a decimal number. If the result is less than four digits it is left-padded with 0 to four digits.
%V %OV	Writes the ISO 8601 week of the year as a decimal number. If the result is a single digit, it is prefixed with 0. The modified command %OV writes the locale's alternative representation.
Week/day of the year
%j	Writes the day of the year as a decimal number (January 1 is 001). If the result is less than three digits, it is left-padded with 0 to three digits.
%U %OU	Writes the week number of the year as a decimal number. The first Sunday of the year is the first day of week 01. Days of the same year prior to that are in week 00. If the result is a single digit, it is prefixed with 0. The modified command %OU writes the locale's alternative representation.
%W %OW	Writes the week number of the year as a decimal number. The first Monday of the year is the first day of week 01. Days of the same year prior to that are in week 00. If the result is a single digit, it is prefixed with 0. The modified command %OW writes the locale's alternative representation.
Date
%D	Equivalent to "%m/%d/%y".
%F	Equivalent to "%Y-%m-%d".
%x %Ex	Writes the locale's date representation. The modified command %Ex produces the locale's alternate date representation.
Time of day
%H %OH	Writes the hour (24-hour clock) as a decimal number. If the result is a single digit, it is prefixed with 0. The modified command %OH writes the locale's alternative representation.
%I %OI	Writes the hour (12-hour clock) as a decimal number. If the result is a single digit, it is prefixed with 0. The modified command %OI writes the locale's alternative representation.
%M %OM	Writes the minute as a decimal number. If the result is a single digit, it is prefixed with 0. The modified command %OM writes the locale's alternative representation.
%S %OS	Writes the second as a decimal number. If the number of seconds is less than 10, the result is prefixed with 0. If the precision of the input cannot be exactly represented with seconds, then the format is a decimal floating point number with a fixed format and a precision matching that of the precision of the input (or to a microseconds precision if the conversion to floating point decimal seconds cannot be made within 18 fractional digits). The character for the decimal point is localized according to the locale. The modified command %OS writes the locale's alternative representation.
%p	Writes the locale's equivalent of the AM/PM designations associated with a 12-hour clock.
%R	Equivalent to "%H:%M".
%T	Equivalent to "%H:%M:%S".
%r	Writes the locale's 12-hour clock time.
%X %EX	Writes the locale's time representation. The modified command %EX writes the locale's alternate time representation.
Miscellaneous
%c %Ec	Writes the locale's date and time representation. The modified command %Ec writes the locale's alternative date and time representation.
%z %Ez %Oz	Writes the offset from UTC in the ISO 8601 format. For example -0430 refers to 4 hours 30 minutes behind UTC. If the offset is zero, +0000 is used. The modified commands %Ez and %Oz insert a : between the hours and minutes (e.g., -04:30).
%Z	Writes the time zone abbreviation.

See also

to_stream (std::chrono::sys_time) (C++20)	outputs a sys_time into a stream according to the provided format (function template)
to_stream (std::chrono::utc_time) (C++20)	outputs a utc_time into a stream according to the provided format (function template)
to_stream (std::chrono::tai_time) (C++20)	outputs a tai_time into a stream according to the provided format (function template)
to_stream (std::chrono::gps_time) (C++20)	outputs a gps_time into a stream according to the provided format (function template)
to_stream (std::chrono::file_time) (C++20)	outputs a file_time into a stream according to the provided format (function template)
to_stream (std::chrono::local_time) (C++20)	outputs a local_time into a stream according to the provided format (function template)
to_stream	outputs a year into a stream according to the provided format (function template)
to_stream	outputs a month into a stream according to the provided format (function template)
to_stream	outputs a day into a stream according to the provided format (function template)
to_stream	outputs a weekday into a stream according to the provided format (function template)
to_stream	outputs a month_day into a stream according to the provided format (function template)
to_stream	outputs a year_month into a stream according to the provided format (function template)
to_stream	outputs a year_month_day into a stream according to the provided format (function template)
to_stream	outputs a zoned_time into a stream according to the provided format (function template)