Карта сайта Kansoftware
НОВОСТИУСЛУГИРЕШЕНИЯКОНТАКТЫ
Разработка программного обеспечения

Class template local_date_time_base

Boost , The Boost C++ Libraries BoostBook Documentation Subset , Library Reference

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

PrevUpHomeNext

Class template local_date_time_base

boost::local_time::local_date_time_base — Representation of "wall-clock" time in a particular time zone.

Synopsis

// In header: <boost/date_time/local_time/local_date_time.hpp>
template<typename utc_time_ = posix_time::ptime, 
         typename tz_type = date_time::time_zone_base<utc_time_,char> > 
class local_date_time_base : public date_time::base_time< utc_time_, boost::posix_time::posix_time_system >
{
public:
  // types
  typedef utc_time_                         utc_time_type;     
  typedef utc_time_type::time_duration_type time_duration_type;
  typedef utc_time_type::date_type          date_type;         
  typedef date_type::duration_type          date_duration_type;
  typedef utc_time_type::time_system_type   time_system_type;  
  enum DST_CALC_OPTIONS { EXCEPTION_ON_ERROR, NOT_DATE_TIME_ON_ERROR };
  // construct/copy/destruct
  local_date_time_base(utc_time_type, boost::shared_ptr< tz_type >);
  local_date_time_base(date_type, time_duration_type, 
                       boost::shared_ptr< tz_type >, bool);
  local_date_time_base(date_type, time_duration_type, 
                       boost::shared_ptr< tz_type >, DST_CALC_OPTIONS);
  local_date_time_base(const local_date_time_base &);
  explicit local_date_time_base(const boost::date_time::special_values, 
                                boost::shared_ptr< tz_type > = boost::shared_ptr< tz_type >());
  ~local_date_time_base();
  // public member functions
  boost::shared_ptr< tz_type > zone() const;
  bool is_dst() const;
  utc_time_type utc_time() const;
  utc_time_type local_time() const;
  std::string to_string() const;
  local_date_time_base 
  local_time_in(boost::shared_ptr< tz_type >, 
                time_duration_type = time_duration_type(0, 0, 0)) const;
  std::string zone_name(bool = false) const;
  std::string zone_abbrev(bool = false) const;
  std::string zone_as_posix_string() const;
  bool operator==(const local_date_time_base &) const;
  bool operator!=(const local_date_time_base &) const;
  bool operator<(const local_date_time_base &) const;
  bool operator<=(const local_date_time_base &) const;
  bool operator>(const local_date_time_base &) const;
  bool operator>=(const local_date_time_base &) const;
  local_date_time_base operator+(const date_duration_type &) const;
  local_date_time_base operator+=(const date_duration_type &);
  local_date_time_base operator-(const date_duration_type &) const;
  local_date_time_base operator-=(const date_duration_type &);
  local_date_time_base operator+(const time_duration_type &) const;
  local_date_time_base operator+=(const time_duration_type &);
  local_date_time_base operator-(const time_duration_type &) const;
  local_date_time_base operator-=(const time_duration_type &);
  time_duration_type operator-(const local_date_time_base &) const;
  // public static functions
  static time_is_dst_result 
  check_dst(date_type, time_duration_type, boost::shared_ptr< tz_type >);
  // private member functions
  utc_time_type 
  construction_adjustment(utc_time_type, boost::shared_ptr< tz_type >, bool);
  std::string zone_as_offset(const time_duration_type &, const std::string &) const;
};

Description

Представление времени «стены-часа» в конкретном часовом поясе Local_date_time_base содержит значение времени (дата и время смещены с 00:00) вместе с часовым поясом. Значение времени хранится как UTC, а преобразования в время настенных часов производятся по мере необходимости. Этот подход позволяет проводить операции между настенными часами в разных часовых поясах и соображениями экономии времени при дневном свете. Часовые пояса должны быть в форме ускорения::shared_ptr.

