]>
git.madduck.net Git - etc/awesome.git/blobdiff - doc/tzinfo.md
madduck's git repository
Every one of the projects in this repository is available at the canonical
URL git://git.madduck.net/madduck/pub/<projectpath> — see
each project's metadata for the exact URL.
All patches and comments are welcome. Please squash your changes to logical
commits before using git-format-patch and git-send-email to
patches@ git. madduck. net .
If you'd read over the Git project's submission guidelines and adhered to them,
I'd be especially grateful.
SSH access, as well as push access can be individually
arranged .
If you use my repositories frequently, consider adding the following
snippet to ~/.gitconfig and using the third clone URL listed for each
project:
[url "git://git.madduck.net/madduck/"]
insteadOf = madduck:
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
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
- `gmtoff` (number) The offset from GMT (UTC) in seconds
- `isdst` (boolean): If this change was declared as daylight savings
- `isstd` (boolean)
- `isgmt` (boolean)
- `isstd` (boolean)
- `isgmt` (boolean)
-## `:find_current ( utc_ts )`
-Returns the relevant `info` table at the given utc timestamp for the given UTC timestamp.
+### `:find_current ( utc_ts )`
+
+Returns the relevant `tt_info` object for the given UTC timestamp in the timezone.
-## `:localise ( utc_ts )` and `: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.
Convert the given UTC timestamp to the timezone.
Returns the number of seconds since unix epoch in the given timezone.
-## `:utctime ( local_ts )`
+### `:utctime ( local_ts )`
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.
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.
projects / etc / awesome.git / blobdiff