Boost C++ Libraries

...one 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 for the latest Boost documentation.

Class template microsec_clock

boost::date_time::microsec_clock — A clock providing microsecond level resolution.

Synopsis

// In header: <boost/date_time/microsec_time_clock.hpp>

template<typename time_type> 
class microsec_clock {
public:
  // types
  typedef time_type::date_type          date_type;             
  typedef time_type::time_duration_type time_duration_type;    
  typedef time_duration_type::rep_type  resolution_traits_type;

  // public static functions
  template<typename time_zone_type> 
    static time_type local_time(shared_ptr< time_zone_type >);
  static time_type local_time();
  static time_type universal_time();

  // private static functions
  static time_type create_time(time_converter);
};

Description

A high precision clock that measures the local time at a resolution up to microseconds and adjusts to the resolution of the time system. For example, for the a library configuration with nano second resolution, the last 3 places of the fractional seconds will always be 000 since there are 1000 nano-seconds in a micro second.

`microsec_clock` public static functions

template<typename time_zone_type> 
  static time_type local_time(shared_ptr< time_zone_type > tz_ptr);

return a local time object for the given zone, based on computer clock

```
static time_type local_time();
```
Returns the local time based on computer clock settings.
```
static time_type universal_time();
```
Returns the UTC time based on computer settings.

`microsec_clock` private static functions

static time_type create_time(time_converter converter);