[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: encode-time vs decode-time
From: |
Andy Moreton |
Subject: |
Re: encode-time vs decode-time |
Date: |
Tue, 30 Jul 2019 12:34:54 +0100 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/26.2.90 (windows-nt) |
On Tue 30 Jul 2019, Lars Ingebrigtsen wrote:
> Stefan Monnier <address@hidden> writes:
>
>> I think we should clarify:
>>
>> - "time string", as returned by format-time-string and accepted
>> by parse-time-string.
>>
>> - "decoded time", i.e. a list of the form (SECOND MINUTE HOUR DAY MONTH YEAR
>> IGNORED DST ZONE)
>> I just pushed a patch which defines the `decoded-time` *type*, so we can
>> refer to that precise name in docstrings.
>
> Makes sense.
>
>> - "time counted in seconds" for which we support several representations:
>> a plain number, a list of integers (HIGH LOW USEC PSEC), a pair of
>> integers (NUMERATOR . DENOMINATOR).
>>
>> And part of the confusion for me is that `encode-time` not only encodes
>> time, but can also be used to convert between different representations
>> of "time counted in seconds" (in which case it's not the inverse of
>> decode-time).
>
> Yes, that's something that I think was added by Paul late last year, and
> which I think was a mistake, because it makes things conceptually
> confusing.
>
> I think the stuff to convert between the various "time counted in
> seconds" stuff should be a separate function, because it has nothing to
> do with "decoded time".
It seems that the naming of these functions is unhelpful. They should
clearly distinguish between timestamps (absolute time/date) and
durations (relative intervals) and be named as such.
AndyM
- Support for sub-second time in decoded time, Lars Ingebrigtsen, 2019/07/29
- encode-time vs decode-time, Stefan Monnier, 2019/07/29
- Re: encode-time vs decode-time, Lars Ingebrigtsen, 2019/07/30
- Re: encode-time vs decode-time,
Andy Moreton <=
- Re: encode-time vs decode-time, Lars Ingebrigtsen, 2019/07/30
- Re: encode-time vs decode-time, Paul Eggert, 2019/07/30
- Re: encode-time vs decode-time, Paul Eggert, 2019/07/30
- Re: encode-time vs decode-time, Lars Ingebrigtsen, 2019/07/31
- Re: encode-time vs decode-time, Stefan Monnier, 2019/07/31
Re: Support for sub-second time in decoded time, Eli Zaretskii, 2019/07/29
Re: Support for sub-second time in decoded time, Paul Eggert, 2019/07/29