JSystem/JDate.hh

Go to the documentation of this file.

#ifndef __JSYSTEM__JDATE__
#define __JSYSTEM__JDATE__

#include <time.h>
#include <string>
#include <ostream>

/**
 * \file
 * Date and time functions.
 * \author mdejong
 */
namespace JSYSTEM {}
namespace JPP { using namespace JSYSTEM; }

namespace JSYSTEM {
  
  /**
   * Get ASCII formatted date.
   *
   * \return          date
   */
  inline const char* getDate()
  {
    static time_t    ts;
    static const int        MAX_SIZE = 256;
    static char      buffer[MAX_SIZE];

    time(&ts);

    strftime(buffer, MAX_SIZE, "%x", localtime(&ts));
      
    return buffer;
  }

  
  /**
   * Get ASCII formatted time.
   *
   * \return          time
   */
  inline const char* getTime()
  {
    static time_t    ts;
    static const int        MAX_SIZE = 256;
    static char      buffer[MAX_SIZE];

    time(&ts);

    strftime(buffer, MAX_SIZE, "%X", localtime(&ts));
      
    return buffer;
  }

  
  /**
   * Auxililary class to get date and time.
   */
  struct JDateAndTime {
    /**
     * Default constructor.
     */
    JDateAndTime()
    {
      set();
    }


    /**
     * Constructor.
     *
     * \param  t1       time
     */
    JDateAndTime(const time_t t1)
    {
      set(t1);
    }


    /**
     * Smart pointer.
     *
     * \return          pointer to time structure
     */
    const tm* operator->() const
    {
      return tp;
    }


    int getSeconds() const { return tp->tm_sec; }           //!< seconds after the minute [0-59]
    int getMinutes() const { return tp->tm_min; }           //!< minutes after the hour   [0-59]
    int getHour()    const { return tp->tm_hour; }          //!< hours   after midnight   [0-23]
    int getDay()     const { return tp->tm_mday; }          //!< day   of the month       [1-31]
    int getMonth()   const { return tp->tm_mon  +    1; }   //!< month of the year        [1-12]
    int getYear()    const { return tp->tm_year + 1900; }   //!< year a.d.


    /**
     * Type conversion operator.
     *
     * \return          ASCII formatted date and time
     */
    operator std::string() const
    {
      return toString();
    }


    /**
     * Get ASCII formatted date and time.
     *
     * \return          ASCII formatted date and time
     */
    inline std::string toString() const
    {
      const std::string buffer = ctime(&ts);

      // remove the last character (carriage return) from the date string

      return buffer.substr(0, buffer.length() - 1);
    }


    /**
     * Set date and time.
     *
     * \return          date and time
     */
    inline const JDateAndTime& operator()() const
    {
      set();

      return *this;
    }


    /**
     * Set to actual time.
     */
    void set() const
    {
      time(&ts);

      tp = localtime(&ts);
    }


    /**
     * Set to given time.
     *
     * \param  t1       time
     */
    void set(const time_t t1) const
    {
      ts = t1;
      tp = localtime(&t1);
    }


    /**
     * Get elapsed time since given date and time.
     *
     * \param  object   date and time
     * \return          time [s]
     */
    double getElapsedTime(const JDateAndTime& object) const
    {
      return difftime(this->ts, object.ts);
    }


    /**
     * Write date and time to output.
     *
     * \param  out            output stream
     * \param  object         date and time
     * \return                output stream
     */
    friend inline std::ostream& operator<<(std::ostream& out, const JDateAndTime& object)
    {
      return out << object.toString();
    }


  private:
    mutable time_t ts;
    mutable tm*    tp;
  };


  /**
   * Function object to get ASCII formatted date and time.
   */
  static JDateAndTime getDateAndTime;
}

#endif