localtime


function
<ctime> 
struct tm * localtime ( const time_t * timer );

Convert time_t to tm as local time

Uses the time pointed by timer to fill a tm structure with the values that represent the corresponding local time.

Parameters

timer
Pointer to a time_t value representing a calendar time (see time_t).


Return Value

A pointer to a tm structure with the time information filled in.

This structure is statically allocated and shared by the functions gmtime and localtime. Each time either one of these functions is called the content of this structure is overwritten.

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
 
/* localtime example */
#include <stdio.h>
#include <time.h>

int main ()
{
  time_t rawtime;
  struct tm * timeinfo;

  time ( &rawtime );
  timeinfo = localtime ( &rawtime );
  printf ( "Current local time and date: %s", asctime (timeinfo) );
  
  return 0;
}


Output:

Current local time and date: Sat May 20 17:36:17 2000


See also

asctime Convert tm structure to string (function)
ctime Convert time_t value to string (function)
gmtime Convert time_t to tm as UTC time (function)
mktime Convert tm structure to time_t (function)
time Get current time (function)