Package org.sblim.wbem.cim
Class CIMDateTime
- java.lang.Object
-
- org.sblim.wbem.cim.CIMDateTime
-
- All Implemented Interfaces:
java.io.Serializable
,java.lang.Cloneable
- Direct Known Subclasses:
CIMSimpleDateTime
,CIMTimeInterval
public class CIMDateTime extends java.lang.Object implements java.io.Serializable, java.lang.Cloneable
- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description static int
DAY_PRECISION
static int
FULL_PRECISION
static int
HOUR_PRECISION
protected java.util.Calendar
iCalendar
protected java.lang.String
iDateString
protected int
iDay
protected int
iHour
protected boolean
iInterval
protected int
iMicrosecond
protected int
iMillisecond
protected int
iMinute
protected int
iMonth
protected int
iOffsetMinute
protected int
iPrecision
protected int
iSecond
protected int
iYear
static int
MILLI_FIVE_DIGIT_PRECISION
static int
MILLI_FOUR_DIGIT_PRECISION
static int
MILLI_ONE_DIGIT_PRECISION
static int
MILLI_SIX_DIGIT_PRECISION
static int
MILLI_THREE_DIGIT_PRECISION
static int
MILLI_TWO_DIGIT_PRECISION
static int
MINUTE_PRECISION
static int
MONTH_PRECISION
static int
SECOND_PRECISION
static int
YEAR_PRECISION
-
Constructor Summary
Constructors Modifier Constructor Description protected
CIMDateTime()
CIMDateTime(java.lang.String pDateString)
Deprecated.this constructor was marked as deprecated because the dual nature of this object.CIMDateTime(java.util.Calendar pCalendar)
Deprecated.this constructor was marked as deprecated because the dual nature of this object.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description boolean
after(CIMDateTime pThat)
Determines if the current date time occurs after the date type from the specified object.boolean
before(CIMDateTime pThat)
Determines if the current date time ocurrs after the date type from the specified object.java.lang.Object
clone()
protected CIMDateTime
clone(CIMDateTime pClone)
boolean
equals(java.lang.Object o)
java.util.Calendar
getCalendar()
Returns a calendar representation of this object.int
getDay()
Gets the number of days specified for this CIMDateTime.int
getHour()
Gets the number of hours specified for this CIMDateTime.int
getMicrosecodsPrecision()
Returns the number of precision digits defined for microseconds.int
getMicrosecond()
Gets the number of microseconds specified for this CIMDateTime.int
getMillisecond()
Gets the number of milliseconds specified for this CIMDateTime.int
getMinute()
Gets the number of minutes specified for this CIMDateTime.int
getOffsetMinute()
Gets the number of offset minutes specified for this CIMDateTime.int
getPrecision()
Gets the precision level of this CIMDateTime.int
getSeconds()
Gets the number of seconds specified for this CIMDateTime.int
hashCode()
boolean
isDayPrecision()
Determines if this CIMDateTime has day precision.boolean
isHourPrecision()
Determines if this CIMDateTime has hour precision.boolean
isInterval()
Determines if the current object is represents an interval.boolean
isMinutePrecision()
Determines if this CIMDateTime has minute precision.boolean
isMonthPrecision()
Determines if this CIMDateTime has month precision.boolean
isSecondPrecision()
Determines if this CIMDateTime has minute precision.boolean
isYearPrecision()
Determines if this CIMDateTime has year precision.static void
main(java.lang.String[] args)
void
setHour(int pHour)
Specifies the number of hours for this CIMDateTime.void
setMicroseconds(int pMicrosecond)
Gets the number of microseconds specified this CIMDateTime.void
setMilliseconds(int pMillisecond)
Gets the number of milliseconds specified this CIMDateTime.void
setMinute(int pMinute)
Specifies the number of minutes for this CIMDateTime.void
setOffsetMinute(int pOffsetMinutes)
Sets the number of offset minutes associated with this CIMDateTime.void
setPrecision(int pPrecision)
Specifies the precision level for this CIMDateTime.void
setSecond(int pSecond)
Sets the number of seconds for this CIMDateTime.protected java.lang.String
starPadding(int pDigits)
java.lang.String
toMOF()
Returns the MOF representation of this object.java.lang.String
toString()
static CIMDateTime
valueOf(java.lang.String pDateString)
Creates an CIMDateTime object from the specified String argument.protected static CIMDateTime
valueOf(CIMDateTime pDatetime, java.lang.String pDateString)
protected java.lang.String
zeroPadding(int pValue, int pDigits)
-
-
-
Field Detail
-
iDateString
protected java.lang.String iDateString
-
iCalendar
protected java.util.Calendar iCalendar
-
iInterval
protected boolean iInterval
-
iYear
protected int iYear
-
iMonth
protected int iMonth
-
iDay
protected int iDay
-
iHour
protected int iHour
-
iMinute
protected int iMinute
-
iSecond
protected int iSecond
-
iMillisecond
protected int iMillisecond
-
iMicrosecond
protected int iMicrosecond
-
iOffsetMinute
protected int iOffsetMinute
-
iPrecision
protected int iPrecision
-
YEAR_PRECISION
public static final int YEAR_PRECISION
- See Also:
- Constant Field Values
-
MONTH_PRECISION
public static final int MONTH_PRECISION
- See Also:
- Constant Field Values
-
DAY_PRECISION
public static final int DAY_PRECISION
- See Also:
- Constant Field Values
-
HOUR_PRECISION
public static final int HOUR_PRECISION
- See Also:
- Constant Field Values
-
MINUTE_PRECISION
public static final int MINUTE_PRECISION
- See Also:
- Constant Field Values
-
SECOND_PRECISION
public static final int SECOND_PRECISION
- See Also:
- Constant Field Values
-
MILLI_ONE_DIGIT_PRECISION
public static final int MILLI_ONE_DIGIT_PRECISION
- See Also:
- Constant Field Values
-
MILLI_TWO_DIGIT_PRECISION
public static final int MILLI_TWO_DIGIT_PRECISION
- See Also:
- Constant Field Values
-
MILLI_THREE_DIGIT_PRECISION
public static final int MILLI_THREE_DIGIT_PRECISION
- See Also:
- Constant Field Values
-
MILLI_FOUR_DIGIT_PRECISION
public static final int MILLI_FOUR_DIGIT_PRECISION
- See Also:
- Constant Field Values
-
MILLI_FIVE_DIGIT_PRECISION
public static final int MILLI_FIVE_DIGIT_PRECISION
- See Also:
- Constant Field Values
-
MILLI_SIX_DIGIT_PRECISION
public static final int MILLI_SIX_DIGIT_PRECISION
- See Also:
- Constant Field Values
-
FULL_PRECISION
public static final int FULL_PRECISION
- See Also:
- Constant Field Values
-
-
Constructor Detail
-
CIMDateTime
public CIMDateTime(java.util.Calendar pCalendar)
Deprecated.this constructor was marked as deprecated because the dual nature of this object. This object was used to represent point in time, as well as intervals. Instead of this constructor applications are encourage to use corresponding objects such as CIMDateTime, or CIMSimpleDateTime.Construct an object of a CIMDateTime given a calendar.- Parameters:
pCalendar
- The calendar
-
CIMDateTime
public CIMDateTime(java.lang.String pDateString)
Deprecated.this constructor was marked as deprecated because the dual nature of this object. This object was used to represent point in time, as well as intervals. Instead of this constructor applications are encourage to use corresponding objects such as CIMTimeInterval, or CIMSimpleDateTime.Creates an object of a CIMDateTime.- Parameters:
pDateString
- A string representation of a datetime
-
CIMDateTime
protected CIMDateTime()
-
-
Method Detail
-
clone
public java.lang.Object clone()
- Overrides:
clone
in classjava.lang.Object
-
clone
protected CIMDateTime clone(CIMDateTime pClone)
-
valueOf
public static CIMDateTime valueOf(java.lang.String pDateString)
Creates an CIMDateTime object from the specified String argument. This method returns a CIMSimpleDateTime or a CIMDateTime, depending on what type of CIMDataType is denoted by the string argument.- Parameters:
pDateString
- The date string to parse- Returns:
- a CIMDateTime or CIMSimpleDateTime object
-
valueOf
protected static CIMDateTime valueOf(CIMDateTime pDatetime, java.lang.String pDateString)
-
hashCode
public int hashCode()
- Overrides:
hashCode
in classjava.lang.Object
-
after
public boolean after(CIMDateTime pThat)
Determines if the current date time occurs after the date type from the specified object. Comparison of CIMSimpleDateTime and CIMIntervalTime are meaningless, for this reason always return false.- Parameters:
pThat
- The datetime to compare with- Returns:
true
ifthis
occurs afterpThat
,false
otherwise
-
before
public boolean before(CIMDateTime pThat)
Determines if the current date time ocurrs after the date type from the specified object.- Parameters:
pThat
- The datetime to compare with- Returns:
true
ifthis
occurs beforepThat
,false
otherwise
-
equals
public boolean equals(java.lang.Object o)
- Overrides:
equals
in classjava.lang.Object
-
isInterval
public boolean isInterval()
Determines if the current object is represents an interval.- Returns:
- returns true if the datetime is an interval, otherwise returns false.
-
getCalendar
public java.util.Calendar getCalendar()
Returns a calendar representation of this object. If the object represent an interval, this method returns null.- Returns:
- The calendar representation
-
toMOF
public java.lang.String toMOF()
Returns the MOF representation of this object.- Returns:
- The MOF representation
-
starPadding
protected java.lang.String starPadding(int pDigits)
-
zeroPadding
protected java.lang.String zeroPadding(int pValue, int pDigits)
-
toString
public java.lang.String toString()
- Overrides:
toString
in classjava.lang.Object
-
getMillisecond
public int getMillisecond()
Gets the number of milliseconds specified for this CIMDateTime.- Returns:
- The milliseconds
-
getMicrosecond
public int getMicrosecond()
Gets the number of microseconds specified for this CIMDateTime.- Returns:
- The microsenconds
-
getMinute
public int getMinute()
Gets the number of minutes specified for this CIMDateTime.- Returns:
- The minutes
-
getDay
public int getDay()
Gets the number of days specified for this CIMDateTime.- Returns:
- The day
-
getHour
public int getHour()
Gets the number of hours specified for this CIMDateTime.- Returns:
- The hours
-
getOffsetMinute
public int getOffsetMinute()
Gets the number of offset minutes specified for this CIMDateTime.- Returns:
- The offset minutes
-
getSeconds
public int getSeconds()
Gets the number of seconds specified for this CIMDateTime.- Returns:
- The seconds
-
setHour
public void setHour(int pHour)
Specifies the number of hours for this CIMDateTime.- Parameters:
pHour
- The hour
-
setMilliseconds
public void setMilliseconds(int pMillisecond)
Gets the number of milliseconds specified this CIMDateTime.- Parameters:
pMillisecond
- The milliseconds
-
setMicroseconds
public void setMicroseconds(int pMicrosecond)
Gets the number of microseconds specified this CIMDateTime.- Parameters:
pMicrosecond
- The microsenconds
-
setMinute
public void setMinute(int pMinute)
Specifies the number of minutes for this CIMDateTime.- Parameters:
pMinute
- The minutes
-
setOffsetMinute
public void setOffsetMinute(int pOffsetMinutes)
Sets the number of offset minutes associated with this CIMDateTime.- Parameters:
pOffsetMinutes
- an integer value which species the number of offset minutes.- Throws:
java.lang.IllegalArgumentException
- if the number of minutes is out of a valid range (-999,999)
-
setSecond
public void setSecond(int pSecond)
Sets the number of seconds for this CIMDateTime.- Parameters:
pSecond
- integer value which species the number of seconds.- Throws:
java.lang.IllegalArgumentException
- if the number of seconds is out of a valid range.
-
isDayPrecision
public boolean isDayPrecision()
Determines if this CIMDateTime has day precision.- Returns:
- true if this CIMDateTime has day precision, otherwise returns false.
-
isHourPrecision
public boolean isHourPrecision()
Determines if this CIMDateTime has hour precision.- Returns:
- true if this CIMDateTime has hour precision, otherwise returns false.
-
getMicrosecodsPrecision
public int getMicrosecodsPrecision()
Returns the number of precision digits defined for microseconds. For instance, "19981207102059.10****-000" has 2 digits of precision. "19981207102059.1*****-000" has 1 digit of precision, and "199812071020**.******-000" has 0 digits of precision.- Returns:
- an integer representing the number of precision digits for the milliseconds.
-
isMinutePrecision
public boolean isMinutePrecision()
Determines if this CIMDateTime has minute precision.- Returns:
- true if this CIMDateTime has month precision, otherwise returns false.
-
isMonthPrecision
public boolean isMonthPrecision()
Determines if this CIMDateTime has month precision.- Returns:
- true if this CIMDateTime has month precision, otherwise returns false.
-
isSecondPrecision
public boolean isSecondPrecision()
Determines if this CIMDateTime has minute precision.- Returns:
- true if this CIMDateTime has month precision, otherwise returns false.
-
isYearPrecision
public boolean isYearPrecision()
Determines if this CIMDateTime has year precision.- Returns:
- true if this CIMDateTime has year precision, otherwise returns false.
-
setPrecision
public void setPrecision(int pPrecision)
Specifies the precision level for this CIMDateTime. The default value for this object is FULL_PRECISION.- Parameters:
pPrecision
- specifies the precision level for this object.
-
getPrecision
public int getPrecision()
Gets the precision level of this CIMDateTime.- Returns:
- an integer value representing the precision level for this object.
-
main
public static void main(java.lang.String[] args)
-
-