bug#46505: 27.1.91; Having a hard time manipulating a date

[Lars Ingebrigtsen <larsi@gnus.org>]

Damien Cassou <damien@cassou.me> writes:

> Possible improvements:
>
> - make format-time-string accept as 2nd argument the return value of
>   (iso8601-parse "2021-01-20T00:00:00") with a correct year
>
> - make format-time-string accept as 2nd argument the return value of
>   (iso8601-parse "2021-01-20") without sending an "invalid time
>   specification"

format-time-string takes Lisp timestamps as arguments, not decoded time
structures, and I don't think that could change -- the formats are
syntactically ambiguous.

> - restructure the manual to start with a page describing the different
>   time formats used throughout Emacs with a table listing all conversion
>   functions, the kind of input they take and the kind of output they
>   generate and examples for each.

But I've now improved the documentation here to clarify which functions
take and return Lisp timestamps vs. decoded time structures.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no