Package javax.cim

Class CIMDateTime

java.lang.Object
javax.cim.CIMDateTime
All Implemented Interfaces:
java.io.Serializable, java.lang.Comparable<CIMDateTime>
Direct Known Subclasses:
CIMDateTimeAbsolute, CIMDateTimeInterval

public abstract class CIMDateTime extends java.lang.Object implements java.io.Serializable, java.lang.Comparable<CIMDateTime>
This abstract class represents a CIM Datetime data type as defined by the Distributed Management Task Force (DMTF) CIM Infrastructure Specification (DSP004). It is in the format yyyyMMddHHmmss.SSSSSSsutc where:
  • yyyy - is a 4 digit year
  • MM - is the month
  • dd - is the day of the month
  • HH - is the hour (24 hour clock)
  • mm - is the minute
  • ss - is the second
  • SSSSSS - is the number of microseconds
  • s - is "+" or "-", indicating the sign of the UTC (Universal Coordinated Time; for all intents and purposes the same as Greenwich Mean Time) correction field, or a ":". In the case of a ":" the value is interpreted as a time interval, and yyyyMM are interpreted as days.
  • utc - is the offset from UTC in minutes (using the sign indicated by s). It is ignored for a time interval.
For example, the absolute datetime for Monday, May 25, 1998, at 1:30 PM EST would be represented as: 19980525133015.000000-300. Values must be zero-padded so that the entire string is always the same 25-character length. Fields which are not significant must be replaced with asterisk characters. Similarly, intervals use the same format, except that the interpretation of the fields is based on elapsed time.
For example, the interval datetime for an elapsed time of 1 day, 13 hours, 23 minutes, 12 seconds would be: 00000001132312.000000:000. A UTC offset of zero is always used for interval properties.
See Also:
  • Constructor Summary

    Constructors
    Modifier
    Constructor
    Description
    protected
     
     
    CIMDateTime(java.lang.String pDateString)
    Creates a CIMDateTime object using a string.
  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
    equals(java.lang.Object pObj)
    Determines whether the CIMDateTime that is passed in is equal to the current CIMDateTime object.
    abstract java.lang.String
    Gets the internal string representation of this object.
    abstract int
    Returns the hash code for this object.

    Methods inherited from class java.lang.Object

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

    Methods inherited from interface java.lang.Comparable

    compareTo
  • Constructor Details

    • CIMDateTime

      public CIMDateTime(java.lang.String pDateString) throws java.lang.IllegalArgumentException
      Creates a CIMDateTime object using a string.
      Parameters:
      pDateString - A string in the format of yyyyMMddHHmmss.SSSSSSsutc.
      Throws:
      java.lang.IllegalArgumentException - If string is not in the correct format.
    • CIMDateTime

      protected CIMDateTime()
  • Method Details

    • equals

      public boolean equals(java.lang.Object pObj)
      Determines whether the CIMDateTime that is passed in is equal to the current CIMDateTime object.
      Overrides:
      equals in class java.lang.Object
      Parameters:
      pObj - The CIMDateTime object to compare to.
      Returns:
      true if this CIMDateTime object is equal to the one that was passed in, otherwise false.
    • getDateTimeString

      public abstract java.lang.String getDateTimeString()
      Gets the internal string representation of this object.
      Returns:
      The internal representation of the CIMDateTime object.
    • hashCode

      public abstract int hashCode()
      Returns the hash code for this object.
      Overrides:
      hashCode in class java.lang.Object
      Returns:
      A hash code value for this object.
      See Also:
      • Object.hashCode()