Spec-Zone.ru › C++

std::ctime

Определено в заголовке <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 - годы.

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

Параметры

time - указатель на объект std::time_t, определяющий время для вывода

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

Указатель на статическую, завершающуюся нулём, строку символов, содержащую текстовое представление даты и времени. Строка может быть совместно использована между 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

См. также

asctime
преобразует объект std::tm в текстовое представление
(функция)
strftime
преобразует объект std::tm в пользовательское текстовое представление
(функция)
put_time
(C++11)
форматирует и выводит значение даты/времени в соответствии с заданным форматом
(шаблон функции)
C документация для ctime

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/chrono/c/ctime

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API