From b8cf34c691623e4ec329053cbbf68522a855882d Mon Sep 17 00:00:00 2001 From: DongHun Kwak Date: Thu, 5 Dec 2019 15:12:59 +0900 Subject: Imported Upstream version 1.67.0 --- doc/html/boost/date_time/date.html | 102 ++++++++++++++++++------------------- 1 file changed, 51 insertions(+), 51 deletions(-) (limited to 'doc/html/boost/date_time/date.html') diff --git a/doc/html/boost/date_time/date.html b/doc/html/boost/date_time/date.html index 011eaffc4d..45a962bf9d 100644 --- a/doc/html/boost/date_time/date.html +++ b/doc/html/boost/date_time/date.html @@ -51,82 +51,82 @@ typedef calendar::day_of_week_type day_of_week_type; // construct/copy/destruct - date(year_type, month_type, day_type); - date(const ymd_type &); - explicit date(date_int_type); - explicit date(date_rep_type); + date(year_type, month_type, day_type); + date(const ymd_type &); + explicit date(date_int_type); + explicit date(date_rep_type); - // public member functions - year_type year() const; - month_type month() const; - day_type day() const; - day_of_week_type day_of_week() const; - ymd_type year_month_day() const; - bool operator<(const date_type &) const; - bool operator==(const date_type &) const; - bool is_special() const; - bool is_not_a_date() const; - bool is_infinity() const; - bool is_pos_infinity() const; - bool is_neg_infinity() const; - special_values as_special() const; - duration_type operator-(const date_type &) const; - date_type operator-(const duration_type &) const; - date_type operator-=(const duration_type &); - date_rep_type day_count() const; - date_type operator+(const duration_type &) const; - date_type operator+=(const duration_type &); + // public member functions + year_type year() const; + month_type month() const; + day_type day() const; + day_of_week_type day_of_week() const; + ymd_type year_month_day() const; + bool operator<(const date_type &) const; + bool operator==(const date_type &) const; + bool is_special() const; + bool is_not_a_date() const; + bool is_infinity() const; + bool is_pos_infinity() const; + bool is_neg_infinity() const; + special_values as_special() const; + duration_type operator-(const date_type &) const; + date_type operator-(const duration_type &) const; + date_type operator-=(const duration_type &); + date_rep_type day_count() const; + date_type operator+(const duration_type &) const; + date_type operator+=(const duration_type &); };
-

Description

+

Description

The date template represents an interface shell for a date class that is based on a year-month-day system such as the gregorian or iso systems. It provides basic operations to enable calculation and comparisons.

Theory

This date representation fundamentally departs from the C tm struct approach. The goal for this type is to provide efficient date operations (add, subtract) and storage (minimize space to represent) in a concrete class. Thus, the date uses a count internally to represent a particular date. The calendar parameter defines the policies for converting the the year-month-day and internal counted form here. Applications that need to perform heavy formatting of the same date repeatedly will perform better by using the year-month-day representation.

Internally the date uses a day number to represent the date. This is a monotonic time representation. This representation allows for fast comparison as well as simplifying the creation of writing numeric operations. Essentially, the internal day number is like adjusted julian day. The adjustment is determined by the Epoch date which is represented as day 1 of the calendar. Day 0 is reserved for negative infinity so that any actual date is automatically greater than negative infinity. When a date is constructed from a date or formatted for output, the appropriate conversions are applied to create the year, month, day representations.

-

+

date public construct/copy/destruct

    -
  1. date(year_type y, month_type m, day_type d);
    2. -
  2. date(const ymd_type & ymd);
    3. +
  3. date(year_type y, month_type m, day_type d);
    4. +
  4. date(const ymd_type & ymd);
  5. -
    explicit date(date_int_type days);
    +
    explicit date(date_int_type days);

    This is a private constructor which allows for the creation of new dates. It is not exposed to users since that would require class users to understand the inner workings of the date class.

    6. -
  6. explicit date(date_rep_type days);
    7. +
  7. explicit date(date_rep_type days);
-

-date public member functions

+

+date public member functions

    -
  1. year_type year() const;
    2. -
  2. month_type month() const;
    3. -
  3. day_type day() const;
    4. -
  4. day_of_week_type day_of_week() const;
    5. -
  5. ymd_type year_month_day() const;
    6. -
  6. bool operator<(const date_type & rhs) const;
    7. -
  7. bool operator==(const date_type & rhs) const;
    8. +
  8. year_type year() const;
    9. +
  9. month_type month() const;
    10. +
  10. day_type day() const;
    11. +
  11. day_of_week_type day_of_week() const;
    12. +
  12. ymd_type year_month_day() const;
    13. +
  13. bool operator<(const date_type & rhs) const;
    14. +
  14. bool operator==(const date_type & rhs) const;
  15. -
    bool is_special() const;
    check to see if date is a special value
    16. +
    bool is_special() const;
    check to see if date is a special value
  16. -
    bool is_not_a_date() const;
    check to see if date is not a value
    17. +
    bool is_not_a_date() const;
    check to see if date is not a value
  17. -
    bool is_infinity() const;
    check to see if date is one of the infinity values
    18. +
    bool is_infinity() const;
    check to see if date is one of the infinity values
  18. -
    bool is_pos_infinity() const;
    check to see if date is greater than all possible dates
    19. +
    bool is_pos_infinity() const;
    check to see if date is greater than all possible dates
  19. -
    bool is_neg_infinity() const;
    check to see if date is greater than all possible dates
    20. +
    bool is_neg_infinity() const;
    check to see if date is greater than all possible dates
  20. -
    special_values as_special() const;
    return as a special value or a not_special if a normal date
    21. -
  21. duration_type operator-(const date_type & d) const;
    22. -
  22. date_type operator-(const duration_type & dd) const;
    23. -
  23. date_type operator-=(const duration_type & dd);
    24. -
  24. date_rep_type day_count() const;
    25. -
  25. date_type operator+(const duration_type & dd) const;
    26. -
  26. date_type operator+=(const duration_type & dd);
    27. +
    special_values as_special() const;
    return as a special value or a not_special if a normal date +
  27. duration_type operator-(const date_type & d) const;
    28. +
  28. date_type operator-(const duration_type & dd) const;
    29. +
  29. date_type operator-=(const duration_type & dd);
    30. +
  30. date_rep_type day_count() const;
    31. +
  31. date_type operator+(const duration_type & dd) const;
    32. +
  32. date_type operator+=(const duration_type & dd);
-- cgit v1.2.3