diff options
author | DongHun Kwak <dh0128.kwak@samsung.com> | 2017-09-13 11:24:46 +0900 |
---|---|---|
committer | DongHun Kwak <dh0128.kwak@samsung.com> | 2017-09-13 11:25:39 +0900 |
commit | 4fadd968fa12130524c8380f33fcfe25d4de79e5 (patch) | |
tree | fd26a490cd15388d42fc6652b3c5c13012e7f93e /doc/html/date_time/details.html | |
parent | b5c87084afaef42b2d058f68091be31988a6a874 (diff) | |
download | boost-4fadd968fa12130524c8380f33fcfe25d4de79e5.tar.gz boost-4fadd968fa12130524c8380f33fcfe25d4de79e5.tar.bz2 boost-4fadd968fa12130524c8380f33fcfe25d4de79e5.zip |
Imported Upstream version 1.65.0upstream/1.65.0
Change-Id: Icf8400b375482cb11bcf77440a6934ba360d6ba4
Signed-off-by: DongHun Kwak <dh0128.kwak@samsung.com>
Diffstat (limited to 'doc/html/date_time/details.html')
-rw-r--r-- | doc/html/date_time/details.html | 94 |
1 files changed, 47 insertions, 47 deletions
diff --git a/doc/html/date_time/details.html b/doc/html/date_time/details.html index 131796687a..d641e6422f 100644 --- a/doc/html/date_time/details.html +++ b/doc/html/date_time/details.html @@ -6,7 +6,7 @@ <link rel="stylesheet" href="../../../doc/src/boostbook.css" type="text/css"> <meta name="generator" content="DocBook XSL Stylesheets V1.79.1"> <link rel="home" href="../index.html" title="The Boost C++ Libraries BoostBook Documentation Subset"> -<link rel="up" href="../date_time.html" title="Chapter 12. Boost.Date_Time"> +<link rel="up" href="../date_time.html" title="Chapter 11. Boost.Date_Time"> <link rel="prev" href="serialization.html" title="Serialization"> <link rel="next" href="examples.html" title="Examples"> </head> @@ -47,7 +47,7 @@ <a class="link" href="details.html#special_value_handling">Special Value Handling</a> </p> <a name="timepoints"></a><h4> -<a name="idp213734864"></a>Timepoints</h4> +<a name="idp189376176"></a>Timepoints</h4> <p> This section describes some of basic arithmetic rules that can be performed with timepoints. In general, Timepoints support basic arithmetic in conjunction with Durations as follows: </p> @@ -67,7 +67,7 @@ <p> </p> <a name="durations"></a><h4> -<a name="idp213738624"></a>Durations</h4> +<a name="idp189380000"></a>Durations</h4> <p> Durations represent a length of time and can have positive and negative values. It is frequently useful to be able to perform calculations with other durations and with simple integral values. The following describes these calculations: </p> @@ -82,7 +82,7 @@ <p> </p> <a name="intervals"></a><h4> -<a name="idp213741808"></a>Intervals (Periods)</h4> +<a name="idp189383184"></a>Intervals (Periods)</h4> <p> Interval logic is extremely useful for simplifying many 'calculations' for dates and times. The following describes the operations provided by periods which are based on half-open range. The following operations calculate new time periods based on two input time periods: </p> @@ -115,7 +115,7 @@ Timeperiod shift Duration --> Timeperiod <p> </p> <a name="special_value_handling"></a><h4> -<a name="idp213747264"></a>Special Value Handling</h4> +<a name="idp189388576"></a>Special Value Handling</h4> <p> For many temporal problems it is useful for Duration and Timepoint types to support special values such as Not A Date Time (NADT) and infinity. In general special values such as Not A Date Time (NADT) and infinity should follow rules like floating point values. Note that it should be possible to configure NADT based systems to throw an exception instead of result in NADT. </p> @@ -241,7 +241,7 @@ Timeperiod shift Duration --> Timeperiod <div class="titlepage"><div><div><h3 class="title"> <a name="date_time.tradeoffs"></a>Tradeoffs: Stability, Predictability, and Approximations</h3></div></div></div> <h3> -<a name="idp213790560"></a> +<a name="idp189431872"></a> Unavoidable Trade-offs </h3> <p> @@ -265,14 +265,14 @@ Timeperiod shift Duration --> Timeperiod If you want accurate calculations with future times, you will have to use TAI or an equivalent, but the mapping from TAI to UTC or local time depends on leap seconds, so you will not have exact agreement with wall-clock time. </p> <h3> -<a name="idp213797264"></a> +<a name="idp189438576"></a> Stability, Predictability, and Approximations </h3> <p> Here is some underlying theory that helps to explain what's going on. Remember that a temporal type, like any abstract data type (ADT), is a set of values together with operations on those values. </p> <h4> -<a name="idp213798592"></a> +<a name="idp189439904"></a> Stability </h4> <p> @@ -282,7 +282,7 @@ Timeperiod shift Duration --> Timeperiod An operation on a type is stable if the result of applying the operation to a particular operand(s) does not change over time. </p> <h4> -<a name="idp213800912"></a> +<a name="idp189442224"></a> Predictability </h4> <p> @@ -321,7 +321,7 @@ Timeperiod shift Duration --> Timeperiod Ill-formed sets are not of much practical use, so we will not discuss them further. In plain english the above simply says that all the values of a predictable type are known ahead of time, but some values of an unpredictable type are not known until some particular time. </p> <h4> -<a name="idp213818336"></a> +<a name="idp189459648"></a> Stability of Operations </h4> <p> @@ -352,7 +352,7 @@ Timeperiod shift Duration --> Timeperiod We can refine this a little by saying that a range within an unpredicatable type can be predictable, and operations performed entirely on values within that range will be stable. For example, the range of UTC timepoints from 1970-01-01 through the present is predictable, so calculations of durations within that range will be stable. </p> <h4> -<a name="idp213824976"></a> +<a name="idp189466288"></a> Approximations </h4> <p> @@ -445,7 +445,7 @@ Timeperiod shift Duration --> Timeperiod <p> </p> <a name="date_ref"></a><h4> -<a name="idp213858160"></a>Date Calendar References</h4> +<a name="idp189499328"></a>Date Calendar References</h4> <p> </p> <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: bullet; "> @@ -464,7 +464,7 @@ Timeperiod shift Duration --> Timeperiod <p> </p> <a name="time_ref"></a><h4> -<a name="idp213867744"></a>Time</h4> +<a name="idp189508912"></a>Time</h4> <p> </p> <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: bullet; "> @@ -488,7 +488,7 @@ Timeperiod shift Duration --> Timeperiod <p> </p> <a name="other_c_libs"></a><h4> -<a name="idp213878832"></a>Other C/C++ Libraries</h4> +<a name="idp189520000"></a>Other C/C++ Libraries</h4> <p> </p> <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: bullet; "> @@ -515,7 +515,7 @@ Timeperiod shift Duration --> Timeperiod <p> </p> <a name="java_libs"></a><h4> -<a name="idp213891776"></a>JAVA Date & Time Library Quick Reference</h4> +<a name="idp189532944"></a>JAVA Date & Time Library Quick Reference</h4> <p> </p> <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: bullet; "> @@ -531,7 +531,7 @@ Timeperiod shift Duration --> Timeperiod <p> </p> <a name="script_libs"></a><h4> -<a name="idp213901232"></a>Scripting Language Libraries</h4> +<a name="idp189542400"></a>Scripting Language Libraries</h4> <p> </p> <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: bullet; "> @@ -550,7 +550,7 @@ Timeperiod shift Duration --> Timeperiod <p> </p> <a name="related"></a><h4> -<a name="idp213908688"></a>Related Commercial and Fanciful Pages</h4> +<a name="idp189549856"></a>Related Commercial and Fanciful Pages</h4> <p> </p> <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: bullet; "> @@ -566,7 +566,7 @@ Timeperiod shift Duration --> Timeperiod <p> </p> <a name="resolution"></a><h4> -<a name="idp213915856"></a>Resolution, Precision, and Accuracy</h4> +<a name="idp189557024"></a>Resolution, Precision, and Accuracy</h4> <p> </p> <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: bullet; "> @@ -589,12 +589,12 @@ Timeperiod shift Duration --> Timeperiod <a class="link" href="details.html#other_boost_libs">Required Boost Libraries</a> </p> <a name="overview"></a><h4> -<a name="idp213926784"></a>Overview</h4> +<a name="idp189567808"></a>Overview</h4> <p> The library has a few functions that require the creation of a library file (mostly to_string, from_string functions). Most library users can make effective use of the library WITHOUT building the library, but simply including the required headers. If the library is needed, the Jamfile in the build directory will produce a "static" library (libboost_date_time) and a "dynamic/shared" library (boost_date_time) that contains these functions. Note that to use the library without the library (particularly on windows) may require using the BOOST_DATE_TIME_NO_LIB flag to the compilation options. </p> <a name="compile_options"></a><h4> -<a name="idp213929168"></a>Compilation Options</h4> +<a name="idp189570192"></a>Compilation Options</h4> <p> By default the posix_time system uses a single 64 bit integer internally to provide a microsecond level resolution. As an alternative, a combination of a 64 bit integer and a 32 bit integer (96 bit resolution) can be used to provide nano-second level resolutions. The default implementation may provide better performance and more compact memory usage for many applications that do not require nano-second resolutions. </p> @@ -605,7 +605,7 @@ Timeperiod shift Duration --> Timeperiod <p>As a convenience, <code class="computeroutput">date_time</code> has provided some <a class="link" href="gregorian.html#additional_duration_types">additional duration types</a>. Use of these types may have unexpected results due to the snap-to-end-of-month behavior (see <a class="link" href="gregorian.html#snap_to_details">Reversibility of Operations Pitfall</a> for complete details and examples). These types are enabled by default. To disable these types, simply undefine <code class="computeroutput">BOOST_DATE_TIME_OPTIONAL_GREGORIAN_TYPES</code> in your project file.</p> <p>Another convenience is the default constructors for <code class="computeroutput"><a class="link" href="gregorian.html#date_time.gregorian.date_class" title="Date">date</a></code>, and <code class="computeroutput"><a class="link" href="posix_time.html#date_time.posix_time.ptime_class" title="Ptime">ptime</a></code>. These constructors are enabled by default. To disable them, simply define <code class="computeroutput">DATE_TIME_NO_DEFAULT_CONSTRUCTOR</code> in your project file.</p> <a name="portability"></a><h4> -<a name="idp213941776"></a>Compiler/Portability Notes</h4> +<a name="idp189582800"></a>Compiler/Portability Notes</h4> <p> The Boost Date-Time library has been built and tested with many compilers and platforms. However, some compilers and standard libraries have issues. While some of these issues can be worked around, others are difficult to work around. The following compilers are known to fully support all aspects of the library: </p> @@ -666,7 +666,7 @@ Timeperiod shift Duration --> Timeperiod <p> </p> <h6> -<a name="idp213957168"></a>Visual Studio & STLPort</h6> +<a name="idp189598512"></a>Visual Studio & STLPort</h6> <p>There is a known issue with Visual Studio (7.0 & 7.1) and STLPort. The build errors typically make reference to a type issue or 'no acceptable conversion' and are attempting to instantiate a template with <code class="computeroutput">wchar_t</code>. The default build of STLPort does not support <code class="computeroutput">wchar_t</code>. There are two possible workarounds for this issue. The simplest is the user can build date_time with no wide stream/string etc. The other is to rebuild STLPort with wchar_t support. </p> <p>To build date_time with no wide stream/string etc, execute the following command from <code class="computeroutput">$BOOST_ROOT</code>: @@ -686,28 +686,28 @@ Timeperiod shift Duration --> Timeperiod (replace the ellipsis with the correct paths for the build system and adjust the <code class="computeroutput">TOOLS</code> to the proper toolset if necessary) </p> <a name="dir_structure"></a><h4> -<a name="idp213968896"></a>Directory Structure</h4> +<a name="idp189610176"></a>Directory Structure</h4> <p> The directory tree has the following structure: </p> -<pre class="programlisting">/boost/date_time -- common headers and template code -/boost/date_time/gregorian -- Gregorian date system header files -/boost/date_time/posix_time -- Posix time system headers -/boost/date_time/local_time -- Local time system headers -/libs/date_time/build -- build files and output directory -/libs/date_time/test -- test battery for generic code -/libs/date_time/test/gregorian -- test battery for the Gregorian system -/libs/date_time/test/posix_time -- test battery for the posix_time system -/libs/date_time/test/local_time -- test battery for the local_time system -/libs/date_time/examples/gregorian -- example programs for dates -/libs/date_time/examples/posix_time -- time example programs -/libs/date_time/examples/local_time -- nifty example programs -/libs/date_time/src/gregorian -- cpp files for libboost_date_time -/libs/date_time/src/posix_time -- empty (one file, but no source code...)</pre> +<pre class="programlisting">/boost/date_time -- common headers and template code +/boost/date_time/gregorian -- Gregorian date system header files +/boost/date_time/posix_time -- Posix time system headers +/boost/date_time/local_time -- Local time system headers +/libs/date_time/build -- build files and output directory +/libs/date_time/test -- test battery for generic code +/libs/date_time/test/gregorian -- test battery for the Gregorian system +/libs/date_time/test/posix_time -- test battery for the posix_time system +/libs/date_time/test/local_time -- test battery for the local_time system +/libs/date_time/example/gregorian -- example programs for dates +/libs/date_time/example/posix_time -- time example programs +/libs/date_time/example/local_time -- nifty example programs +/libs/date_time/src/gregorian -- cpp files for libboost_date_time +/libs/date_time/src/posix_time -- empty (one file, but no source code...)</pre> <p> </p> <a name="other_boost_libs"></a><h4> -<a name="idp213973392"></a>Required Boost Libraries</h4> +<a name="idp189613664"></a>Required Boost Libraries</h4> <p> Various parts of date-time depend on other boost libraries. These include: </p> @@ -744,7 +744,7 @@ Timeperiod shift Duration --> Timeperiod <div class="titlepage"><div><div><h3 class="title"> <a name="date_time.changes"></a>Change History</h3></div></div></div> <h4> -<a name="idp213986224"></a>Changes from Boost 1.41 to 1.44 (date_time 1.08 to 1.09)</h4> +<a name="idp189626560"></a>Changes from Boost 1.41 to 1.44 (date_time 1.08 to 1.09)</h4> <div class="informaltable"><table class="table"> <colgroup> <col> @@ -764,7 +764,7 @@ Timeperiod shift Duration --> Timeperiod </tr></tbody> </table></div> <h4> -<a name="idp213992368"></a>Changes from Boost 1.40 to 1.41 (date_time 1.07 to 1.08)</h4> +<a name="idp189632704"></a>Changes from Boost 1.40 to 1.41 (date_time 1.07 to 1.08)</h4> <div class="informaltable"><table class="table"> <colgroup> <col> @@ -796,7 +796,7 @@ Timeperiod shift Duration --> Timeperiod </tbody> </table></div> <h4> -<a name="idp214002640"></a>Changes from Boost 1.38 to 1.40 (date_time 1.06 to 1.07)</h4> +<a name="idp189642976"></a>Changes from Boost 1.38 to 1.40 (date_time 1.06 to 1.07)</h4> <div class="informaltable"><table class="table"> <colgroup> <col> @@ -817,7 +817,7 @@ Timeperiod shift Duration --> Timeperiod </tr></tbody> </table></div> <h4> -<a name="idp214010864"></a>Changes from Boost 1.34 to 1.38 (date_time 1.05 to 1.06)</h4> +<a name="idp189651200"></a>Changes from Boost 1.34 to 1.38 (date_time 1.05 to 1.06)</h4> <div class="informaltable"><table class="table"> <colgroup> <col> @@ -931,7 +931,7 @@ Timeperiod shift Duration --> Timeperiod </tbody> </table></div> <h4> -<a name="idp214046256"></a>Changes from Boost 1.33 to 1.34 (date_time 1.04 to 1.05)</h4> +<a name="idp189686592"></a>Changes from Boost 1.33 to 1.34 (date_time 1.04 to 1.05)</h4> <div class="informaltable"><table class="table"> <colgroup> <col> @@ -1019,7 +1019,7 @@ Timeperiod shift Duration --> Timeperiod </tbody> </table></div> <h4> -<a name="idp214066560"></a>Changes from Boost 1.32 to 1.33 (date_time 1.03 to 1.04)</h4> +<a name="idp189706896"></a>Changes from Boost 1.32 to 1.33 (date_time 1.03 to 1.04)</h4> <div class="informaltable"><table class="table"> <colgroup> <col> @@ -1159,7 +1159,7 @@ void save_to(archive_type& ar, </tbody> </table></div> <h4> -<a name="idp214126400"></a>Changes from Boost 1.31 to 1.32 (date_time 1.02 to 1.03)</h4> +<a name="idp189766736"></a>Changes from Boost 1.31 to 1.32 (date_time 1.02 to 1.03)</h4> <div class="informaltable"><table class="table"> <colgroup> <col> @@ -1354,7 +1354,7 @@ ws >> d; //Feb 29th, 2000</pre> </tbody> </table></div> <h4> -<a name="idp214168608"></a>Changes from Boost 1.30 to 1.31 (date_time 1.01 to 1.02)</h4> +<a name="idp189808944"></a>Changes from Boost 1.30 to 1.31 (date_time 1.01 to 1.02)</h4> <div class="informaltable"><table class="table"> <colgroup> <col> @@ -1443,7 +1443,7 @@ td = -td; //-5 hours</pre> </tbody> </table></div> <h4> -<a name="idp214202656"></a>Changes from Boost 1.29 to 1.30 (date_time 1.00 to 1.01)</h4> +<a name="idp189842992"></a>Changes from Boost 1.29 to 1.30 (date_time 1.00 to 1.01)</h4> <p> Notice: The interface to the partial_date class (see <a class="link" href="gregorian.html#date_time.gregorian.date_algorithms" title="Date Generators/Algorithms">date_algorithms</a>) was changed. The order of construction parameters was changed which will cause some code to fail execution. This change was made to facilitate more generic local time adjustment code. Thus instead of specifying partial_date pd(Dec,25) the code needs to be changed to partial_date pd(25, Dec); </p> |