org.openmrs.hl7

Class HL7Util

java.lang.Object

org.openmrs.hl7.HL7Util

public class HL7Util
extends Object

HL7-related utilities

Version:

1.0

Field Summary

Fields

Modifier and Type	Field and Description
static String	LOCAL_TIMEZONE_OFFSET

Method Summary

Modifier and Type	Method and Description
static File	getHl7ArchivesDirectory() Gets the destination directory for hl7 archives.
protected static String	getTimeZoneOffset(String fullString, Date givenDate) Gets the timezone string for this given fullString.
static Date	parseHL7Date(String s) Convenience method for parsing HL7 dates (treated just like a timestamp with only year, month, and day specified)
static Date	parseHL7Time(String s) Converts an HL7 time into a java.util.Date object.
static Date	parseHL7Timestamp(String s) Converts an HL7 timestamp into a java.util.Date object.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

LOCAL_TIMEZONE_OFFSET

public static final String LOCAL_TIMEZONE_OFFSET

Method Detail

parseHL7Timestamp

public static Date parseHL7Timestamp(String s)
                              throws ca.uhn.hl7v2.HL7Exception

Converts an HL7 timestamp into a java.util.Date object. HL7 timestamps can be created with varying levels of precision — e.g., just the year or just the year and month, etc. Since java.util.Date cannot store a partial value, we fill in defaults like January, 01 at midnight within the current timezone.

Parameters:

s - HL7 timestamp to be parsed

Returns:

Date object

Throws:

ca.uhn.hl7v2.HL7Exception - Should fail on 78 Should handle 1978 Should fail on 19784 Should handle 197804 Should fail on 197841 Should handle 19780411 Should fail on 197804116 Should handle 1978041106 Should fail on 19780411065 Should handle 197804110615 Should fail on 1978041106153 Should handle 19780411061538 Should handle 19780411061538.1 Should handle 19780411061538.12 Should handle 19780411061538.123 Should handle 19780411061538.1234 Should fail on 197804110615-5 Should handle 197804110615-05 Should handle 197804110615-0200 Should not flub dst with 20091225123000

getTimeZoneOffset

protected static String getTimeZoneOffset(String fullString,
                                          Date givenDate)

Gets the timezone string for this given fullString. If fullString contains a + or - sign, the strings after those are considered to be the timezone.

If the fullString does not contain a timezone, the timezone is determined from the server's timezone on the "givenDate". (givenDate is needed to account for daylight savings time.)

Parameters:

fullString - the hl7 string being parsed

givenDate - the date that should be used if no timezone exists on the fullString

Returns:

a string like +0500 or -0500 for the timezone Should return timezone string if exists in given string Should return timezone for givenDate and not the current date

parseHL7Date

public static Date parseHL7Date(String s)
                         throws ca.uhn.hl7v2.HL7Exception

Convenience method for parsing HL7 dates (treated just like a timestamp with only year, month, and day specified)

Throws:

ca.uhn.hl7v2.HL7Exception

See Also:

parseHL7Timestamp(String)

parseHL7Time

public static Date parseHL7Time(String s)
                         throws ca.uhn.hl7v2.HL7Exception

Converts an HL7 time into a java.util.Date object. Since the java.util.Date object cannot store just the time, the date will remain at the epoch (e.g., January 1, 1970). Time more precise than microseconds is ignored.

Parameters:

s - HL7 time to be converted

Returns:

Date object set to time specified by HL7

Throws:

ca.uhn.hl7v2.HL7Exception - Should fail on 197804110615 Should handle 0615 Should handle 061538 Should handle 061538.1 Should handle 061538.12 Should handle 061538.123 Should handle 061538.1234 Should handle 061538-0300

getHl7ArchivesDirectory

public static File getHl7ArchivesDirectory()
                                    throws APIException

Gets the destination directory for hl7 archives.

Returns:

The destination directory for the hl7 in archive

Throws:

APIException