strftime - Convert to Formatted Time

Syntax

#include <time.h>
size_t strftime(char *dest, size_t maxsize,
                const char *format, const struct tm *timeptr);

strftime converts the time and date specification in the timeptr structure into a character string. It then stores the null-terminated string in the array pointed to by dest according to the format string pointed to by format. maxsize specifies the maximum number of bytes that can be copied into the array.

The format string is a multibyte character string containing:

Conversion specification characters, preceded by a % sign.
Ordinary multibyte characters, which are copied into the array unchanged.

If data has the form of a conversion specifier, but is not one of the accepted specifiers, the characters following the % are copied to the output.

The characters that are converted are determined by the LC_TIME category of the current locale and by the values in the time structure pointed to by timeptr. The time structure pointed to by timeptr is usually obtained by calling the gmtime or localtime function.

When objects to be copied overlap, the behavior is undefined.

The following table lists the strftime conversion specifiers: кФФФФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФПГSpecifier ГMeaning Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %a Г Replace with abbreviated weekday name from locale. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %A Г Replace with full weekday name from locale. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %b Г Replace with abbreviated month name from locale. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %B Г Replace with full month name from locale. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %c Г Replace with date and time from locale. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %C Г Replace with locale's century number (year divided Г
Г Г by 100 and truncated) Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %d Г Replace with day of the month as a decimal number Г
Г Г (01-31). Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %D Г Insert date in mm/dd/yy form, regardless of locale. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %e Г Insert day of the month as a decimal number Г
Г Г (" 1"-"31"). A space precedes a single digit. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %Ec Г Replace with the locale's alternative date and time Г
Г Г representation. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %EC Г Replace with the name of the base year (period) in Г
Г Г the locale's alternate representation. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %Ex Г Replace with the locale's alternative date represen- Г
Г Г tation. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %EX Г Replace with the locale's alternative time represen- Г
Г Г tation. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %Ey Г Replace with the offset from %EC (year only) in the Г
Г Г locale's alternate representation. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %EY Г Replace with the full alternative year represen- Г
Г Г tation. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %h Г Replace with locale's abbreviated month name. This Г
Г Г is the same as %b. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %H Г Replace with hour (24-hour clock) as a decimal Г
Г Г number (00-23). Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %I Г Replace with hour (12-hour clock) as a decimal Г
Г Г number (01-12). Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %j Г Replace with day of the year as a decimal number Г
Г Г (001-366). Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %m Г Replace with month as a decimal number (01-12). Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %M Г Replace with minute as a decimal number (00-59). Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %n Г Replace with a newline character. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %Od Г Replace with the day of month, using the locale's Г
Г Г alternative numeric symbols, filled as needed with Г
Г Г leading zeroes if there is any alternative symbol Г
Г Г for zero; otherwise fill with leading spaces. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %Oe Г Replace with the day of the month, using the Г
Г Г locale's alternative numeric symbols, filled as Г
Г Г needed with leading spaces. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %OH Г Replace with the hour (24-hour clock), using the Г
Г Г locale's alternative numeric symbols. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %OI Г Replace with the hour (12-hour clock), using the Г
Г Г locale's alternative numeric symbols. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %Om Г Replace with the month, using the locale's alterna- Г
Г Г tive numeric symbols. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %OM Г Replace with the minutes, using the locale's alter- Г
Г Г native numeric symbols. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %OS Г Replace with the seconds, using the locale's alter- Г
Г Г native numeric symbols. Г
РФФФФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй
кФФФФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФП
Г %Ou Г Replace with the weekday as a decimal number (1 to Г
Г Г 7), with 1 representing Monday, using the locale's Г
Г Г alternative numeric symbols. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %OU Г Replace with the week number of the year (00-53), Г
Г Г where Sunday is the first day of the week, using the Г
Г Г locale's alternative numeric symbols. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г &OV Г Replace with week number of the year (01-53), where Г
Г Г Sunday is the first day of the week, using the Г
Г Г locale's alternative numeric symbols. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %Ow Г Replace with the weekday (Sunday=0), using the Г
Г Г locale's alternative numeric symbols. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г % OW Г Replace with the week number of the year (01-53), Г
Г Г where Monday is the first day of the week, using the Г
Г Г locale's alternative numeric symbols. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %Oy Г Replace with the year (offset from %C) in the Г
Г Г locale's alternative representation, using the Г
Г Г locale's alternative numeric symbols. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %p Г Replace with the locale's equivalent of AM or PM. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %r Г Replace with a string equivalent to %I:%M:%S %p. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %R Г Replace with time in 24 hour notation (%H:%M) Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %S Г Replace with second as a decimal number (00-61). Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %t Г Replace with a tab. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %T Г Replace with a string equivalent to %H:%M:%S. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %u Г Replace with the weekday as a decimal number (1 to Г
Г Г 7), with 1 representing Monday. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %U Г Replace with week number of the year (00-53), where Г
Г Г Sunday is the first day of the week. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %V Г Replace with week number of the year (01-53), where Г
Г Г Monday is the first day of the week. If the week of Г
Г Г January 1 is four or more days in the new year, it Г
Г Г is week 1; otherwise, it is week 53 of the previous Г
Г Г year and the following week is week 1. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %w Г Replace with weekday (0-6), where Sunday is 0. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %W Г Replace with week number of the year (00-53), where Г
Г Г Monday is the first day of the week. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %x Г Replace with date representation of locale. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %X Г Replace with time representation of locale. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %y Г Replace with year without the century as a decimal Г
Г Г number (00-99). Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %Y Г Replace with year including the century as a decimal Г
Г Г number. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %Z Г Replace with name of time zone, or no characters if Г
Г Г time zone is not available. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %% Г Replace with %. Г
РФФФФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй

For %Z, the tm_isdst flag in the tm structure passed to strftime specifies whether the time zone is standard or Daylight Savings time.

If data has the form of a directive, but is not one of the above, the characters following the % are copied to the output.

If the total number of bytes in the resulting string including the terminating null byte does not exceed maxsize, strftime returns the number of bytes placed into dest, not including the terminating null byte; otherwise, strftime returns 0 and the content of the string is indeterminate.

This example gets the time and date from localtime, calls strftime to format it, and prints the resulting string.

#include <stdio.h>
#include <time.h>

int main(void)
{
   char dest[70];
   int ch;
   time_t temp;
   struct tm *timeptr;

   temp = time(NULL);
   timeptr = localtime(&temp);
   ch = strftime(dest, sizeof(dest)-1, "Today is %A,"" %b %d. \n Time: %I:%M %p"
      , timeptr);
   printf("%d characters placed in string to make: \n \n %s", ch, dest);
   return 0;

   /****************************************************************************
      The output should be similar to:

      41 characters placed in string to make:
       Today is Monday, Sep 16.
       Time: 06:31 pm
   ****************************************************************************/
}

[Back]

[Next]