localtime - Convert Time

Syntax

#include <time.h>
struct tm *localtime(const time_t *timeval);

localtime breaks down timeval, corrects for the local time zone and Daylight Saving Time, if appropriate, and stores the corrected time in a structure of type tm. See gmtime for a description of the fields in a tm structure.

The time value is usually obtained by a call to the time function.

Note:

gmtime and localtime may use a common, statically allocated buffer for the conversion. Each call to one of these functions may alter the result of the previous call.
The time and date functions begin at 00:00:00 Coordinated Universal Time, January 1, 1970.

localtime returns a pointer to the structure result. If unsuccessful, it returns NULL.

This example queries the system clock and displays the local time.

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

int main(void)
{
   struct tm *newtime;
   time_t ltime;

   time(&ltime);
   newtime = localtime(&ltime);
   printf("The date and time is %s", asctime(newtime));
   return 0;

   /****************************************************************************
      The output should be similar to:

      The date and time is Wed Oct 31 15:00:00 1995
   ****************************************************************************/
}

[Back: localeconv - Retrieve Information from the Environment]

[Next: log - Calculate Natural Logarithm]