From: Paul Eggert <eggert@cs.ucla.edu>
To: "A.C." <achirvasub@gmail.com>
Cc: 37974@debbugs.gnu.org
Subject: bug#37974: eww produces "error in process filter: Specified time is not representable"
Date: Fri, 1 Nov 2019 16:22:58 -0700 [thread overview]
Message-ID: <36cdeda8-7636-ef1b-8f3a-4b4bf21a1117@cs.ucla.edu> (raw)
In-Reply-To: <e31b13c3-a3cf-e90b-fd69-aa9a21991472@cs.ucla.edu>
[-- Attachment #1: Type: text/plain, Size: 273 bytes --]
On 11/1/19 1:05 AM, Paul Eggert wrote:
> That's due to operating system limits, and is not eww's fault per se.
That being said, this bug report suggests that the issue of OS limits on
timestamps should be documented better. I installed the attached to try
to do that.
[-- Attachment #2: 0001-Document-limits-on-some-time-conversion-functions.patch --]
[-- Type: text/x-patch, Size: 5591 bytes --]
From feb7e22ed4598baacf08378f2208caba0d214e97 Mon Sep 17 00:00:00 2001
From: Paul Eggert <eggert@cs.ucla.edu>
Date: Fri, 1 Nov 2019 16:13:31 -0700
Subject: [PATCH] Document limits on some time-conversion functions
* doc/lispref/os.texi (Time of Day, Time Zone Rules)
(Time Conversion, Time Parsing, Time Calculations):
Document functions that limit the range of time values
due to OS limits (Bug#37974).
---
doc/lispref/os.texi | 32 ++++++++++++++++++++++----------
1 file changed, 22 insertions(+), 10 deletions(-)
diff --git a/doc/lispref/os.texi b/doc/lispref/os.texi
index d8d0ad7206..d3ddee251b 100644
--- a/doc/lispref/os.texi
+++ b/doc/lispref/os.texi
@@ -1307,7 +1307,14 @@ Time of Day
time, a single floating-point number for seconds, or a list
@code{(@var{high} @var{low} @var{micro})} or @code{(@var{high}
@var{low})} that is a truncated list timestamp with missing elements
-taken to be zero. You can convert a time value into
+taken to be zero.
+
+Time values can be converted to and from calendrical and other forms.
+Some of these conversions rely on operating system functions that
+limit the range of possible time values, and signal an error if the
+limits are exceeded. For instance, a system may not support years
+before 1970, or years before 1901, or years far in the future.
+You can convert a time value into
a human-readable string using @code{format-time-string}, into a Lisp
timestamp using @code{time-convert}, and into other forms using
@code{decode-time} and @code{float-time}. These functions are
@@ -1328,11 +1335,12 @@ Time of Day
The argument @var{time}, if given, specifies a time to format,
instead of the current time. The optional argument @var{zone}
defaults to the current time zone rule. @xref{Time Zone Rules}.
+The operating system limits the range of time and zone values.
@example
@group
(current-time-string)
- @result{} "Wed Oct 14 22:21:05 1987"
+ @result{} "Fri Nov @ 1 15:59:49 2019"
@end group
@end example
@end defun
@@ -1416,6 +1424,7 @@ Time Zone Rules
The argument @var{time}, if given, specifies a time value to
analyze instead of the current time. The optional argument @var{zone}
defaults to the current time zone rule.
+The operating system limits the range of time and zone values.
@end defun
@node Time Conversion
@@ -1498,6 +1507,8 @@ Time Conversion
This function converts a time value into calendrical information. If
you don't specify @var{time}, it decodes the current time, and similarly
@var{zone} defaults to the current time zone rule. @xref{Time Zone Rules}.
+The operating system limits the range of time and zone values.
+
The @var{form} argument controls the form of the returned
@var{seconds} element, as described below.
The return value is a list of nine elements, as follows:
@@ -1631,6 +1642,7 @@ Time Conversion
Year numbers less than 100 are not treated specially. If you want them
to stand for years above 1900, or years above 2000, you must alter them
yourself before you call @code{encode-time}.
+The operating system limits the range of time values.
The @code{encode-time} function acts as a rough inverse to
@code{decode-time}. For example, you can pass the output of
@@ -1643,11 +1655,6 @@ Time Conversion
You can perform simple date arithmetic by using out-of-range values for
@var{seconds}, @var{minutes}, @var{hour}, @var{day}, and @var{month};
for example, day 0 means the day preceding the given month.
-
-The operating system puts limits on the range of possible time values;
-if the limits are exceeded while encoding the time, an error results.
-For instance, years before 1970 do not work on some systems;
-on others, years as early as 1901 do work.
@end defun
@node Time Parsing
@@ -1666,6 +1673,7 @@ Time Parsing
a date-time, and should be in one of the forms recognized by
@code{parse-time-string} (see below). This function assumes the GMT
timezone if @var{string} lacks an explicit timezone information.
+The operating system limits the range of time values.
@end defun
@defun parse-time-string string
@@ -1847,10 +1855,12 @@ Time Parsing
This function uses the C library function @code{strftime}
(@pxref{Formatting Calendar Time,,, libc, The GNU C Library Reference
Manual}) to do most of the work. In order to communicate with that
-function, it first encodes its argument using the coding system
+function, it first converts @var{time} and @var{zone} to internal form;
+the operating system limits the range of time and zone values.
+This function also encodes @var{format-string} using the coding system
specified by @code{locale-coding-system} (@pxref{Locales}); after
@code{strftime} returns the resulting string,
-@code{format-time-string} decodes the string using that same coding
+this function decodes the string using that same coding
system.
@end defun
@@ -1990,10 +2000,12 @@ Time Calculations
@defun time-to-days time-value
This function returns the number of days between the beginning of year
1 and @var{time-value}.
+The operating system limits the range of time values.
@end defun
@defun time-to-day-in-year time-value
This returns the day number within the year corresponding to @var{time-value}.
+The operating system limits the range of time values.
@end defun
@defun date-leap-year-p year
@@ -2002,7 +2014,7 @@ Time Calculations
@defun date-days-in-month year month
Return the number of days in @var{month} in @var{year}. For instance,
-there's 29 days in February 2004.
+February 2020 has 29 days.
@end defun
@defun date-ordinal-to-time year ordinal
--
2.23.0
next prev parent reply other threads:[~2019-11-01 23:22 UTC|newest]
Thread overview: 16+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-10-29 0:32 bug#37974: eww produces "error in process filter: Specified time is not representable" Stuart Little
2019-10-29 4:51 ` Stuart Little
2019-10-29 10:25 ` Stuart Little
2019-10-29 12:05 ` A.C.
2019-10-29 12:47 ` Lars Ingebrigtsen
2019-10-29 14:06 ` A.C.
2019-10-29 14:41 ` A.C.
2019-10-29 21:52 ` Lars Ingebrigtsen
2019-10-29 22:23 ` A.C.
2019-10-30 10:19 ` Colin Baxter
2019-10-30 11:01 ` Lars Ingebrigtsen
2019-10-31 18:50 ` A.C.
2019-11-01 13:46 ` Lars Ingebrigtsen
2019-11-01 8:05 ` Paul Eggert
2019-11-01 23:22 ` Paul Eggert [this message]
2019-11-02 7:34 ` Eli Zaretskii
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=36cdeda8-7636-ef1b-8f3a-4b4bf21a1117@cs.ucla.edu \
--to=eggert@cs.ucla.edu \
--cc=37974@debbugs.gnu.org \
--cc=achirvasub@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.