Boost C++ Libraries of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

This is the documentation for an old version of Boost. Click here to view this page for the latest version.

Class template time_duration

boost::date_time::time_duration — Represents some amount of elapsed time measure to a given resolution.


template<typename T, typename rep_type> 
class time_duration {
// types
typedef T duration_type;
typedef rep_type traits_type;
typedef rep_type::day_type day_type;
typedef rep_type::hour_type hour_type;
typedef rep_type::min_type min_type;
typedef rep_type::sec_type sec_type;
typedef rep_type::fractional_seconds_type fractional_seconds_type;
typedef rep_type::tick_type tick_type;
typedef rep_type::impl_type impl_type;

// construct/copy/destruct
time_duration(hour_type, min_type, sec_type = 0, 
fractional_seconds_type = 0);
time_duration(const time_duration< T, rep_type > &);

// public member functions
hour_type hours() const;
min_type minutes() const;
sec_type seconds() const;
sec_type total_seconds() const;
tick_type total_milliseconds() const;
tick_type total_nanoseconds() const;
tick_type total_microseconds() const;
fractional_seconds_type fractional_seconds() const;
duration_type invert_sign() const;
bool is_negative() const;
bool operator<(const time_duration &) const;
bool operator==(const time_duration &) const;
duration_type operator-() const;
duration_type operator-(const duration_type &) const;
duration_type operator+(const duration_type &) const;
duration_type operator/(int) const;
duration_type operator-=(const duration_type &) ;
duration_type operator+=(const duration_type &) ;
duration_type operator/=(int) ;
duration_type operator *(int) const;
duration_type operator *=(int) ;
tick_type ticks() const;
bool is_special() const;
bool is_pos_infinity() const;
bool is_neg_infinity() const;
bool is_not_a_date_time() const;
impl_type get_rep() const;

// public static functions
static duration_type unit() ;
static tick_type ticks_per_second() ;
static time_resolutions resolution() ;
static unsigned short num_fractional_digits() ;


This class represents a standard set of capabilities for all counted time durations. Time duration implementations should derive from this class passing their type as the first template parameter. This design allows the subclass duration types to provide custom construction policies or other custom features not provided here.

time_duration construct/copy/destruct

  1. time_duration();
  2. time_duration(hour_type hours_in, min_type minutes_in, 
    sec_type seconds_in = 0, 
    fractional_seconds_type frac_sec_in = 0);
  3. time_duration(const time_duration< T, rep_type > & other);
  4. time_duration(special_values sv);
  5. time_duration(impl_type in);

time_duration public member functions

  1. hour_type hours() const;
  2. min_type minutes() const;
  3. sec_type seconds() const;
  4. sec_type total_seconds() const;
  5. tick_type total_milliseconds() const;
  6. tick_type total_nanoseconds() const;
  7. tick_type total_microseconds() const;
  8. fractional_seconds_type fractional_seconds() const;
  9. duration_type invert_sign() const;
  10. bool is_negative() const;
  11. bool operator<(const time_duration & rhs) const;
  12. bool operator==(const time_duration & rhs) const;
  13. duration_type operator-() const;
  14. duration_type operator-(const duration_type & d) const;
  15. duration_type operator+(const duration_type & d) const;
  16. duration_type operator/(int divisor) const;
  17. duration_type operator-=(const duration_type & d) ;
  18. duration_type operator+=(const duration_type & d) ;
  19. duration_type operator/=(int divisor) ;
  20. duration_type operator *(int rhs) const;
  21. duration_type operator *=(int divisor) ;
  22. tick_type ticks() const;
  23. bool is_special() const;
  24. bool is_pos_infinity() const;
  25. bool is_neg_infinity() const;
  26. bool is_not_a_date_time() const;
  27. impl_type get_rep() const;

time_duration public static functions

  1. static duration_type unit() ;
  2. static tick_type ticks_per_second() ;
  3. static time_resolutions resolution() ;
  4. static unsigned short num_fractional_digits() ;
Copyright 2001-2005 CrystalClear Software, Inc