C++ localtime()

The localtime() function in C++ converts the given time since epoch to calendar time which is expressed as local time.

The localtime() function is defined in <ctime> header file.

localtime() prototype

tm* localtime(const time_t* time_pretr);

The localtime() function takes a pointer of type time_t as its argument and returns a pointer object of structure tm. The value returned by localtime() function is the local time.

Then, the hours, minutes and seconds can be accessed using tm_hour, tm_min and tm_sec respectively.


localtime() Parameters

  • time_ptr: pointer to a time_t object to be converted.

localtime() Return value

  • On success, the localtime() function returns a pointer to a tm object.
  • On failure, a null pointer is returned.

Example: How localtime() function works?

#include <iostream>
#include <ctime>
using namespace std;

int main()
{
	time_t curr_time;
	curr_time = time(NULL);

	tm *tm_local = localtime(&curr_time);
	cout << "Current local time : " << tm_local->tm_hour << ":" << tm_local->tm_min << ":" << tm_local->tm_sec;
	return 0;
}

When you run the program, the output will be:

Current local time : 19:20:14