C Reference function strftime()

Usage of strftime():

size_t strftime ( char * ptr_dest, size_t maxsize, const char * format, const struct tm * ptr_time );

Parameters:

ptr_dest is a pointer to the destination array where the resulting C string is copied too.

The maxsize contains the maximum number of characters to be copied to ptr_dest.

ptr_time is a pointer to a tm structure that contains a calendar time.

Format contains a C string with any combination of regular characters and special format commands.
These format commands are replaced by the function to the corresponding values to represent the time specified in ptr_time.
They all begin with a percentage (%) sign. Take a look at the following table:

* Are locale-dependent.

Note: some compilers may contain additional commands.

Return Value:

If the resulting C string fits in less than maxsize characters (including the terminating null-character) the total
number of characters copied to ptr_dest (not including the terminating null-character) is returned.

If it doesn’t fit, then zero will be returned. If this happens then the contents of the array is on determinate.

Explanation:

Copies into ptr_dest the content of format, expanding its format tags into the corresponding values as
specified by ptr_time, with a limit of maxsize characters.

Source code example of strftime():

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

	int main ()
	{
		time_t time_raw_format;
		struct tm * time_struct;

		char buf [100];

		time ( &time_raw_format );
		time_struct = localtime ( &time_raw_format );

		strftime (buf,100,"It is now: %I:%M%p.",time_struct);
		puts (buf);

		return 0;
	}

Output example of the program above:

	It is now: 02:45PM.