Method localtime()

Method localtime

mapping(string:int) localtime(int timestamp)

Description

Convert seconds since 00:00:00 UTC, 1 Jan 1970 into components.

Returns

This function returns a mapping with the following components:

`"sec" : int(0..60)`	Seconds over the minute.
`"min" : int(0..59)`	Minutes over the hour.
`"hour" : int(0..23)`	Hour of the day.
`"mday" : int(1..31)`	Day of the month.
`"mon" : int(0..11)`	Month of the year.
`"year" : int(0..)`	Year since 1900.
`"wday" : int(0..6)`	Day of week (0 = Sunday).
`"yday" : int(0..365)`	Day of the year.
`"isdst" : bool`	Is daylight-saving time active.
`"timezone" : int`	Offset from UTC, including daylight-saving time adjustment.

An error is thrown if the localtime(2) call failed on the system. It's platform dependent what time ranges that function can handle, e.g. Windows doesn't handle a negative timestamp.

Note

Prior to Pike 7.5 the field "timezone" was sometimes not present, and was sometimes not adjusted for daylight-saving time.

Note

Timestamps prior to 1970-01-01T00:00:00 (ie negative timestamps) were not supported on NT and AIX prior to Pike 9.0. Note also that dst-handling may be incorrect for such timestamps.