6.22.7 ctime Function

Converts calendar time to a string representation of local time.

Include

<time.h>

Prototype

char *ctime(const time_t *tod);

Argument

tod
pointer to stored time

Return Value

Returns the address of a string that represents the local time of the parameter passed.

Remarks

This function is equivalent to asctime(localtime(tod)).

Example

See the notes at the beginning of this chapter or section for information on using printf() or scanf() (and other functions reading and writing the stdin or stdout streams) in the example code.

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

int main(void)
{
  time_t whattime;
  struct tm nowtime;

  nowtime.tm_sec = 30;
  nowtime.tm_min = 30;
  nowtime.tm_hour = 2;
  nowtime.tm_mday = 1;
  nowtime.tm_mon = 1;
  nowtime.tm_year = 103;

  whattime = mktime(&nowtime);
  printf("Day and time %s\n", ctime(&whattime));
}

Example Output

Day and time Sat Feb  1 02:30:30 2003