feedc0de/esp-idf
1
0
Fork 0
forked from espressif/esp-idf
Code Pull Requests Activity

core-system/newlib: updated docs to reflect that tzset() needs to be called before localtime/mktime()

Browse Source 
According to the posix standard localtime/mktime should use timezone information as though localtime/mktime() calls tzset(),
but this is not the case in older versions of Newlib.

Closes https://github.com/espressif/esp-idf/issues/11455
This commit is contained in:
Marius Vikhammer
2023-05-24 16:13:34 +08:00
parent c25d92074e
commit aab35a2126
1 changed files with 3 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

3
docs/en/api-reference/system/system_time.rst
View File

@@ -75,6 +75,9 @@ If you need to obtain time with one second resolution, use the following method:
time(&now); time(&now);
// Set timezone to China Standard Time // Set timezone to China Standard Time
setenv("TZ", "CST-8", 1); setenv("TZ", "CST-8", 1);
/* According to the posix standard localtime/mktime should use timezone information as though localtime/mktime() calls tzset(),
but this is not the case in older versions of Newlib. We manually call tzset to ensure the timezone info is updated*/
tzset(); tzset();
localtime_r(&now, &timeinfo); localtime_r(&now, &timeinfo);