Format
#include <time.h>
struct tm *localtime64_r(const time64_t *timeval, struct tm *result);
Language Level: ILE C Extension
Threadsafe: Yes.
Locale Sensitive: The behavior of this function might be affected by the LC_TOD category of the current locale.
Description
This function is the restartable version of localtime64(). It is the same as localtime64() except that it passes in the place to store the returned structure result.
Return Value
The localtime64_r() function returns a pointer to the structure result. If the given timeval is out of range, a NULL pointer is returned and errno is set to EOVERFLOW.
Example that uses localtime64_r()
This example queries the system clock and displays the local time.
#include <stdio.h>
#include <time.h>
int main(void)
{
struct tm newtime;
time64_t ltime;
char buf[50];
ltime = time64(<ime);
localtime64_r(<ime, &newtime);
printf("The date and time is %s\n", asctime_r(&newtime, buf));
}
/************** If the local time is 3 p.m. February 15, 2008, **********
************************* the output should be: *********************
The date and time is Fri Feb 15 15:00:00 2008
*/
Related Information