Kernel 8.0 APIs Banner [skip navigation]
Office of Information & Technology (OIT) Banner

$$HL7TFM^XLFDT(): Convert HL7 Date to VA FileMan Date

Reference Type: Supported, Category: Date Functions, Integration Agreement: 10103


This extrinsic function converts an HL7 formatted input date/time into a VA FileMan formatted date/time.



Input Parameters


(required) HL7 formatted date and time.

local_uct: (optional) This parameter controls if any time offset is applied to the time. If a time offset is included, then time offset can be applied to give Local time or Coordinated Universal Time (UTC, a.k.a. GMT, or Greenwich Mean Time) time offset from the MAILMAN TIME ZONE file (#4.4). The default is to return Local time. Valid values are:
  • L (default)—Local time.

  • U—UTC time.

(optional) This parameter is set to 1 if the value in the hl7_date_time input parameter is just a time value. The default assumes that the hl7_date_time input parameter is a date and time value.



Returns the converted date in VA FileMan format.

Example 1

To get date with no offset:

>S X=$$HL7TFM^XLFDT("200011271525-0700")

>W X

Example 2

To get UCT time offset:

>S X=$$HL7TFM^XLFDT("200011271525-0700","U")

>W X

Example 3

To get Local time in PST offset:

>S X=$$HL7TFM^XLFDT("200011271525-0700","L")

>W X

Example 4

To get Local time when only providing a time (no date) as the input parameter:

>S X=$$HL7TFM^XLFDT("1525-0700","L",1)

>W X


VA (Internet) / VA(Intranet) / OI / PD / Site Map / Terms of Use / VA Privacy Policy / Accessibility

Reviewed/Updated: August 26, 2011

If you have questions, need more information, or are having accessibility problems with this website, please contact us by E-Mail: Webmasters, Phone: 510-768-6800, or FAX: 510-768-6850.