> Adrian wrote:
>
>> Bryn wrote:
>>
>> I found my way to this by guesswork and good luck. (I happen to be using PG
>> Version 13.5. But I don't suppose that this matters.)… But I can't formulate
>> a search that finds it using the doc site's intrinsic search.
>
> Where exactly did you search? When I tried in either the overall site or doc
> site search with 'tsrange()' it offered :
>
> https://www.google.com/url?q=https://www.postgresql.org/docs/14/rangetypes.html&source=gmail-imap&ust=1635222336000000&usg=AOvVaw0uLLwEWap7ttpvbTC1bEb8
>
> as the first choice. This encompasses the link David G. Johnston posted.
Yes, I did find that page, too. I see now that I should have search for
"construct" or simply noticed "Constructing Ranges" in the page's ToC.
But I got to where I was with "\df tsrange" because there's usually a
system-defined function for every typecast. When I saw there there was a
three-argument overload I guessed that the text arg might accept '[)' and so
on. So I tried to find the doc for the tsrange() function.
I could've searched in the page for '[)' — but I'm afraid that it didn't occur
to me.
Or I might have read enough to find this
… constructor function with the same name as the range type… the three-argument
form constructs a range with bounds of the form specified by the third
argument. The third argument must be one of the strings “()”, “(]”, “[)”, or
“[]”.
But I searched only for "tsrange". This gave me no relevant hit. And that's
when I lost patience.
By the way, I was surprised when I tried this:
with c as (
select
'2000-01-01'::timestamp as t1,
'2000-01-10'::timestamp as t2,
'2000-01-20'::timestamp as t3)
select
( tsrange(t1, t3, '[)') && tsrange(t2, t2, '[)') )::text as "range result",
( (t1, t3) overlaps (t2, t2) )::text as "overlaps result"
from c;
and got this:
range result | overlaps result
--------------+-----------------
false | true
I can't find anything, neither on the page in question here on Range Types nor
in the doc on the overlaps operator, about the semantics for when a duration
collapses to an instant. Am I missing this too?
It seems to me that overlaps" does it right (also in all the other scenarios
like instant at the start of a duration, instant at the end of a duration, and
two coinciding instants. And it seems, therefore, that && does it wrong. (It
always gives false when at least one of the durations is an instant.)
What's the rationale for this asymmetry in semantics?