Reference
C Library
IOstream Library
Strings library
STL Containers
STL Algorithms
Miscellaneous
C Library
cassert (assert.h)
cctype (ctype.h)
cerrno (errno.h)
cfloat (float.h)
ciso646 (iso646.h)
climits (limits.h)
clocale (locale.h)
cmath (math.h)
csetjmp (setjmp.h)
csignal (signal.h)
cstdarg (stdarg.h)
cstddef (stddef.h)
cstdio (stdio.h)
cstdlib (stdlib.h)
cstring (string.h)
ctime (time.h)
ctime (time.h)
functions:
asctime
clock
ctime
difftime
gmtime
localtime
mktime
strftime
time
macros:
CLOCKS_PER_SEC
NULL
types:
clock_t
size_t
time_t
struct tm


ctime

function
<ctime>
char * ctime ( const time_t * timer );

Convert time_t value to string

Converts the time_t object pointed by timer to a C string containing a human-readable version of the corresponding local time and date.

The returned string has the following format:

Www Mmm dd hh:mm:ss yyyy
Where Www is the weekday, Mmm the month in letters, dd the day of the month, hh:mm:ss the time, and yyyy the year.

The string is followed by a new-line character ('\n') and the terminating null-character.

This function is equivalent to: asctime(localtime(timer)).

Parameters

timer
Pointer to a time_t object that contains a calendar time.

Return Value

A C string containing the date and time information in a human-readable format.

The array which holds this string is statically allocated and shared by both the ctime and asctime functions. Each time either one of these functions is called the content of this array is overwritten.

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
 
/* ctime example */
#include <stdio.h>
#include <time.h>
int main ()
{
  time_t rawtime;
  time ( &rawtime );
  printf ( "The current local time is: %s", ctime (&rawtime) );
  
  return 0;
}


Output:

The current local time is: Sat May 20 15:21:51 2000

See also

asctime Convert tm structure to string (function)
gmtime Convert time_t to tm as UTC time (function)
localtime Convert time_t to tm as local time (function)
time Get current time (function)