X-Git-Url: https://git.madduck.net/etc/awesome.git/blobdiff_plain/1babb91d01dd2c4c4990fe5d4c19ffb454849a60..6c4658848c01ae0862a2fcad7f6565efd9aa948d:/doc/tzinfo.md?ds=sidebyside diff --git a/doc/tzinfo.md b/doc/tzinfo.md index d989102..78d0453 100644 --- a/doc/tzinfo.md +++ b/doc/tzinfo.md @@ -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,12 +25,13 @@ 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. +Returns the relevant `tt_info` object for the given UTC timestamp in the timezone. -## `:localize ( utc_ts )` +## `:localise ( utc_ts )` and `:localize ( utc_ts )` Convert the given UTC timestamp to the timezone. Returns the number of seconds since unix epoch in the given timezone.