Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • UTC offset provided with value. If the TS value includes an offset from UTC (as permitted by the HL7 specification in +/-ZZZZ format) then PKB will interpret the TS value as being in the specified offset from UTC. PKB recommends that a UTC offset is provided with each value. The meaning is clear, unambiguous and prevents any confusion.

  • UTC offset provided with MSH-7. In accordance with the HL7 specification, if an offset from UTC is not provided with a TS value, but an offset from UTC was provided withMSH-7, then the offset in MSH-7 will be used as a default for the message. Although this option is permitted by the HL7 specification, we do not recommend the approach, because it is unlikely that the offset in which the message was sent is the same offset that should be applied to all TS values within the message. By way of example, consider an S12 message sent before daylight savings come into effect, for an appointment scheduled to occur after daylight savings have come into effect.

  • Interface default time zone. It is possible to configure an interface default time zone in which PKB will process any TS values that neither include an offset from UTC, nor were provided in a message for which MSH-7 had an offset from UTC. Note: it is only possible to configure a time zone (e.g. "Europe/London"), not an offset from UTC. This can be an easy way to get a connection working, but the limitation of this approach is that your HL7 messages will no longer be self-describing. That is, it is not possible to know how PKB will interpret a TS value within a given message unless you also know the currently configured interface default time zone. This is not a problem per se, but you should be aware that this makes auditing and debugging slightly more difficult. An interface default time zone is not configured for your interface unless specifically agreed. There is no default interface default time zone. Note also that the default is applied at the level of the PKB Organisation, it is not possible to configure different defaults for different PKB Teams.

  • Global default time zone. If none of the 3 options above apply, the TS value is assumed to have been provided in UTC.

...

PKB does not store the original time zone/offset in which a TS value is provided. As such, it is not possible to request to see a TS value in the original localisation. Please get in touch if this is a feature you think would be helpful.

Date and time of birth

PID-7 is the HL7 location for providing the date and time of birth of a patient. It is a little unusual, so we've given it a section of its own here.

Since PID-7 is a TS value, it is capable of representing an explicit point in time. This point in time is the patient's time of birth, but PKB does not store this value. There is no "time of birth" attribute on a[[Patient]].

However, PKB does capture a "date of birth". A patient's date of birth is the name of the date on which the patient was born according to the time zone in which they were born. Counter-intuitively, knowing the absolute point in time at which a patient is born is not sufficient to deduce their date of birth. By way of example, imagine you know a person is born right now, as you are reading this. You cannot know their birthday unless you also know where they were born (or more accurately, in which time zone they were born) since the name of the date is dependent upon their location relative to the international date line.

...