localtime() function in C++

The localtime() function is defined in the ctime header file. The localtime() function converts the given time since epoch to calendar time which is expressed as local time.

Syntax:

tm* localtime(const time_t* time_ptr);

Parameter: This function accepts a parameter time_ptr which represents the pointer to time_t object.

Return Value: This function returns a pointer to a tm object on success, Otherwise it returns NullPointerException.

Below program illustrate the localtime() function in C++:

Example:-

// c++ program to demonstrate
// example of localtime() function.

#include <bits/stdc++.h>
using namespace std;

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

    // Get the localtime
    tm* tm_local = localtime(&time_ptr);

    cout << "Current local time is = "
         << tm_local->tm_hour << ":"
         << tm_local->tm_min << ":"
         << tm_local->tm_sec;

    return 0;
}

Output:

Current local time is = 10:8:10