X-Git-Url: https://git.madduck.net/etc/awesome.git/blobdiff_plain/1babb91d01dd2c4c4990fe5d4c19ffb454849a60..c9eb90f7079172d62c2def3155015dac56558029:/doc/tzinfo.md diff --git a/doc/tzinfo.md b/doc/tzinfo.md index d989102..d4791e2 100644 --- a/doc/tzinfo.md +++ b/doc/tzinfo.md @@ -1,4 +1,4 @@ -# `luatz.tzinfo` +## `luatz.tzinfo` {#tzinfo} Provides a metatable for the timezone class. @@ -13,7 +13,10 @@ so the following details can be skipped over. The table contains a sequence of tables that describe the timezone at a given point using a `transition_time`: the unix timestamp (in UTC) that this definition starts, and -a `info` table, which contains information about the change at that point: +a `tt_info` object. + +A `tt_info` object contains information about a time offset; +and contains the following fields: - `gmtoff` (number) The offset from GMT (UTC) in seconds - `isdst` (boolean): If this change was declared as daylight savings @@ -22,18 +25,19 @@ a `info` table, which contains information about the change at that point: - `isstd` (boolean) - `isgmt` (boolean) -## `:find_current ( utc_ts )` -Returns the relevant `info` table at the given utc timestamp for the given UTC timestamp. +### `tzinfo:find_current(utc_ts)` {#tzinfo:find_current} + +Returns the relevant `tt_info` object for the given UTC timestamp in the timezone. -## `:localize ( utc_ts )` +### `tzinfo:localise(utc_ts)` and `tzinfo:localize(utc_ts)` {#tzinfo:localise} Convert the given UTC timestamp to the timezone. Returns the number of seconds since unix epoch in the given timezone. -## `:utctime ( local_ts )` +### `tzinfo:utctime(local_ts)` {#tzinfo:utctime} Convert the given local timestamp (seconds since unix epoch in the time zone) to a UTC timestamp. This may result in ambigous results, in which case multiple values are returned.