Функция strftime

Прототип функции strftime:

size_t strftime( char * stringptr, size_t maxnum, const char * strformat, const struct tm * timeptr );

Заголовочный файл

Описание

Из структуры tm извлекаются необходимые значения даты и времени и помещаются в строку strformat, где и подвергаются форматированию с помощью спецификаторов формата. Предварительно отформатированное содержимое строки strformat копируется в строку stringptr, размер копируемой строки ограничивается по количеству символов в параметре maxnum.

Параметры:

• stringptr
  Указатель на массив назначения, где в результате будет храниться скопированная Си-строка.
• maxnum
  Максимальное количество символов для копирования в stringptr.
• strformat
  Cи-строка, содержащая любую комбинацию из обычных символов и специальных спецификаторов формата. Эти спецификаторы формата заменяются на соответствующие значения даты и времени, указанных в timeptr. Все спецификаторы начинаются с процента %. Список спецификаторов формата показан ниже, в таблице:

• timeptr
  Указатель на структуру tm, которая содержит календарное время.

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

Если размер копируемой Cи-строки меньше или равен значению в maxnum, включая завершающий нулевой символ, то функция вернет общее количество копируемых символов (не учитывая завершающий нуль-символ). В противном случае возвращается ноль и содержимое строки не определено.

Пример: исходный код программы

//пример использования функции strftime
#include <iostream>
#include <ctime>

int main()
{
  time_t rawtime;
  struct tm * timeinfo;
  char buffer [80];                                // строка, в которой будет храниться текущее время

  time ( &rawtime );                               // текущая дата в секундах
  timeinfo = localtime ( &rawtime );               // текущее локальное время, представленное в структуре

  strftime (buffer,80,"Сейчас %I:%M%p.",timeinfo); // форматируем строку времени
  std::cout << buffer << std::endl;

  return 0;
}

Пример работы программы