Tm Class Reference

#include <Tm.h>

Public Member Functions
struct tm	c_tm () const
uint64_t	cmsNanoSeconds () const
void	dumpTm ()
uint64_t	epoch () const
int	isNull () const
uint64_t	microsTime () const
bool	operator!= (const Tm &t) const
const Tm	operator+ (int seconds)
Tm &	operator+= (int seconds)
Tm &	operator-= (int seconds)
bool	operator< (const Tm &t) const
bool	operator<= (const Tm &t) const
bool	operator== (const Tm &t) const
void	setNull ()
void	setToCmsNanoTime (uint64_t nanos)
void	setToCurrentGMTime ()
void	setToCurrentLocalTime ()
void	setToGMTime (time_t t)
void	setToLocalTime (time_t t)
void	setToMicrosTime (uint64_t micros)
void	setToString (const std::string s) noexcept(false)
std::string	str () const
	Tm ()
	Tm (struct tm *initTm)
	Tm (uint64_t micros)
uint64_t	unixTime () const
virtual	~Tm ()

Static Public Member Functions
static Tm	negInfinity ()
static Tm	plusInfinity ()

Private Attributes
struct tm	m_tm

Static Private Attributes
static const uint64_t	NEG_INF_MICROS = 0
static const uint64_t	PLUS_INF_MICROS = (uint64_t)INT_MAX * 1000000

Friends
std::ostream &	operator<< (std::ostream &out, const Tm &t)

Detailed Description

Definition at line 13 of file Tm.h.

Constructor & Destructor Documentation

Tm() [1/3]

Tm::Tm

(

)

Definition at line 24 of file Tm.cc.

{ this->setNull(); }

Referenced by negInfinity(), and plusInfinity().

Tm() [2/3]

Tm::Tm

(

struct tm *

initTm

)

Definition at line 27 of file Tm.cc.

{ m_tm = *initTm; }

Tm() [3/3]

Tm::Tm

(

uint64_t

micros

)

Definition at line 29 of file Tm.cc.

                      {
  this->setNull();
  if (micros > PLUS_INF_MICROS) {
    //micros = PLUS_INF_MICROS;
    this->setToCmsNanoTime(micros);
  } else {
    this->setToMicrosTime(micros);
  }
}

~Tm()

Tm::~Tm ( )

virtual

Definition at line 40 of file Tm.cc.

{}

Member Function Documentation

c_tm()

struct tm Tm::c_tm

(

)

const

Definition at line 42 of file Tm.cc.

                         {
  return m_tm;
}

Referenced by str(), and DateHandler::tmToDate().

cmsNanoSeconds()

uint64_t Tm::cmsNanoSeconds

(

)

const

Definition at line 92 of file Tm.cc.

{ return microsTime() / 1000000 << 32; }

Referenced by popcon::EcalLaser_weekly_Handler::getNewObjects(), and popcon::EcalLaserHandler::getNewObjects().

dumpTm()

void Tm::dumpTm

(

)

Definition at line 204 of file Tm.cc.

                {
  cout << "=== dumpTm() ===" << endl;
  cout << "tm_year  " << m_tm.tm_year << endl;
  cout << "tm_mon   " << m_tm.tm_mon << endl;
  cout << "tm_mday  " << m_tm.tm_mday << endl;
  cout << "tm_hour  " << m_tm.tm_hour << endl;
  cout << "tm_min   " << m_tm.tm_min << endl;
  cout << "tm_sec   " << m_tm.tm_sec << endl;
  cout << "tm_yday  " << m_tm.tm_yday << endl;
  cout << "tm_wday  " << m_tm.tm_wday << endl;
  cout << "tm_isdst " << m_tm.tm_isdst << endl;
  cout << "================" << endl;
}

References gather_cfg::cout.

epoch()

uint64_t Tm::epoch ( ) const

inline

Definition at line 58 of file Tm.h.

{ return unixTime(); };

References unixTime().

isNull()

int Tm::isNull

