#include <Timestamp.h>

Public Member Functions
	Timestamp ()

	Timestamp (long int seconds, int nano=0, int tzOffset=0)

	Timestamp (double julian)
	Constructor for Julian date. Must be GMT.

	Timestamp (const std::string &str, int tzOffset=0)

	Timestamp (int year, int month, int day, int hour=0, int minute=0, int second=0, int nano=0)
	Construct absolute time with specified fields.

std::string	getString () const
	Return string representation of time, not including nanoseconds;.

double	getJulian () const
	Return julian date.

double	getNano () const

long int	getClibTime () const

bool	operator< (const Timestamp &other) const

bool	operator> (const Timestamp &other) const

bool	operator<= (const Timestamp &other) const

bool	operator>= (const Timestamp &other) const

Timestamp &	operator= (const Timestamp &other)

bool	operator== (const Timestamp &other) const

bool	operator!= (const Timestamp &other) const

Protected Attributes
time_t	m_time
	internal binary rep of time; count seconds from Jan 1, 1970

int	m_nano
	Save fractional seconds separately (associated with m_time)

Detailed Description

Timestamp class, valid for dates from 1970 through 2037

Supports comparisons

Input to constructors may be Julian date
seconds since start of 1970, Jan. 1 with optional nanosecond field individual fields (year, month, etc.) string format

yyyy-mm-dd hh:mm:ss 1969 < yyyy < 2038 where 0 < mm < 13 0 < dd < 32 -1 < hh < 24 -1 < mm < 60 -1 < ss < 60

o only the first three fields are required. Omitted trailing fields will be interpreted as equal to 0. o by default : will be used to delimit fields, but user may specify an alternative in most circumstances o leading zeros are optional

Definition at line 49 of file Timestamp.h.

Constructor & Destructor Documentation

◆ Timestamp() [1/5]

facilities::Timestamp::Timestamp ( )

Default constructor builds object representing current time, expressed in GMT

Definition at line 19 of file Timestamp.cxx.

                       : m_nano(0) {
    m_time = time(0);
  }

◆ Timestamp() [2/5]

facilities::Timestamp::Timestamp	(	long int	seconds,
		int	nano = `0`,
		int	tzOffset = `0`
	)

Count seconds from the creation-according-to-unix, start of 1970 Optional third argument is offset in seconds from GMT (e.g., PST is +28800)

Definition at line 28 of file Timestamp.cxx.

    : m_time((time_t) seconds), m_nano(nano)
  {
    if  ((nano >= inverseNanoInt)  || (nano < 0) || (seconds < 0))
      throw BadTimeInput("facilities::Timestamp bad nano argument");
    seconds += tzOffset;
  }

◆ Timestamp() [3/5]

facilities::Timestamp::Timestamp ( double julian )

Constructor for Julian date. Must be GMT.

Definition at line 37 of file Timestamp.cxx.

                                    {
    double secs;
    secs = (julian - julian1970) * secPerDay;
 
    if ((fabs(secs) > maxInt) || (secs < 0) )
      throw BadTimeInput("Julian time not in range [1970, 2037]");
 
    m_time = (long int) secs;
 
    // In case time is negative, truncation will go the "wrong way".
    // Want m_time always <= secs
    if (m_time > secs) m_time--;
    m_nano = (int) ((secs - m_time)/inverseNano);
  } 

◆ Timestamp() [4/5]

facilities::Timestamp::Timestamp	(	const std::string &	str,
		int	tzOffset = `0`
	)

Create a timestamp from an ascii string of standard form yyyy-mm-dd hh:mm:ss where only the first three fields are required.

If the string is invalid, object will represent unix creation time. If the string represents a time in a timezone other than GMT, tzOffset should represent time zone offset relative to GMT in seconds so if local time is, for example, PST, tzOffset should be 28800

Definition at line 53 of file Timestamp.cxx.

                                                         : m_nano(0) {
    m_time = toBinary(str);
    m_time += tzOffset;
  }

◆ Timestamp() [5/5]

facilities::Timestamp::Timestamp	(	int	year,
		int	month,
		int	day,
		int	hour = `0`,
		int	minute = `0`,
		int	second = `0`,
		int	nano = `0`
	)

Construct absolute time with specified fields.

