time: respect gmtoff in calculating numeric time.

We have the following problem. On some platforms, the broken-down
C time structure "struct tm" has a GMT offset field which
gives the time zone of the specified time. In the Lisp
structure, we call the corresponding slot gmtoff.

This value should be taken into account when converting
the broken-down time to a numeric time value.

The underlying platform functions like mktime don't do this;
they not only ignore the gmtoff, but in some cases clobber
the field.

The GNU C library version of the POSIX strptime function
supports "%z" and "%Z" specifiers which populate the GMT
offset. But then it gets wrongly ignored.

Old/wrong behavior:

  1> (time-parse-utc "%H:%M:%z" "00:00:+0900")
  0

New behavior (on platforms with the GMT offset):

  1> (time-parse-utc "%H:%M:%z" "00:00:+0900")
  32400

* time.c (time_meth): If the Lisp time structure we are given
specifies a non-nil gmtoff, then add its value
to the returned result.
(time_parse_local, time_parse_utc): If struct tm has a
GMT offset, then we add its value to the time_t returned
by mktime, timegm or timegm_hack.

* txr.1: Updated.

1 files changed, 22 insertions, 0 deletions

diff --git a/txr.1 b/txr.1
index 5133dde9..66016541 100644
--- a/txr.1
+++ b/txr.1
@@ -66896,6 +66896,22 @@ Note: the availability of these three functions
 depends on the availability of
 .codn strptime .
 
+Note: on some platforms, like the GNU C Library, the
+.code strptime
+function supports the parsing of numeric and symbolic time zones. The
+.code gmtoff
+slot of the structure ends up being set accordingly.
+The
+.code time-local
+and
+.code time-utc
+functions take the
+.code gmtoff
+field into account, adjusting the returned time accordingly.
+
+
+If these are specified.
+
 .coNP Methods @ time-local and @ time-utc
 .synb
 .mets << time-struct .(time-local)
@@ -66931,6 +66947,12 @@ which are applied to
 or
 .codn make-time-utc .
 
+Note: if the
+.code gmtoff
+slot is not
+.codn nil ,
+its value is added to the returned result.
+
 .coNP Method @ time-string
 .synb
 .mets << time-struct .(time-string << format )