local_date_time_base public construct/copy/destruct

  1. local_date_time_base(utc_time_type t, boost::shared_ptr< tz_type);

    Этот конструктор интерпретирует прошедшее время как UTC-время. Так, например, если пройденный часовой пояс UTC-5, то время будет скорректировано назад на 5 часов. Часовой пояс позволяет автоматически подсчитать, скорректировано ли конкретное время для экономии дневного света и т.д. Если общий указатель часового пояса является нулевым, то время остается нескорректированным.

    Время UTC 

  • local_date_time_basetime_duration_type td, boost::shared_ptr< tz_type, bool dst_flag;4>

    Это конструирует локальное время – информация о прошедшем времени понимается в прошедшем tz. Флаг DST должен быть принят, чтобы указать, находится ли время в экономии дневного света или нет.

    Броски:

    		 – time_label_invalid, если пройденное время не существует в данной локации. Несуществующий случай обычно происходит во время сдвига назад от времени экономии дневного света. Когда часы смещены вперед, диапазон раз (от 2 до 3 часов в США) пропускается и, следовательно, является недействительным. dst_not_valid, если флаг DST принят на период, когда DST не активен. 
  • local_date_time_base(time_duration_type td, boost::shared_ptr< tz_type, DST_CALC_OPTIONS;

    Это конструирует локальное время – информация о прошедшем времени понимается в прошедшем tz. Флаг DST рассчитывается по указанному правилу. 

  • local_date_time_base(const local_date_time_base & rhs);
    Конструктор копий.
  • explicitlocal_date_time_baseboost::special_values sv,shared_ptr> tz::shared_ptr<;
    Специальные значения конструктора.
  • ~local_date_time_base();
    Простой деструктор, освобождает часовой пояс, если последний реферер.

    • local_date_time_base public member functions

    1. boost::shared_ptr< tz_type > zone()const;
      возвращает часовой пояс, связанный с вызовом экземпляра
    2. bool is_dst() const;
      возвращает ложное значение time_zone NULL и если значение времени является специальным_value
    3. utc_time_type utc_time() const;
      Возвращает значение времени объекта в виде представления utc.
    4. utc_time_type local_time() const;
      Возвращает значение времени объекта в виде локального представления.
    5. std::stringto_string() const;
      Возвращает строку в виде "2003-август-20 05:00:00 EDT".

      Возвращает строку в виде "2003-Авг-20 05:00:00 ЭДТ". Если Time_zone NULL, аббревиатура часового пояса будет «UTC». Аббрев часового пояса не будет включен, если вызывающий объект является специальным значением 

    6. local_date_time_baselocal_time_in:shared_ptr> new_tz, new_tz, new_tz_type td  0, 0)const;

      возвращает local_date_time_base в заданном часовом поясе с добавлением дополнительного времени_duration. 

    7. std::stringzone_name(bool as_offset =false) const;
      Возвращает название ассоциированного часового пояса или «Скоординированного универсального времени».

      Необязательный параметр bool вернет часовой пояс в качестве смещения (т.е. "+07:00" расширенного формата iso). Пустая строка возвращается для классов, которые не используют Time_zone 

    8. std::stringzone_abbrev(bool as_offset =false) const;
      Возвращает аббревиатуру ассоциированного часового пояса или "UTC".

      Опциональный параметр bool возвращает часовой пояс в виде смещения (т.е. формат изо «+0700»). Пустая строка возвращается для классов, которые не используют Time_zone 

    9. std::stringzone_as_posix_string() const;
      возвращает строку posix_time_zone для соответствующей временной_zone. Если нет Time_zone, возвращается «UTC+00».
    10. boolоператор==(const local_date_time_base& rhs)const;
      Оператор сравнения равенства.

      Оператор сравнения 

    11. bool оператор!=(const local_date_time_base& rhs)const;
      Неравенство оператор сравнения.
    12. bool оператор(const local_date_time_base & rhs) const;
      Меньше оператора сравнения.
    13. bool оператор=(const local_date_time_base & rhs) const;
      Меньше, чем или равно оператору сравнения.
    14. bool оператор>(const local_date_time_base & rhs)const;
      Больше оператора сравнения.
    15. boolоператор>=(const local_date_time_base& rhs)const;
      Больше или равно оператору сравнения.
    16. local_date_time_base оператор(const date_duration_type&dd) const;
      Local_date_time + date_duration.
    17. local_date_time_base оператор=(конст date_duration_type&dd);
      Local_date_time += date_duration.
    18. local_date_time_base оператор-(const date_duration_type&dd) const;
      Local_date_time - date_duration.
    19. local_date_time_base оператор-=(const date_duration_type&dd);
      Local_date_time -= date_duration.
    20. local_date_time_base оператор(const time_duration_type& td) const;
      Local_date_time + time_duration.
    21. local_date_time_base оператор=(const time_duration_type& td;
      Local_date_time += time_duration.
    22. local_date_time_base оператор-(const time_duration_type& td) const;
      Local_date_time - time_duration.
    23. local_date_time_base оператор-=(const time_duration_type& td);
      Local_date_time -= time_duration.
    24. time_duration_typeоператор-(const local_date_time_base & rhsconst;
      local_date_time -= local_date_time –> time_duration_type

    local_date_time_base public static functions

    1. static time_is_dst_resultcheck_dst(time_duration_type td, boost::shared_ptr< tz_type;;
      Определяет, находится ли данная метка времени в дневной экономии для данной зоны.

      Определяет, находится ли данная метка времени в дневной экономии для данной зоны. Принимает дату и время_длительность, представляющие местное время, вместе с часовым поясом, и возвращает в результате объект времени_is_dst_result.

    local_date_time_base private member functions

    1. utc_time_typeconstruction_adjustment(utc_time_type t, boost::shared_ptr< tz_type > z, bool dst_flag;

      Настройка прошедшего времени на UTC? 

    2. std::zone_as_offset(consttime_duration_type & td, const std::string &const;
      <8211; удалить это?

    Copyright © 2001-2005 CrystalClear Software, Inc

    Лицензия на программное обеспечение Boost, версия 1.0. (См. сопроводительный файл LICENSE_1_0.txt или копию по адресу http://www.boost.org/LICENSE_1_0.txt)
    PrevUpHomeNext

    Статья Class template local_date_time_base раздела The Boost C++ Libraries BoostBook Documentation Subset Library Reference может быть полезна для разработчиков на c++ и boost.




    Материалы статей собраны из открытых источников, владелец сайта не претендует на авторство. Там где авторство установить не удалось, материал подаётся без имени автора. В случае если Вы считаете, что Ваши права нарушены, пожалуйста, свяжитесь с владельцем сайта.


    :: Главная :: Library Reference ::

    реклама

    ©KANSoftWare (разработка программного обеспечения, создание программ, создание интерактивных сайтов), 2007
    Top.Mail.Ru

    Время компиляции файла: 2024-08-30 11:47:00
    2025-05-19 21:59:04/0.02503490447998/1