Definition at line 59 of file Timestamp.cxx.

                                 :  m_nano(nano) {
    struct tm fields;
 
    // check input   
    // for now don't bother checking whether, e.g., someone
    // specified April 31
    if ((month < 1 ) || (month > 12) || (day < 1) || (day > 31) ||
        (hour < 0) || (hour > 23) || 
        (minute < 0) || (minute > 59) || 
        (second < 0 ) || (second >= 60) ||
        (year < 1970) || (year > 2037) || 
        (nano < 0 ) || (nano >= inverseNanoInt) ) 
      throw BadTimeInput("facilities::Timestamp Bad subfield");
 
    fields.tm_year = year - 1900;
    fields.tm_mon = month - 1;
    fields.tm_mday = day;
    fields.tm_hour = hour;
    fields.tm_min = minute;
    fields.tm_sec = (long int) second;
    fields.tm_wday = -1;
    fields.tm_yday = -1;
    
    // let system figure out whether daylight savings time is in effect
    fields.tm_isdst = 0;
 
    //    m_time = timegm(&fields);
    m_time = mktime(&fields) - Timestamp::s_tz.m_tzseconds;
  }

Member Function Documentation

◆ getClibTime()

long int facilities::Timestamp::getClibTime ( ) const

inline

Definition at line 88 of file Timestamp.h.

88{return m_time;}

Referenced by Coverage::Coverage(), and SelectInfo::SelectInfo().

◆ getJulian()

double facilities::Timestamp::getJulian ( ) const

Return julian date.

Definition at line 99 of file Timestamp.cxx.

                                     {
    double julian = (m_time +  m_nano/inverseNano)/secPerDay;
    julian += julian1970;
    return julian;
  }

◆ getNano()

double facilities::Timestamp::getNano ( ) const

inline

Definition at line 87 of file Timestamp.h.

87{return m_nano;}

◆ getString()

std::string facilities::Timestamp::getString ( ) const

Return string representation of time, not including nanoseconds;.

Definition at line 92 of file Timestamp.cxx.

                                       {
    std::string str;
 
    toString(m_time, str);
    return str;
  }

Referenced by Coverage::checkType(), rdbModel::Column::interpret(), lookup(), main(), operator<<(), calibUtil::Metadata::registerCalib(), and soonest().

◆ operator!=()

bool facilities::Timestamp::operator!= ( const Timestamp & other ) const

inline

Definition at line 118 of file Timestamp.h.

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

◆ operator<()

bool facilities::Timestamp::operator< ( const Timestamp & other ) const

inline

Definition at line 90 of file Timestamp.h.

                                                 {
      return ((m_time < other.m_time) || 
              ((m_time == other.m_time) && (m_nano < other.m_nano)));
    }

◆ operator<=()

bool facilities::Timestamp::operator<= ( const Timestamp & other ) const

inline

Definition at line 100 of file Timestamp.h.

                                                  {
      return ( !(other < (*this)) );
    }

◆ operator=()

Timestamp & facilities::Timestamp::operator= ( const Timestamp & other )

inline

Definition at line 109 of file Timestamp.h.

                                                  {
      m_time = other.m_time; m_nano = other.m_nano; 
      return *this;
    }

◆ operator==()

bool facilities::Timestamp::operator== ( const Timestamp & other ) const

inline

Definition at line 114 of file Timestamp.h.

                                                 {
      return ((m_time == other.m_time) && (m_nano == other.m_nano));
    }

◆ operator>()

bool facilities::Timestamp::operator> ( const Timestamp & other ) const

inline

Definition at line 95 of file Timestamp.h.

                                                 {
      return (other < (*this));
        
    }

◆ operator>=()

bool facilities::Timestamp::operator>= ( const Timestamp & other ) const

inline

Definition at line 104 of file Timestamp.h.

                                                  {
      return ( !( (*this) < other ) );
    }

Member Data Documentation

◆ m_nano

int facilities::Timestamp::m_nano

protected

Save fractional seconds separately (associated with m_time)

Definition at line 156 of file Timestamp.h.

Referenced by getJulian(), getNano(), operator<(), operator=(), operator==(), and Timestamp().

◆ m_time

time_t facilities::Timestamp::m_time

protected

internal binary rep of time; count seconds from Jan 1, 1970

Definition at line 153 of file Timestamp.h.

Referenced by getClibTime(), getJulian(), getString(), operator<(), operator=(), operator==(), and Timestamp().

The documentation for this class was generated from the following files:

Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ Timestamp() [1/5]

◆ Timestamp() [2/5]

◆ Timestamp() [3/5]

◆ Timestamp() [4/5]

◆ Timestamp() [5/5]

Member Function Documentation

◆ getClibTime()

◆ getJulian()

◆ getNano()

◆ getString()

◆ operator!=()

◆ operator<()

◆ operator<=()

◆ operator=()

◆ operator==()

◆ operator>()

◆ operator>=()

Member Data Documentation

◆ m_nano

◆ m_time