Click above to get retro games delivered to your door ever month!

   strftime

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

   Description
   This function is NOT part of String_package.

   The strftime function inserts characters into the the array pointed to
   by s following instructions in the format string. The format should be
   a  multibyte character sequence, beginning and ending in  its  initial
   shift  state.  The format string consists of zero or  more  conversion
   specifications as well as ordinary multibyte characters. A  conversion
   specification  consists of a % character followed by a character  that
   determines  the  conversion  to be  applied.  All  ordinary  multibyte
   characters  (including  the  terminating null  character)  are  copied
   unchanged  into  the array. However, no more than max  characters  are
   placed  into the array. Each conversion specification is  replaced  by
   appropriate  characters  as  described  in  the  following  list.  The
   appropriate  characters are determined by the program's locale and  by
   the values contained in the structure pointed to by timeptr.

   %a        is replaced by the locale's abbreviated weekday name.
   %A        is replaced by the locale's full weekday name.
   %b        is replaced by the locale's abbreviated month name.
   %B        is replaced by the locale's full month name.
   %c        is  replaced  by  the locales  appropriate  date  and  time
             representation.
   %d        is replaced by the day of the month as a decimal number (01-
             31).
   %H        is replaced by the hour (24-hour clock) as a decimal  number
             (00-23).
   %I        is replaced by the hour (12-hour clock) as a decimal  number
             (00-12).
   %J        is replaced by the day of the year as a decimal number (001-
             366).
   %m        is replaced by the month as a decimal number (01-12).
   %M        is replaced by the minute as a decimal number (00-59).
   %P        is replaced by the locale's equivalent of either AM or PM
   %S        is replaced by the second as a decimal number (00-60).
   %U        is  replaced by the week number of the  year,  with  Sunday
             taken as the first day of the week, as a decimal number (00-
             53).
   %w        is replaced by the weekday as a decimal number  (0(Sunday)-
             6).
   %W        is  replaced by the week number of the  year,  with  Monday
             taken as the first day of the week, as a decimal number (00-
             53).
   %x        is replaced by the locale's appropriate date representation.
   %X        is replaced by the locale's appropriate time representation.
   %y        is  replaced  by the year (without century)  as  a  decimal
             number (00-99).
   %Y        is replaced by the year (with century) as a decimal number.
   %Z        is replaced by the time zone name or by no characters if  no
             time zone is determinable.
   %%        is replaced by %

   The strftime function should not be used to copy between objects  that
   overlap, it does not handle overlapping moves correctly.

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

   main()
   {
   char buf[80];
   struct tm *tp;
   time_t newtime;

        time(&newtime);
        tp = localtime(&newtime);
        strftime(buf, sizeof(buf), "%A, %B %d", tp);
        puts(buf);
   }

   Return Value
   strftime returns the number of characters placed in the array  pointed
   to  by s, not including the terminating null character. If  the  total
   number  of  resulting  characters,  including  the  terminating   null
   character  is greater than max, zero is returned, and the contents  of
   the array will be invalid.