(

)

const

Definition at line 46 of file Tm.cc.

                     {
  if (m_tm.tm_year == 0 && m_tm.tm_mon == 0 && m_tm.tm_mday == 0) {
    return 1;
  } else {
    return 0;
  }
}

Referenced by DateHandler::tmToDate().

microsTime()

uint64_t Tm::microsTime

(

)

const

Definition at line 96 of file Tm.cc.

                              {
  uint64_t result = 0;
  /*  
  result += (uint64_t)ceil((m_tm.tm_year - 70 ) * 365.25) * 24 * 3600;
  result += (m_tm.tm_yday) * 24 * 3600;
  result += m_tm.tm_hour * 3600;
  result += m_tm.tm_min * 60;
  result += m_tm.tm_sec;
  return (uint64_t) (result * 1000000);
  */
 
  struct tm time_struct;
  time_struct.tm_year = 1970 - 1900;
  time_struct.tm_mon = 0;
  time_struct.tm_mday = 1;
  time_struct.tm_sec = 0;
  time_struct.tm_min = 0;
  time_struct.tm_hour = 0;
  time_struct.tm_isdst = 0;
 
  time_t t1970 = mktime(&time_struct);
  tm s = m_tm;
  time_t t_this = mktime(&s);
 
  double x = difftime(t_this, t1970);
  result = (uint64_t)x * 1000000;
 
  return result;
}

References mps_fire::result, alignCSCRings::s, and x.

Referenced by DataReducer< T >::getReducedDataList(), RunDCSMagnetDat::nowMicroseconds(), RunDCSLVDat::nowMicroseconds(), RunDCSHVDat::nowMicroseconds(), operator+=(), operator-=(), operator<(), operator<=(), RunDCSLVDat::setStatusForBarrel(), RunDCSHVDat::setStatusForBarrel(), RunDCSLVDat::setStatusForEndcaps(), and RunDCSHVDat::setStatusForEndcaps().

negInfinity()

static Tm Tm::negInfinity ( )

inlinestatic

Definition at line 47 of file Tm.h.

{ return Tm(NEG_INF_MICROS); };

References NEG_INF_MICROS, and Tm().

operator!=()

bool Tm::operator!= ( const Tm &  t ) const

inline

Definition at line 101 of file Tm.h.

{ return !(t == *this); }

References submitPVValidationJobs::t.

operator+()

const Tm Tm::operator+ ( int  seconds )

inline

Definition at line 113 of file Tm.h.

                                  {
    Tm ret = *this;
    ret += seconds;
    return ret;
  }

References runTheMatrix::ret, and seconds().

operator+=()

Tm& Tm::operator+= ( int  seconds )

inline

Definition at line 108 of file Tm.h.

                              {
    setToMicrosTime(microsTime() + seconds * 1e6);
    return *this;
  }

References microsTime(), seconds(), and setToMicrosTime().

operator-=()

Tm& Tm::operator-= ( int  seconds )

inline

Definition at line 103 of file Tm.h.

                              {
    setToMicrosTime(microsTime() - seconds * 1e6);
    return *this;
  }

References microsTime(), seconds(), and setToMicrosTime().

operator<()

bool Tm::operator< ( const Tm &  t ) const

inline

Definition at line 91 of file Tm.h.

{ return microsTime() < t.microsTime(); }

References microsTime(), and submitPVValidationJobs::t.

operator<=()

bool Tm::operator<= ( const Tm &  t ) const

inline

Definition at line 93 of file Tm.h.

{ return microsTime() <= t.microsTime(); }

References microsTime(), and submitPVValidationJobs::t.

operator==()

bool Tm::operator== ( const Tm &  t ) const

inline

