galjonsfigur 6926c66b16 Polish Lua examples (#2846) 4 years ago
..
README.md d77666c0e8 trailing spaces cleanup (#2659) 5 years ago
alaska.zone c0848ec66f Sample code for timezone handling (#1853) 7 years ago
central.zone c0848ec66f Sample code for timezone handling (#1853) 7 years ago
eastern.zone c0848ec66f Sample code for timezone handling (#1853) 7 years ago
mountain.zone c0848ec66f Sample code for timezone handling (#1853) 7 years ago
pacific.zone c0848ec66f Sample code for timezone handling (#1853) 7 years ago
tz.lua 6926c66b16 Polish Lua examples (#2846) 3 years ago

README.md

tz module

This is a simple module that parses timezone files as found on unix systems. It is oriented around converting the current time. It can convert other times, but it is rather less efficient as it maintains only a single cached entry in memory.

On my linux system, these files can be found in /usr/share/zoneinfo.

tz.setzone()

This sets the timezone to be used in subsequent conversions

Syntax

tz.setzone(timezone)

Parameters

  • timezone this is the timezone string. It must correspond to a file in the file system which is named timezone.zone.

Returns

true if the zone exists in the file system.

tz.getoffset()

This gets the offset (in seconds) of the time passed as the argument.

Syntax

tz.getoffset(time)

Parameters

  • time the number of seconds since the epoch. This is the same value as used by the sntp module.

Returns

  • The number of seconds of offset. West of Greenwich is negative.
  • The start time (in epoch seconds) of this offset.
  • The end time (in epoch seconds) of this offset.

Example

tz = require('tz')
tz.setzone('eastern')
sntp.sync(nil, function(now)
  local tm = rtctime.epoch2cal(now + tz.getoffset(now))
  print(string.format("%04d/%02d/%02d %02d:%02d:%02d", tm["year"], tm["mon"], tm["day"], tm["hour"], tm["min"], tm["sec"]))
end)

tz.getzones()

This returns a list of the available timezones in the file system.

Syntax

tz.getzones()

Returns

A list of timezones.