FHIR Chat · Date search precision · argonaut

Stream: argonaut

Topic: Date search precision

view this post on Zulip Yunwei Wang (Mar 25 2022 at 15:34):

In US Core General Guidance, Section "Date Precision Expectations" states that:

"The client SHALL provide values precise to the day for elements of datatype date and to the second + time offset for elements of datatype dateTime."

Here, is the datatype of the search parameter or is datatype of the element.

For example, US Core Immunization has

  • element occurrenceDateTime which has datatype dateTime
  • search parameter date which has datatype date

What is the precision that client should send?

view this post on Zulip Eric Haas (Mar 25 2022 at 16:18):

for clients this is about search expectations there is no write in US Core

view this post on Zulip Yunwei Wang (Mar 25 2022 at 16:21):

@Eric Haas My question is about searching date precision. The requirement is from http://hl7.org/fhir/us/core/STU4/general-guidance.html#date-precision-expectations

view this post on Zulip Eric Haas (Mar 25 2022 at 16:28):

I thought that was the question

view this post on Zulip Eric Haas (Mar 25 2022 at 16:29):

the search parameter precision

view this post on Zulip Yunwei Wang (Mar 25 2022 at 16:30):

For example, I know there is a Immunization record with occurenceDateTime='2022-03-25'. To form a search, should I say

  • date=2022-03-25 because the search parameter has a type date, or
  • date=2022-03-25T00:00:00+00:00 because the element has a type dateTime

view this post on Zulip Eric Haas (Mar 25 2022 at 16:31):

The intent was the latter. I believe you and Rob were involved in these clarifications. We can look back at the trackers if we need to.

view this post on Zulip Yunwei Wang (Mar 25 2022 at 16:34):

Yes but I cannot remember which dataType is used here. That latter causes a little bit problem. If a client want to search Immunization record for 2022-03-25, it has to use comparators: date=gt2022-03-25T00:00:00+00:00 and date=lt2022-03-26T00:00:00+00:00. Let me check our old conversation.

view this post on Zulip Yunwei Wang (Mar 25 2022 at 16:46):

I read through this thread: https://chat.fhir.org/#narrow/stream/179175-argonaut/topic/FHIR-27906.20.3A.20search.20by.20date but still not sure which the datatype is. It kindly feels like the datatype of the element because it mentioned client burden.

Last updated: Apr 12 2022 at 19:14 UTC


An HL7 Website -