Definition at line 95 of file Tm.h.

                                            {
    return (m_tm.tm_hour == t.m_tm.tm_hour && m_tm.tm_isdst == t.m_tm.tm_isdst && m_tm.tm_mday == t.m_tm.tm_mday &&
            m_tm.tm_min == t.m_tm.tm_min && m_tm.tm_mon == t.m_tm.tm_mon && m_tm.tm_sec == t.m_tm.tm_sec &&
            m_tm.tm_wday == t.m_tm.tm_wday && m_tm.tm_yday == t.m_tm.tm_yday && m_tm.tm_year == t.m_tm.tm_year);
  }

References m_tm, and submitPVValidationJobs::t.

plusInfinity()

static Tm Tm::plusInfinity ( )

inlinestatic

Definition at line 45 of file Tm.h.

{ return Tm(PLUS_INF_MICROS); };

References PLUS_INF_MICROS, and Tm().

setNull()

void Tm::setNull

(

)

Definition at line 54 of file Tm.cc.

                 {
  m_tm.tm_hour = 0;
  m_tm.tm_isdst = 0;
  m_tm.tm_mday = 0;
  m_tm.tm_min = 0;
  m_tm.tm_mon = 0;
  m_tm.tm_sec = 0;
  m_tm.tm_wday = 0;
  m_tm.tm_yday = 0;
  m_tm.tm_year = 0;
}

Referenced by LMFSextuple::LMFSextuple().

setToCmsNanoTime()

void Tm::setToCmsNanoTime

(

uint64_t

nanos

)

Definition at line 126 of file Tm.cc.

{ setToMicrosTime((nanos >> 32) * 1000000); }

setToCurrentGMTime()

void Tm::setToCurrentGMTime

(

)

Definition at line 141 of file Tm.cc.

                            {
  time_t t = time(nullptr);
  m_tm = *gmtime(&t);
}

References submitPVValidationJobs::t, and protons_cff::time.

Referenced by LMFRunIOV::initialize(), RunDCSMagnetDat::nowMicroseconds(), RunDCSLVDat::nowMicroseconds(), RunDCSHVDat::nowMicroseconds(), and EcalPedOffset::writeDb().

setToCurrentLocalTime()

void Tm::setToCurrentLocalTime

(

)

Definition at line 136 of file Tm.cc.

                               {
  time_t t = time(nullptr);
  m_tm = *localtime(&t);
}

References submitPVValidationJobs::t, and protons_cff::time.

setToGMTime()

void Tm::setToGMTime

(

time_t

t

)

Definition at line 148 of file Tm.cc.

{ m_tm = *gmtime(&t); }

References submitPVValidationJobs::t.

Referenced by str().

setToLocalTime()

void Tm::setToLocalTime

(

time_t

t

)

Definition at line 146 of file Tm.cc.

{ m_tm = *localtime(&t); }

References submitPVValidationJobs::t.

setToMicrosTime()

void Tm::setToMicrosTime

(

uint64_t

micros

)

Definition at line 128 of file Tm.cc.

                                        {
  time_t t = micros / 1000000;
  if (t >= INT_MAX) {
    t = INT_MAX;
  }
  m_tm = *gmtime(&t);
}

References submitPVValidationJobs::t.

Referenced by operator+=(), and operator-=().

setToString()

void Tm::setToString ( const std::string  s )

noexcept

