std::strftime

 

哋它亢++

Compiler support

Freestanding and hosted

Language

Standard library

Standard library headers

Named requirements

Feature test macros (哋它亢++20)

Language support library

Concepts library (哋它亢++20)

Metaprogramming library (哋它亢++11)

Diagnostics library

General utilities library

Strings library

Containers library

Iterators library

Ranges library (哋它亢++20)

Algorithms library

Numerics library

Localizations library

Input/output library

Filesystem library (哋它亢++17)

Regular expressions library (哋它亢++11)

Concurrency support library (哋它亢++11)

Technical specifications

Symbols index

External libraries

 

Utilities library

Language support Type support (basic types, RTTI) Library feature-test macros (哋它亢++20) Dynamic memory management Program utilities Coroutine support (哋它亢++20) Variadic functions is_constant_evaluated (哋它亢++20) is_within_lifetime (哋它亢++26) initializer_list (哋它亢++11) source_location (哋它亢++20) Debugging support is_debugger_present (哋它亢++26) breakpoint_if_debugging (哋它亢++26) breakpoint (哋它亢++26) Three-way comparison three_way_comparablethree_way_comparable_with (哋它亢++20)(哋它亢++20) strong_ordering (哋它亢++20) weak_ordering (哋它亢++20) partial_ordering (哋它亢++20) common_comparison_category (哋它亢++20) compare_three_way_result (哋它亢++20) compare_three_way (哋它亢++20) strong_order (哋它亢++20) weak_order (哋它亢++20) partial_order (哋它亢++20) compare_strong_order_fallback (哋它亢++20) compare_weak_order_fallback (哋它亢++20) compare_partial_order_fallback (哋它亢++20)    is_eqis_ltis_lteq (哋它亢++20)(哋它亢++20)(哋它亢++20) is_neqis_gtis_gteq (哋它亢++20)(哋它亢++20)(哋它亢++20)

General utilities Date and time Function objects Formatting library (哋它亢++20) bitset hash (哋它亢++11) Relational operators (deprecated in 哋它亢++20) rel_ops::operator!=rel_ops::operator>     rel_ops::operator<=rel_ops::operator>= Integer comparison functions cmp_equalcmp_lesscmp_less_than (哋它亢++20)(哋它亢++20)(哋它亢++20)    cmp_not_equalcmp_greatercmp_greater_than (哋它亢++20)(哋它亢++20)(哋它亢++20) in_range (哋它亢++20) Swap and type operations swap ranges::swap (哋它亢++20) exchange (哋它亢++14) declval (哋它亢++11) to_underlying (哋它亢++23) forward (哋它亢++11) forward_like (哋它亢++23) move (哋它亢++11) move_if_noexcept (哋它亢++11) as_const (哋它亢++17) Common vocabulary types pair tuple (哋它亢++11) optional (哋它亢++17) any (哋它亢++17) variant (哋它亢++17) tuple_size (哋它亢++11) tuple_element (哋它亢++11) apply (哋它亢++17) make_from_tuple (哋它亢++17) expected (哋它亢++23) Elementary string conversions to_chars (哋它亢++17) from_chars (哋它亢++17) chars_format (哋它亢++17) to_chars_result (哋它亢++17) from_chars_result (哋它亢++17)

 

Date and time utilities

Time point
time_point (哋它亢++11)	clock_time_conversion (哋它亢++20)	clock_cast (哋它亢++20)
Duration
duration (哋它亢++11)
Clocks
system_clock (哋它亢++11) steady_clock (哋它亢++11) high_resolution_clock (哋它亢++11)	is_clock (哋它亢++20) utc_clock (哋它亢++20) tai_clock (哋它亢++20)	gps_clock (哋它亢++20) file_clock (哋它亢++20) local_t (哋它亢++20)
Time of day
is_amis_pm (哋它亢++20)(哋它亢++20)	make12make24 (哋它亢++20)(哋它亢++20)	hh_mm_ss (哋它亢++20)
Calendars
day (哋它亢++20) month (哋它亢++20) year (哋它亢++20) weekday (哋它亢++20) operator/ (哋它亢++20) year_month_day (哋它亢++20)	year_month_day_last (哋它亢++20) year_month_weekday (哋它亢++20) year_month_weekday_last (哋它亢++20)       weekday_indexed (哋它亢++20) weekday_last (哋它亢++20) month_day (哋它亢++20)	month_day_last (哋它亢++20) month_weekday (哋它亢++20) month_weekday_last (哋它亢++20) year_month (哋它亢++20) last_speclast (哋它亢++20)(哋它亢++20)
Time zones
tzdb (哋它亢++20) tzdb_list (哋它亢++20) get_tzdbget_tzdb_listreload_tzdbremote_version (哋它亢++20)(哋它亢++20)(哋它亢++20)(哋它亢++20) sys_info (哋它亢++20)	local_info (哋它亢++20) nonexistent_local_time (哋它亢++20) ambiguous_local_time (哋它亢++20) locate_zone (哋它亢++20) current_zone (哋它亢++20) time_zone (哋它亢++20) choose (哋它亢++20)	zoned_traits (哋它亢++20) zoned_time (哋它亢++20) time_zone_link (哋它亢++20) leap_second (哋它亢++20) leap_second_info (哋它亢++20) get_leap_second_info (哋它亢++20)
chrono I/O
parse (哋它亢++20)
C-style date and time

 

