Converts given time since epoch to a calendar local time and then to a textual representation, as if by callingstd::asctime(std::localtime(time)). The resulting string has the following format:

Www Mmm dd hh:mm:ss yyyy\n

• Www - the day of the week (one ofMon,Tue,Wed,Thu,Fri,Sat,Sun).
• Mmm - the month (one ofJan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec).
• dd - the day of the month.
• hh - hours.
• mm - minutes.
• ss - seconds.
• yyyy - years.

The function does not support localization.

[edit]Parameters

[edit]Return value

Pointer to a static null-terminated character string holding the textual representation of date and time. The string may be shared betweenstd::asctime andstd::ctime, and may be overwritten on each invocation of any of those functions.

[edit]Notes

This function returns a pointer to static data and is not thread-safe. In addition, it modifies the staticstd::tm object which may be shared withstd::gmtime andstd::localtime. POSIX marks this function obsolete and recommendsstd::strftime instead.

The behavior may be undefined for the values ofstd::time_t that result in the string longer than 25 characters (e.g. year 10000).

[edit]Example

#include <cassert>#include <cstring>#include <ctime>#include <iostream> int main(){std::time_t result=std::time(nullptr);std::cout<< std::ctime(&result); char buffer[32];std::strncpy(buffer, std::ctime(&result),26);assert('\n'== buffer[std::strlen(buffer)-1]);std::cout<< buffer;}

Mon Oct 11 17:10:55 2021Mon Oct 11 17:10:55 2021

[edit]See also

• In other languages

• Deutsch
• Español
• Français
• Italiano
• 日本語
• Português
• Русский
• 中文