X-Git-Url: https://git.madduck.net/etc/awesome.git/blobdiff_plain/66d1ace8410db940b6d1c74986626557ef8098ba..c9eb90f7079172d62c2def3155015dac56558029:/doc/tzinfo.md diff --git a/doc/tzinfo.md b/doc/tzinfo.md index 7ae1b55..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. -## `:localise ( utc_ts )` and `: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.