ca.uhn.fhir.model.primitive

Class BaseDateTimeDt

java.lang.Object

ca.uhn.fhir.model.api.BaseElement

ca.uhn.fhir.model.api.BaseIdentifiableElement

ca.uhn.fhir.model.api.BasePrimitive<Date>

ca.uhn.fhir.model.primitive.BaseDateTimeDt

All Implemented Interfaces:

IDatatype, IElement, IIdentifiableElement, IPrimitiveDatatype<Date>, ISupportsUndeclaredExtensions, Externalizable, Serializable, IBase, IBaseDatatype, IPrimitiveType<Date>

Direct Known Subclasses:

DateDt, DateTimeDt, InstantDt

public abstract class BaseDateTimeDt
extends BasePrimitive<Date>

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
BaseDateTimeDt() Constructor
BaseDateTimeDt(Date theDate, TemporalPrecisionEnum thePrecision) Constructor
BaseDateTimeDt(Date theDate, TemporalPrecisionEnum thePrecision, TimeZone theTimeZone) Constructor
BaseDateTimeDt(String theString) Constructor

Method Summary

Modifier and Type	Method and Description
protected String	encode(Date theValue) Subclasses must override to convert a "coerced" value into an encoded one.
protected abstract TemporalPrecisionEnum	getDefaultPrecisionForDatatype() Returns the default precision for the given datatype
TemporalPrecisionEnum	getPrecision() Gets the precision for this datatype (using the default for the given type if not set)
TimeZone	getTimeZone() Returns the TimeZone associated with this dateTime's value.
boolean	isTimeZoneZulu()
boolean	isToday() Returns true if this object represents a date that is today's date
protected Date	parse(String theValue) Subclasses must override to convert an encoded representation of this datatype into a "coerced" one
void	setPrecision(TemporalPrecisionEnum thePrecision) Sets the precision for this datatype
BaseDateTimeDt	setTimeZone(TimeZone theTimeZone)
BaseDateTimeDt	setTimeZoneZulu(boolean theTimeZoneZulu)
BaseDateTimeDt	setValue(Date theValue) Sets the value for this type using the given Java Date object as the time, and using the default precision for this datatype, as well as the local timezone as determined by the local operating system.
void	setValue(Date theValue, TemporalPrecisionEnum thePrecision) Sets the value for this type using the given Java Date object as the time, and using the specified precision, as well as the local timezone as determined by the local operating system.
void	setValueAsString(String theValue)
String	toHumanDisplay() Returns a human readable version of this date/time using the system local format.
String	toHumanDisplayLocalTimezone() Returns a human readable version of this date/time using the system local format, converted to the local timezone if neccesary.

Methods inherited from class ca.uhn.fhir.model.api.BasePrimitive

equals, getValue, getValueAsString, hashCode, isEmpty, readExternal, toString, updateStringValue, writeExternal

Methods inherited from class ca.uhn.fhir.model.api.BaseIdentifiableElement

getElementSpecificId, getId, setElementSpecificId, setId, setId

Methods inherited from class ca.uhn.fhir.model.api.BaseElement

addUndeclaredExtension, addUndeclaredExtension, addUndeclaredExtension, getAllUndeclaredExtensions, getUndeclaredExtensions, getUndeclaredExtensionsByUrl, getUndeclaredModifierExtensions, isBaseEmpty

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

BaseDateTimeDt

public BaseDateTimeDt()

Constructor

BaseDateTimeDt

public BaseDateTimeDt(Date theDate,
                      TemporalPrecisionEnum thePrecision)

Constructor

Throws:

DataFormatException - If the specified precision is not allowed for this type

BaseDateTimeDt

public BaseDateTimeDt(String theString)

Constructor

Throws:

DataFormatException - If the specified precision is not allowed for this type

BaseDateTimeDt

public BaseDateTimeDt(Date theDate,
                      TemporalPrecisionEnum thePrecision,
                      TimeZone theTimeZone)

Constructor

Method Detail

toHumanDisplay

public String toHumanDisplay()

Returns a human readable version of this date/time using the system local format.

Note on time zones: This method renders the value using the time zone that is contained within the value. For example, if this date object contains the value "2012-01-05T12:00:00-08:00", the human display will be rendered as "12:00:00" even if the application is being executed on a system in a different time zone. If this behaviour is not what you want, use toHumanDisplayLocalTimezone() instead.

toHumanDisplayLocalTimezone

public String toHumanDisplayLocalTimezone()

Returns a human readable version of this date/time using the system local format, converted to the local timezone if neccesary.

See Also:

for a method which does not convert the time to the local timezone before rendering it.

encode

protected String encode(Date theValue)

Description copied from class: BasePrimitive

Subclasses must override to convert a "coerced" value into an encoded one.

Specified by:

encode in class BasePrimitive<Date>

Parameters:

theValue - Will not be null

Returns:

May return null if the value does not correspond to anything

getDefaultPrecisionForDatatype

protected abstract TemporalPrecisionEnum getDefaultPrecisionForDatatype()

Returns the default precision for the given datatype

getPrecision

public TemporalPrecisionEnum getPrecision()

Gets the precision for this datatype (using the default for the given type if not set)

See Also:

setPrecision(TemporalPrecisionEnum)

getTimeZone

public TimeZone getTimeZone()

Returns the TimeZone associated with this dateTime's value. May return null if no timezone was supplied.

isTimeZoneZulu

public boolean isTimeZoneZulu()

isToday

public boolean isToday()

Returns true if this object represents a date that is today's date

Throws:

NullPointerException - if BasePrimitive.getValue() returns null

parse

protected Date parse(String theValue)
              throws DataFormatException

Description copied from class: BasePrimitive

Subclasses must override to convert an encoded representation of this datatype into a "coerced" one

Specified by:

parse in class BasePrimitive<Date>

Parameters:

theValue - Will not be null

Returns:

May return null if the value does not correspond to anything

Throws:

DataFormatException

setPrecision

public void setPrecision(TemporalPrecisionEnum thePrecision)
                  throws DataFormatException

Sets the precision for this datatype

Throws:

DataFormatException

setTimeZone

public BaseDateTimeDt setTimeZone(TimeZone theTimeZone)

setTimeZoneZulu

public BaseDateTimeDt setTimeZoneZulu(boolean theTimeZoneZulu)

setValue

public BaseDateTimeDt setValue(Date theValue)

Sets the value for this type using the given Java Date object as the time, and using the default precision for this datatype, as well as the local timezone as determined by the local operating system. Both of these properties may be modified in subsequent calls if neccesary.

Specified by:

setValue in interface IPrimitiveDatatype<Date>

Specified by:

setValue in interface IPrimitiveType<Date>

Overrides:

setValue in class BasePrimitive<Date>

setValue

public void setValue(Date theValue,
                     TemporalPrecisionEnum thePrecision)
              throws DataFormatException

Sets the value for this type using the given Java Date object as the time, and using the specified precision, as well as the local timezone as determined by the local operating system. Both of these properties may be modified in subsequent calls if neccesary.

Parameters:

theValue - The date value

thePrecision - The precision

Throws:

DataFormatException

setValueAsString

public void setValueAsString(String theValue)
                      throws DataFormatException

Specified by:

setValueAsString in interface IPrimitiveDatatype<Date>

Specified by:

setValueAsString in interface IPrimitiveType<Date>

Overrides:

setValueAsString in class BasePrimitive<Date>

Throws:

DataFormatException