localtime [C++ Reference]
Keywords: c,date,localtime
Date: 2008-10-17T07:01:25-0700

## localtime

Syntax:

        #include <ctime>
        struct tm *localtime( const time_t *time );

The function localtime() converts calendar time `time` into local time.

The struct that is returned is statically allocated, and should not be deleted.

For example, the following code uses several of the time-related functions to display the current time:

      time_t theTime;
      time( &theTime );   // get the calendar time
      tm *t = localtime( &theTime );  // convert to local
      cout << "The time is: " << asctime(t);

The above code might display this output:

      The time is: Fri Oct 17 08:54:41 2008

Related Topics: asctime, ctime, difftime, gmtime, strftime, time