std::ctime

char* ctime( const std::time_t* time );

Преобразует заданное время, прошедшее с начала эпохи, в местное календарное время, а затем в текстовое представление, как если бы была вызвана std::asctime(std::localtime(time)). Полученная строка имеет следующий формат:

Www Mmm dd hh:mm:ss yyyy\n

• Www — день недели (одно из значений Mon, Tue, Wed, Thu, Fri, Sat, Sun).
• Mmm — месяц (одно из значений Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec).
• dd — день месяца.
• hh — часы.
• mm — минуты.
• ss — секунды.
• yyyy — годы.

Функция не поддерживает локализацию.

Параметры

Возвращаемое значение

Указатель на статическую строку символов с завершающим нулём, содержащую текстовое представление даты и времени. Строка может быть общей для std::asctime и std::ctime и может перезаписываться при каждом вызове любой из этих функций.

Примечания

Эта функция возвращает указатель на статические данные и не является потокобезопасной. Кроме того, она изменяет статический объект std::tm, который может быть общим с std::gmtime и std::localtime. POSIX считает эту функцию устаревшей и рекомендует вместо неё использовать std::strftime.

Поведение может быть неопределённым для значений std::time_t, при которых строка оказывается длиннее 25 символов (например, для 10000 года).

Пример

#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 2021
Mon Oct 11 17:10:55 2021

См. также