version 1.52, 2006/11/10 18:14:57
|
version 1.56, 2009/06/10 16:23:40
|
|
|
//%2006//////////////////////////////////////////////////////////////////////// |
//%LICENSE//////////////////////////////////////////////////////////////// |
// | // |
// Copyright (c) 2000, 2001, 2002 BMC Software; Hewlett-Packard Development |
// Licensed to The Open Group (TOG) under one or more contributor license |
// Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems. |
// agreements. Refer to the OpenPegasusNOTICE.txt file distributed with |
// Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L.P.; |
// this work for additional information regarding copyright ownership. |
// IBM Corp.; EMC Corporation, The Open Group. |
// Each contributor licenses this file to you under the OpenPegasus Open |
// Copyright (c) 2004 BMC Software; Hewlett-Packard Development Company, L.P.; |
// Source License; you may not use this file except in compliance with the |
// IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group. |
// License. |
// Copyright (c) 2005 Hewlett-Packard Development Company, L.P.; IBM Corp.; |
|
// EMC Corporation; VERITAS Software Corporation; The Open Group. |
|
// Copyright (c) 2006 Hewlett-Packard Development Company, L.P.; IBM Corp.; |
|
// EMC Corporation; Symantec Corporation; The Open Group. |
|
// | // |
// Permission is hereby granted, free of charge, to any person obtaining a copy |
// Permission is hereby granted, free of charge, to any person obtaining a |
// of this software and associated documentation files (the "Software"), to |
// copy of this software and associated documentation files (the "Software"), |
// deal in the Software without restriction, including without limitation the |
// to deal in the Software without restriction, including without limitation |
// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or |
// the rights to use, copy, modify, merge, publish, distribute, sublicense, |
// sell copies of the Software, and to permit persons to whom the Software is |
// and/or sell copies of the Software, and to permit persons to whom the |
// furnished to do so, subject to the following conditions: |
// Software is furnished to do so, subject to the following conditions: |
// | // |
// THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN |
// The above copyright notice and this permission notice shall be included |
// ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED |
// in all copies or substantial portions of the Software. |
// "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT |
|
// LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR |
|
// PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT |
|
// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN |
|
// ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION |
|
// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
|
// | // |
//============================================================================== |
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS |
|
// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF |
|
// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. |
|
// IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY |
|
// CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, |
|
// TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE |
|
// SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
|
// |
|
////////////////////////////////////////////////////////////////////////// |
// | // |
//%///////////////////////////////////////////////////////////////////////////// | //%///////////////////////////////////////////////////////////////////////////// |
| |
|
|
CIMDateTime(const String& str); | CIMDateTime(const String& str); |
| |
/** Creates a CIMDateTime object from an integer. | /** Creates a CIMDateTime object from an integer. |
@param microSec For a time stamp, the number of microseconds since |
@param usec For a time stamp, the number of microseconds since |
the epoch 0/0/0000 (12 am Jan 1, 1BCE); For an interval, the number | the epoch 0/0/0000 (12 am Jan 1, 1BCE); For an interval, the number |
of microseconds in the interval. | of microseconds in the interval. |
@param interval Specifies whether the CIMDateTime object is to be |
@param isInterval Specifies whether the CIMDateTime object is to be |
created as an interval value (true) or a time stamp (false). | created as an interval value (true) or a time stamp (false). |
@exception DateTimeOutOfRangeException If the microSec value is too | @exception DateTimeOutOfRangeException If the microSec value is too |
large (greater than 317,455,200,000,000,000 for a time stamps or | large (greater than 317,455,200,000,000,000 for a time stamps or |
|
|
@return True if the datetime is an interval value, false otherwise. | @return True if the datetime is an interval value, false otherwise. |
*/ | */ |
Boolean isInterval() const; | Boolean isInterval() const; |
|
|
|
/** Checks whether the datetime is an interval. (This non-const form is |
|
maintained for compatibility.) |
|
@return True if the datetime is an interval value, false otherwise. |
|
*/ |
Boolean isInterval(); | Boolean isInterval(); |
| |
#ifdef PEGASUS_USE_EXPERIMENTAL_INTERFACES | #ifdef PEGASUS_USE_EXPERIMENTAL_INTERFACES |
|
|
| |
/** Multiplies a CIMDateTime object by an integer and returns a CIMDateTime | /** Multiplies a CIMDateTime object by an integer and returns a CIMDateTime |
object that represents the product. | object that represents the product. |
@param num integer operand on the RHS of the operator |
@param x integer operand on the RHS of the operator |
@return A CIMDateTime object that is the result of multiplying the | @return A CIMDateTime object that is the result of multiplying the |
calling object by the RHS operand. | calling object by the RHS operand. |
@exception DateTimeOutOfRangeException If the operation causes an | @exception DateTimeOutOfRangeException If the operation causes an |
|
|
/** Multiplies a CIMDateTime object by an integer, returns the product | /** Multiplies a CIMDateTime object by an integer, returns the product |
and changes the value of the calling object to match the returned | and changes the value of the calling object to match the returned |
product. | product. |
@param num integer operand on the RHS of the operator |
@param x integer operand on the RHS of the operator |
@return A CIMDateTime object that is the result of multiplying the | @return A CIMDateTime object that is the result of multiplying the |
calling object by the RHS operand. | calling object by the RHS operand. |
@exception DateTimeOutOfRangeException If the operation causes an | @exception DateTimeOutOfRangeException If the operation causes an |
|
|
private: | private: |
CIMDateTimeRep* _rep; | CIMDateTimeRep* _rep; |
CIMDateTime(CIMDateTimeRep*); | CIMDateTime(CIMDateTimeRep*); |
|
|
|
friend class CIMBuffer; |
}; | }; |
| |
/** Compares two CIMDateTime objects and returns true if they represent the | /** Compares two CIMDateTime objects and returns true if they represent the |