Package org.dcm4che.typeddicom.valuerepresentations

Interface TimeMultiWrapper

  • All Superinterfaces:
    org.dcm4che.typeddicom.AttributesWrapper, org.dcm4che.typeddicom.valuerepresentations.BytesDataElementWrapper, org.dcm4che.typeddicom.DataElementWrapper, org.dcm4che.typeddicom.valuerepresentations.DateDataElementMultiWrapper, org.dcm4che.typeddicom.valuerepresentations.StringDataElementMultiWrapper
    All Known Implementing Classes:
    CalibrationTime, IntendedFractionStartTime, SelectorTMValue, TimeOfLastCalibration
    public interface TimeMultiWrapper
extends org.dcm4che.typeddicom.valuerepresentations.StringDataElementMultiWrapper, org.dcm4che.typeddicom.valuerepresentations.DateDataElementMultiWrapper, org.dcm4che.typeddicom.valuerepresentations.BytesDataElementWrapper
    Name: Time
    Tag: TM
    Definition:

    A string of characters of the format HHMMSS.FFFFFF; where HH contains hours (range "00" - "23"), MM contains minutes (range "00" - "59"), SS contains seconds (range "00" - "60"), and FFFFFF contains a fractional part of a second as small as 1 millionth of a second (range "000000" - "999999"). A 24-hour clock is used. Midnight shall be represented by only "0000" since "2400" would violate the hour range. The string may be padded with trailing spaces. Leading and embedded spaces are not allowed.

    One or more of the components MM, SS, or FFFFFF may be unspecified as long as every component to the right of an unspecified component is also unspecified, which indicates that the Value is not precise to the precision of those unspecified components.

    The FFFFFF component, if present, shall contain 1 to 6 digits. If FFFFFF is unspecified the preceding "." shall not be included.

    Examples:

    1. "070907.0705 " represents a time of 7 hours, 9 minutes and 7.0705 seconds.

    2. "1010" represents a time of 10 hours, and 10 minutes.

    3. "021 " is an invalid Value.

    Note

    1. The ACR-NEMA Standard 300 (predecessor to DICOM) supported a string of characters of the format HH:MM:SS.frac for this VR. Use of this format is not compliant.

    2. See also DT VR in this table.

    3. The SS component may have a Value of 60 only for a leap second.

    Alternatively, in the context of a Query with Empty Value Matching (see PS3.4 PS3.4), a string of two QUOTATION MARK characters, representing an empty key Value.


    Character Repertoire:

    "0"-"9", "." and the SPACE character of Default Character Repertoire

    In the context of a Query with Range Matching (see PS3.4 PS3.4), the character "-" is allowed.

    In the context of a Query with Empty Value Matching (see PS3.4 PS3.4), the QUOTATION MARK character is allowed.


    Length of Value:

    14 bytes maximum

    In the context of a Query with Range Matching (see PS3.4 PS3.4), the length is 28 bytes maximum.

    In the context of a Query with Empty Value Matching (see PS3.4 PS3.4), the length is 2 bytes fixed.


    See Also:
    DICOM Standard Part 5 - Time

    • Nested Class Summary

      Nested Classes 
      Modifier and Type Interface Description
      static class  TimeMultiWrapper.Setter<B extends org.dcm4che.typeddicom.Builder<B,​? extends org.dcm4che.typeddicom.AttributesWrapper>,​D extends TimeMultiWrapper>  

    • Method Summary

      All Methods Instance Methods Default Methods 
      Modifier and Type Method Description
      default org.dcm4che3.data.VR getValueRepresentation()  

      • Methods inherited from interface org.dcm4che.typeddicom.AttributesWrapper

        copy, getAttributes, isEmpty

      • Methods inherited from interface org.dcm4che.typeddicom.valuerepresentations.BytesDataElementWrapper

        getBytes, getSafeBytes, setBytes

      • Methods inherited from interface org.dcm4che.typeddicom.DataElementWrapper

        exists, getPrivateCreator, getTag, getValue

      • Methods inherited from interface org.dcm4che.typeddicom.valuerepresentations.DateDataElementMultiWrapper

        getDate, getDate, getDate, getDates, getDates, setDates, setDates

      • Methods inherited from interface org.dcm4che.typeddicom.valuerepresentations.StringDataElementMultiWrapper

        getString, getString, getStrings, setStrings

    • Method Detail

      • getValueRepresentation

        default org.dcm4che3.data.VR getValueRepresentation()
        Specified by:
        getValueRepresentation in interface org.dcm4che.typeddicom.DataElementWrapper