Definition at line 150 of file Tm.cc.

                                                   {
  sscanf(s.c_str(),
         "%04d-%02d-%02d %02d:%02d:%02d",
         &m_tm.tm_year,
         &m_tm.tm_mon,
         &m_tm.tm_mday,
         &m_tm.tm_hour,
         &m_tm.tm_min,
         &m_tm.tm_sec);
 
  try {
    if (m_tm.tm_year > 9999 || m_tm.tm_year < 1900) {
      throw(std::runtime_error("Year out of bounds"));
    } else if (m_tm.tm_mon > 12 || m_tm.tm_mon < 1) {
      throw(std::runtime_error("Month out of bounds"));
    } else if (m_tm.tm_mday > 31 || m_tm.tm_mday < 1) {
      throw(std::runtime_error("Day out of bounds"));
    } else if (m_tm.tm_hour > 23 || m_tm.tm_mday < 0) {
      throw(std::runtime_error("Hour out of bounds"));
    } else if (m_tm.tm_min > 59 || m_tm.tm_min < 0) {
      throw(std::runtime_error("Minute out of bounds"));
    } else if (m_tm.tm_sec > 59 || m_tm.tm_sec < 0) {
      throw(std::runtime_error("Day out of bounds"));
    }
 
    if (m_tm.tm_year >= 2038) {
      // take into account UNIX time limits
      m_tm.tm_year = 2038;
      if (m_tm.tm_mon > 1) {
        m_tm.tm_mon = 1;
      }
      if (m_tm.tm_mday > 19) {
        m_tm.tm_mday = 19;
      }
      if (m_tm.tm_hour > 3) {
        m_tm.tm_hour = 3;
      }
      if (m_tm.tm_min > 14) {
        m_tm.tm_min = 14;
      }
      if (m_tm.tm_sec > 7) {
        m_tm.tm_sec = 7;
      }
    }
    m_tm.tm_year -= 1900;
    m_tm.tm_mon -= 1;
  } catch (std::runtime_error &e) {
    this->setNull();
    string msg("Tm::setToString():  ");
    msg.append(e.what());
    throw(std::runtime_error(msg));
  }
}

References MillePedeFileConverter_cfg::e, mps_check::msg, and alignCSCRings::s.

Referenced by LMFCorrCoefDat::fetchBetween(), RunDCSHVDat::fillTheMapByTime(), and LMFLmrSubIOV::getIOVIDsLaterThan().

str()

string Tm::str

(

)

const

"One hour shif" fix Create a temporary dummy object that is in GMT and use it to generate the output. This is to avoid the "one hour shift" related to the Summer time and the value of m_tm.tm_isdst, see [1]. It guaranties that the output is always in GMT / UTC. [1] https://hypernews.cern.ch/HyperNews/CMS/get/ecalDB/66.html

Definition at line 66 of file Tm.cc.

                     {
  if (this->isNull()) {
    return "";
  }
 
  char timebuf[20] = "";
  if (this->microsTime() >= PLUS_INF_MICROS) {
    sprintf(timebuf, "9999-12-12 23:59:59");
  } else {
    Tm dummy_Tm;
    dummy_Tm.setToGMTime(this->microsTime() / 1000000);
    struct tm dummy_tm = dummy_Tm.c_tm();
    strftime(timebuf, 20, "%Y-%m-%d %H:%M:%S", &dummy_tm);
  }
  return string(timebuf);
}

References c_tm(), setToGMTime(), and AlCaHLTBitMon_QueryRunRegistry::string.

Referenced by LMFSeqDat::fetchByRunNumber(), RunDCSHVDat::fillTheMapByTime(), LMFRunIOV::initialize(), EcalTPGDBApp::printIOV(), and LMFRunIOV::setSubRunEnd().

unixTime()

uint64_t Tm::unixTime

(

)

const

Definition at line 94 of file Tm.cc.

{ return microsTime() / 1000000; }

Referenced by epoch().

Friends And Related Function Documentation

operator<<

std::ostream& operator<< ( std::ostream &  out, const Tm &  t  )

friend

GO: the maximum UNIX time is restricted to INT_MAX, corresponding to 2038-01-19 03:14:07. Take it into account in str()

Definition at line 18 of file Tm.cc.

                                                     {
  out << t.str();
  return out;
}

Member Data Documentation

m_tm

struct tm Tm::m_tm

private

Definition at line 122 of file Tm.h.

Referenced by operator==().

NEG_INF_MICROS

const uint64_t Tm::NEG_INF_MICROS = 0

staticprivate

Definition at line 14 of file Tm.h.

Referenced by negInfinity().

PLUS_INF_MICROS

const uint64_t Tm::PLUS_INF_MICROS = (uint64_t)INT_MAX * 1000000

staticprivate

Definition at line 16 of file Tm.h.

Referenced by plusInfinity().