Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

WIP: added text allowing "Z" for timezone offset. #586

Open
wants to merge 6 commits into
base: main
Choose a base branch
from
Open
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion ch04.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -254,7 +254,7 @@ In a time zone with zero offset, time (approximately) equals mean solar time for
If both time and time zone offset are omitted the time is 00:00:00 (the beginning of the day i.e. midnight at 0 `degrees_east`).
Thus, **`units = "days since 1990-1-1"`** means the same as **`units = "days since 1990-1-1 0:0:0"`**.

The time zone offset _Z_ must be in one of the following four formats, any of which may be prefixed with a sign:
The time zone offset _Z_ must be the letter `Z` or a value in one of the following four formats, any of which may be prefixed with a sign:

** _H_, the hour alone, of one or two digits e.g. **`-6`**, **`2`**, **`+11`**, which is sufficient for many time zones.

Expand All @@ -264,6 +264,10 @@ The time zone offset _Z_ must be in one of the following four formats, any of wh

** three digits, of which the first is the hour (0--9) e.g. **`530`**.

A `Z` indicates a zero offset, sometimes referred to as "Zulu time".

While the default (unspecified) is an offset of zero, it is recommended that a zero (or `Z`) be used for zero offset to avoid any ambiguity.

For example, **`seconds since 1992-10-8 15:15:42.5 -6:00`** indicates seconds since October 8th, 1992 at 3 hours, 15 minutes and 42.5 seconds in the afternoon, in a time zone where the datetime is six hours behind the default.
Subtracting the time zone offset from a given datetime converts it to the equivalent datetime with zero time zone offset e.g. **`1989-12-31 18:00:00 -6`** identifies the same instant as **`1990-1-1 0:0:0`**.

Expand Down
Loading