org.sblim.wbem.cim
Class CIMDateTime

java.lang.Object
  extended by 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
static int DAY_PRESICION
           
static int FULL_PRESICION
           
static int HOUR_PRESICION
           
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 iPresicion
           
protected  int iSecond
           
protected  int iYear
           
static int MILLI_FIVE_DIGIT_PRESICION
           
static int MILLI_FOUR_DIGIT_PRESICION
           
static int MILLI_ONE_DIGIT_PRESICION
           
static int MILLI_SIX_DIGIT_PRESICION
           
static int MILLI_THREE_DIGIT_PRESICION
           
static int MILLI_TWO_DIGIT_PRESICION
           
static int MINUTE_PRESICION
           
static int MONTH_PRESICION
           
static int SECOND_PRESICION
           
static int YEAR_PRESICION
           
 
Constructor Summary
protected CIMDateTime()
           
  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 correspoding objects such as CIMDateTime, or CIMSimpleDateTime.
  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 correspoding objects such as CIMTimeInterval, or CIMSimpleDateTime.
 
Method Summary
 boolean after(CIMDateTime pThat)
          Determines if the current date time ocurrs 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 getMicrosecond()
          Gets the number of microseconds specified for this CIMDateTime.
 int getMillisecodsPresicion()
          Returns the number of presicion digits defined for milliseconds.
 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 getPresicion()
          Gets the presicion level of this CIMDateTime.
 int getSeconds()
          Gets the number of seconds specified for this CIMDateTime.
 int hashCode()
           
 boolean isDayPresicion()
          Determines if this CIMDateTime has day presicion.
 boolean isHourPresicion()
          Determines if this CIMDateTime has houre presicion.
 boolean isInterval()
          Determines if the current object is represents an interval.
 boolean isMinutePresicion()
          Determines if this CIMDateTime has minute presicion.
 boolean isMonthPresicion()
          Determines if this CIMDateTime has month presicion.
 boolean isSecondPresicion()
          Determines if this CIMDateTime has minute presicion.
 boolean isYearPresicion()
          Determines if this CIMDateTime has year presicion.
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 setPresicion(int pPrecision)
          Specifies the presicion 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()
           
protected static CIMDateTime valueOf(CIMDateTime pDatetime, java.lang.String pDateString)
           
static CIMDateTime valueOf(java.lang.String pDateString)
          Creates an CIMDateTime object from the specified String argument.
protected  java.lang.String zeroPadding(int pValue, int pDigits)
           
 
Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait
 

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

iPresicion

protected int iPresicion

YEAR_PRESICION

public static final int YEAR_PRESICION
See Also:
Constant Field Values

MONTH_PRESICION

public static final int MONTH_PRESICION
See Also:
Constant Field Values

DAY_PRESICION

public static final int DAY_PRESICION
See Also:
Constant Field Values

HOUR_PRESICION

public static final int HOUR_PRESICION
See Also:
Constant Field Values

MINUTE_PRESICION

public static final int MINUTE_PRESICION
See Also:
Constant Field Values

SECOND_PRESICION

public static final int SECOND_PRESICION
See Also:
Constant Field Values

MILLI_ONE_DIGIT_PRESICION

public static final int MILLI_ONE_DIGIT_PRESICION
See Also:
Constant Field Values

MILLI_TWO_DIGIT_PRESICION

public static final int MILLI_TWO_DIGIT_PRESICION
See Also:
Constant Field Values

MILLI_THREE_DIGIT_PRESICION

public static final int MILLI_THREE_DIGIT_PRESICION
See Also:
Constant Field Values

MILLI_FOUR_DIGIT_PRESICION

public static final int MILLI_FOUR_DIGIT_PRESICION
See Also:
Constant Field Values

MILLI_FIVE_DIGIT_PRESICION

public static final int MILLI_FIVE_DIGIT_PRESICION
See Also:
Constant Field Values

MILLI_SIX_DIGIT_PRESICION

public static final int MILLI_SIX_DIGIT_PRESICION
See Also:
Constant Field Values

FULL_PRESICION

public static final int FULL_PRESICION
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 correspoding 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 correspoding 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 class java.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 class java.lang.Object

after

public boolean after(CIMDateTime pThat)
Determines if the current date time ocurrs 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 if this occurs after pThat, 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 if this occurs before pThat, false otherwise

equals

public boolean equals(java.lang.Object o)
Overrides:
equals in class java.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 class java.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.

isDayPresicion

public boolean isDayPresicion()
Determines if this CIMDateTime has day presicion.

Returns:
true if this CIMDateTime has day presicion, otherwise returns false.

isHourPresicion

public boolean isHourPresicion()
Determines if this CIMDateTime has houre presicion.

Returns:
true if this CIMDateTime has hour presicion, otherwise returns false.

getMillisecodsPresicion

public int getMillisecodsPresicion()
Returns the number of presicion digits defined for milliseconds. For instance, "19981207102059.10****-000" has 2 digits of presicion. "19981207102059.1*****-000" has 1 digit of presicion, and "199812071020**.******-000" has 0 digits of presicion.

Returns:
an integer representing the number of presicion digits for the milliseconds.

isMinutePresicion

public boolean isMinutePresicion()
Determines if this CIMDateTime has minute presicion.

Returns:
true if this CIMDateTime has month presicion, otherwise returns false.

isMonthPresicion

public boolean isMonthPresicion()
Determines if this CIMDateTime has month presicion.

Returns:
true if this CIMDateTime has month presicion, otherwise returns false.

isSecondPresicion

public boolean isSecondPresicion()
Determines if this CIMDateTime has minute presicion.

Returns:
true if this CIMDateTime has month presicion, otherwise returns false.

isYearPresicion

public boolean isYearPresicion()
Determines if this CIMDateTime has year presicion.

Returns:
true if this CIMDateTime has year presicion, otherwise returns false.

setPresicion

public void setPresicion(int pPrecision)
Specifies the presicion level for this CIMDateTime. The default value for this object is FULL_PRESICION.

Parameters:
pPrecision - specifies the presicion level for this object.

getPresicion

public int getPresicion()
Gets the presicion level of this CIMDateTime.

Returns:
an integer value representing the precision level for this object.

main

public static void main(java.lang.String[] args)


Copyright © 2005, 2006 IBM Corporation. All Rights Reserved.