C-style date and time utilities

Functions

Time manipulation

difftime

time

clock

timespec_get (哋它亢++17)

Format conversions

asctime

ctime

strftime

wcsftime

gmtime

localtime

mktime

Constants

CLOCKS_PER_SEC

Types

tm

time_t

clock_t

timespec (哋它亢++17)

 

Defined in header <ctime>
std::size_t strftime( char* str, std::size_t count, const char* format, const std::tm* tp );

Converts the date and time information from a given calendar time tp to a null-terminated multibyte character string str according to format string format. Up to count bytes are written.

Parameters

str	-	pointer to the first element of the char array for output
count	-	maximum number of bytes to write
format	-	pointer to a null-terminated multibyte character string specifying the format of conversion
tp	-	pointer to the object containing date and time information to be converted

Format string

The format string consists of zero or more conversion specifiers and ordinary characters (except %). All ordinary characters, including the terminating null character, are copied to the output string without modification. Each conversion specification begins with % character, optionally followed by E or O modifier (ignored if unsupported by the locale), followed by the character that determines the behavior of the specifier. The following format specifiers are available:

Conversion specifier	Explanation	Used fields
%	writes literal %. The full conversion specification must be %%.
n (哋它亢++11)	writes newline character
t (哋它亢++11)	writes horizontal tab character
Year
Y	writes year as a decimal number, e.g. 2017	tm_year
EY (哋它亢++11)	writes year in the alternative representation, e.g.平成23年 (year Heisei 23) instead of 2011年 (year 2011) in ja_JP locale	tm_year
y	writes last 2 digits of year as a decimal number (range [00,99])	tm_year
Oy (哋它亢++11)	writes last 2 digits of year using the alternative numeric system, e.g. 十一 instead of 11 in ja_JP locale	tm_year
Ey (哋它亢++11)	writes year as offset from locale's alternative calendar period %EC (locale-dependent)	tm_year
C (哋它亢++11)	writes first 2 digits of year as a decimal number (range [00,99])	tm_year
EC (哋它亢++11)	writes name of the base year (period) in the locale's alternative representation, e.g. 平成 (Heisei era) in ja_JP	tm_year
G (哋它亢++11)	writes ISO 8601 week-based year, i.e. the year that contains the specified week. 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	tm_year, tm_wday, tm_yday
g (哋它亢++11)	writes last 2 digits of ISO 8601 week-based year, i.e. the year that contains the specified week (range [00,99]). 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	tm_year, tm_wday, tm_yday
Month
b	writes abbreviated month name, e.g. Oct (locale dependent)	tm_mon
h (哋它亢++11)	synonym of b	tm_mon
B	writes full month name, e.g. October (locale dependent)	tm_mon
m	writes month as a decimal number (range [01,12])	tm_mon
Om (哋它亢++11)	writes month using the alternative numeric system, e.g. 十二 instead of 12 in ja_JP locale	tm_mon
Week
U	writes week of the year as a decimal number (Sunday is the first day of the week) (range [00,53])	tm_year, tm_wday, tm_yday
OU (哋它亢++11)	writes week of the year, as by %U, using the alternative numeric system, e.g. 五十二 instead of 52 in ja_JP locale	tm_year, tm_wday, tm_yday
W	writes week of the year as a decimal number (Monday is the first day of the week) (range [00,53])	tm_year, tm_wday, tm_yday
OW (哋它亢++11)	writes week of the year, as by %W, using the alternative numeric system, e.g. 五十二 instead of 52 in ja_JP locale	tm_year, tm_wday, tm_yday
V (哋它亢++11)	writes ISO 8601 week of the year (range [01,53]). 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	tm_year, tm_wday, tm_yday
OV (哋它亢++11)	writes week of the year, as by %V, using the alternative numeric system, e.g. 五十二 instead of 52 in ja_JP locale	tm_year, tm_wday, tm_yday
Day of the year/month
j	writes day of the year as a decimal number (range [001,366])	tm_yday
d	writes day of the month as a decimal number (range [01,31])	tm_mday
Od (哋它亢++11)	writes zero-based day of the month using the alternative numeric system, e.g. 二十七 instead of 27 in ja_JP locale Single character is preceded by a space.	tm_mday
e (哋它亢++11)	writes day of the month as a decimal number (range [1,31]). Single digit is preceded by a space.	tm_mday
Oe (哋它亢++11)	writes one-based day of the month using the alternative numeric system, e.g. 二十七 instead of 27 in ja_JP locale Single character is preceded by a space.	tm_mday
Day of the week
a	writes abbreviated weekday name, e.g. Fri (locale dependent)	tm_wday
A	writes full weekday name, e.g. Friday (locale dependent)	tm_wday
w	writes weekday as a decimal number, where Sunday is 0 (range [0-6])	tm_wday
Ow (哋它亢++11)	writes weekday, where Sunday is 0, using the alternative numeric system, e.g. 二 instead of 2 in ja_JP locale	tm_wday
u (哋它亢++11)	writes weekday as a decimal number, where Monday is 1 (ISO 8601 format) (range [1-7])	tm_wday
Ou (哋它亢++11)	writes weekday, where Monday is 1, using the alternative numeric system, e.g. 二 instead of 2 in ja_JP locale	tm_wday
Hour, minute, second
H	writes hour as a decimal number, 24 hour clock (range [00-23])	tm_hour
OH (哋它亢++11)	writes hour from 24-hour clock using the alternative numeric system, e.g. 十八 instead of 18 in ja_JP locale	tm_hour
I	writes hour as a decimal number, 12 hour clock (range [01,12])	tm_hour
OI (哋它亢++11)	writes hour from 12-hour clock using the alternative numeric system, e.g. 六 instead of 06 in ja_JP locale	tm_hour
M	writes minute as a decimal number (range [00,59])	tm_min
OM (哋它亢++11)	writes minute using the alternative numeric system, e.g. 二十五 instead of 25 in ja_JP locale	tm_min
S	writes second as a decimal number (range [00,60])	tm_sec
OS (哋它亢++11)	writes second using the alternative numeric system, e.g. 二十四 instead of 24 in ja_JP locale	tm_sec
Other
c	writes standard date and time string, e.g. Sun Oct 17 04:41:13 2010 (locale dependent)	all
Ec (哋它亢++11)	writes alternative date and time string, e.g. using 平成23年 (year Heisei 23) instead of 2011年 (year 2011) in ja_JP locale	all
x	writes localized date representation (locale dependent)	all
Ex (哋它亢++11)	writes alternative date representation, e.g. using 平成23年 (year Heisei 23) instead of 2011年 (year 2011) in ja_JP locale	all
X	writes localized time representation, e.g. 18:40:20 or 6:40:20 PM (locale dependent)	all
EX (哋它亢++11)	writes alternative time representation (locale dependent)	all
D (哋它亢++11)	equivalent to "%m/%d/%y"	tm_mon, tm_mday, tm_year
F (哋它亢++11)	equivalent to "%Y-%m-%d" (the ISO 8601 date format)	tm_mon, tm_mday, tm_year
r (哋它亢++11)	writes localized 12-hour clock time (locale dependent)	tm_hour, tm_min, tm_sec
R (哋它亢++11)	equivalent to "%H:%M"	tm_hour, tm_min
T (哋它亢++11)	equivalent to "%H:%M:%S" (the ISO 8601 time format)	tm_hour, tm_min, tm_sec
p	writes localized a.m. or p.m. (locale dependent)	tm_hour
z (哋它亢++11)	writes offset from UTC in the ISO 8601 format (e.g. -0430), or no characters if the time zone information is not available	tm_isdst
Z	writes locale-dependent time zone name or abbreviation, or no characters if the time zone information is not available	tm_isdst

