EIC code displayed by LXR master/​include/​opencascade/​Quantity_Date.hxx	Source navigation Diff markup Identifier search General search
	Version: master test Revert   Change

File indexing completed on 2026-09-20 09:18:51

 // Created on: 1993-01-04
 // Created by: J.P. BOUDIER - J.P. TIRAULT
 // Copyright (c) 1993-1999 Matra Datavision
 // Copyright (c) 1999-2014 OPEN CASCADE SAS
 //
 // This file is part of Open CASCADE Technology software library.
 //
 // This library is free software; you can redistribute it and/or modify it under
 // the terms of the GNU Lesser General Public License version 2.1 as published
 // by the Free Software Foundation, with special exception defined in the file
 // OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
 // distribution for complete text of the license and disclaimer of any warranty.
 //
 // Alternatively, this file may be used under the terms of Open CASCADE
 // commercial license or contractual agreement.
 
 #ifndef _Quantity_Date_HeaderFile
 #define _Quantity_Date_HeaderFile
 
 #include <Standard.hxx>
 #include <Standard_DefineAlloc.hxx>
 #include <Standard_Handle.hxx>
 
 #include <Standard_Boolean.hxx>
 class Quantity_Period;
 
 //! This class provides services to manage date information.
 //! A date represents the following time intervals:
 //! year, month, day, hour, minute, second,
 //! millisecond and microsecond.
 //! Current time is expressed in elapsed seconds
 //! and microseconds beginning from 00:00 GMT,
 //! January 1, 1979 (zero hour). The valid date can
 //! only be later than this one.
 //! Note: a Period object gives the interval between two dates.
 class Quantity_Date
 {
 public:
   DEFINE_STANDARD_ALLOC
 
   //! Constructs a default date
   //! (00:00 GMT, January 1, 1979 (zero hour)); use the function
   //! SetValues to define the required date; or
   Standard_EXPORT Quantity_Date();
 
   //! Constructs a date from the year yyyy, the
   //! month mm, the day dd, the hour hh, the minute
   //! mn, the second ss, the millisecond mis
   //! (defaulted to 0) and the microsecond mics (defaulted to 0).
   //! With:
   //! 1 <= mm <= 12
   //! 1 <= dd <= max number of days of <mm>
   //! 1979 <= yyyy
   //! 0 <= hh <= 23
   //! 0 <= mn <= 59
   //! 0 <= ss <= 59
   //! 0 <= mis <= 999
   //! 0 <= mics <= 999
   //! Exceptions
   //! Quantity_DateDefinitionError if mm, dd, hh,
   //! mn, ss, mis and mics are not the components of the valid date.
   Standard_EXPORT Quantity_Date(const int mm,
                                 const int dd,
                                 const int yyyy,
                                 const int hh,
                                 const int mn,
                                 const int ss,
                                 const int mis  = 0,
                                 const int mics = 0);
 
   //! Gets a complete Date.
   //! -   in mm - the month,
   //! -   in dd - the day,
   //! -   in yyyy - the year,
   //! -   in hh - the hour,
   //! -   in mn - the minute,
   //! -   in ss - the second,
   //! -   in mis - the millisecond, and
   //! -   in mics - the microsecond
   Standard_EXPORT void Values(int& mm,
                               int& dd,
                               int& yy,
                               int& hh,
                               int& mn,
                               int& ss,
                               int& mis,
                               int& mics) const;
 
   //! Assigns to this date the year yyyy, the month
   //! mm, the day dd, the hour hh, the minute mn, the
   //! second ss, the millisecond mis (defaulted to 0)
   //! and the microsecond mics (defaulted to 0).
   //! Exceptions
   //! Quantity_DateDefinitionError if mm, dd, hh,
   //! mn, ss, mis and mics are not components of a valid date.
   Standard_EXPORT void SetValues(const int mm,
                                  const int dd,
                                  const int yy,
                                  const int hh,
                                  const int mn,
                                  const int ss,
                                  const int mis  = 0,
                                  const int mics = 0);
 
   //! Subtracts one Date from another one to find the period
   //! between and returns the value.
   //! The result is the absolute value between the difference
   //! of two dates.
   Standard_EXPORT Quantity_Period Difference(const Quantity_Date& anOther);
 
   //! Subtracts a period from a Date and returns the new Date.
   //! Raises an exception if the result date is anterior to
   //! Jan 1, 1979.
   Standard_EXPORT Quantity_Date Subtract(const Quantity_Period& aPeriod);
 
   Quantity_Date operator-(const Quantity_Period& aPeriod) { return Subtract(aPeriod); }
 
   //! Adds a Period to a Date and returns the new Date.
   Standard_EXPORT Quantity_Date Add(const Quantity_Period& aPeriod);
 
   Quantity_Date operator+(const Quantity_Period& aPeriod) { return Add(aPeriod); }
 
   //! Returns year of a Date.
   Standard_EXPORT int Year();
 
   //! Returns month of a Date.
   Standard_EXPORT int Month();
 
   //! Returns Day of a Date.
   Standard_EXPORT int Day();
 
   //! Returns Hour of a Date.
   Standard_EXPORT int Hour();
 
   //! Returns minute of a Date.
   Standard_EXPORT int Minute();
 
   //! Returns second of a Date.
   Standard_EXPORT int Second();
 
   //! Returns millisecond of a Date.
   Standard_EXPORT int MilliSecond();
 
   //! Returns microsecond of a Date.
   Standard_EXPORT int MicroSecond();
 
   //! Returns TRUE if both <me> and <other> are equal.
   //! This method is an alias of operator ==.
   constexpr bool IsEqual(const Quantity_Date& anOther) const noexcept
   {
     return (myUSec == anOther.myUSec && mySec == anOther.mySec);
   }
 
   constexpr bool operator==(const Quantity_Date& anOther) const noexcept
   {
     return IsEqual(anOther);
   }
 
   //! Returns TRUE if <me> is earlier than <other>.
   constexpr bool IsEarlier(const Quantity_Date& anOther) const noexcept
   {
     return (mySec < anOther.mySec) || (mySec == anOther.mySec && myUSec < anOther.myUSec);
   }
 
   constexpr bool operator<(const Quantity_Date& anOther) const noexcept
   {
     return IsEarlier(anOther);
   }
 
   //! Returns TRUE if <me> is later then <other>.
   constexpr bool IsLater(const Quantity_Date& anOther) const noexcept
   {
     return (mySec > anOther.mySec) || (mySec == anOther.mySec && myUSec > anOther.myUSec);
   }
 
   constexpr bool operator>(const Quantity_Date& anOther) const noexcept { return IsLater(anOther); }
 
   //! Checks the validity of a date - returns true if a
   //! date defined from the year yyyy, the month mm,
   //! the day dd, the hour hh, the minute mn, the
   //! second ss, the millisecond mis (defaulted to 0)
   //! and the microsecond mics (defaulted to 0) is valid.
   //! A date must satisfy the conditions above:
   //! -   yyyy is greater than or equal to 1979,
   //! -   mm lies within the range [1, 12] (with 1
   //! corresponding to January and 12 to December),
   //! -   dd lies within a valid range for the month mm
   //! (from 1 to 28, 29, 30 or 31 depending on
   //! mm and whether yyyy is a leap year or not),
   //! -   hh lies within the range [0, 23],
   //! -   mn lies within the range [0, 59],
   //! -   ss lies within the range [0, 59],
   //! -   mis lies within the range [0, 999],
   //! -   mics lies within the range [0, 999].C
   Standard_EXPORT static bool IsValid(const int mm,
                                       const int dd,
                                       const int yy,
                                       const int hh,
                                       const int mn,
                                       const int ss,
                                       const int mis  = 0,
                                       const int mics = 0);
 
   //! Returns true if a year is a leap year.
   //! The leap years are divisible by 4 and not by 100 except
   //! the years divisible by 400.
   static constexpr bool IsLeap(const int yy) noexcept
   {
     return ((yy % 4 == 0) && (yy % 100 != 0)) || (yy % 400) == 0;
   }
 
 private:
   int mySec;
   int myUSec;
 };
 
 #endif // _Quantity_Date_HeaderFile

This page was automatically generated by the 2.3.7 LXR engine. The LXR team