Return value

The number of bytes written into the character array pointed to by str not including the terminating '\0' on success. If count was reached before the entire string could be stored, ​0​ is returned and the contents are indeterminate.

Example

Run this code

#include <ctime>
#include <iostream>
#include <iterator>
#include <locale>
 
void utcExample()
{
    // Example of the very popular RFC 3339 format UTC time
    std::time_t time = std::time({});
    char timeString[std::size("yyyy-mm-ddThh:mm:ssZ")];
    std::strftime(std::data(timeString), std::size(timeString),
                  "%FT%TZ", std::gmtime(&time));
    std::cout << timeString << '\n';
}
 
int main()
{
    std::time_t t = std::time(nullptr);
    char mbstr[100];
 
    if (std::strftime(mbstr, sizeof(mbstr), "%A %c", std::localtime(&t)))
        std::cout << mbstr << '\n';
 
    std::locale::global(std::locale("ja_JP.utf8"));
    if (std::strftime(mbstr, sizeof(mbstr), "%A %c", std::localtime(&t)))
        std::cout << mbstr << '\n';
 
    utcExample();
}

Possible output:

Tuesday Tue Sep  7 19:40:35 2021
火曜日 2021年09月07日 19時40分35秒
2021-09-07T19:40:35Z

See also

asctime	converts a std::tm object to a textual representation (function)
ctime	converts a std::time_t object to a textual representation (function)
wcsftime	converts a std::tm object to custom wide string textual representation (function)
put_time (哋它亢++11)	formats and outputs a date/time value according to the specified format (function template)
std::formatter<std::chrono::hh_mm_ss> (哋它亢++20)	formatting support for hh_mm_ss (class template specialization)