[boost-doc-zh] r362 committed - 翻译 date_time 库的xml文件
- From: boost-doc-zh@xxxxxxxxxxxxxx
- To: boost-doc-zh-notify@xxxxxxxxxxxxx
- Date: Thu, 07 Jan 2010 01:27:45 +0000
Revision: 362
Author: alai04
Date: Wed Jan 6 17:26:22 2010
Log: 翻译 date_time 库的xml文件
http://code.google.com/p/boost-doc-zh/source/detail?r=362
Modified:
/trunk/libs/date_time/xmldoc/acknowledgements.xml
/trunk/libs/date_time/xmldoc/buildinfo.xml
/trunk/libs/date_time/xmldoc/calculations.xml
/trunk/libs/date_time/xmldoc/changes.xml
/trunk/libs/date_time/xmldoc/conceptual.xml
/trunk/libs/date_time/xmldoc/custom_time_zone.xml
/trunk/libs/date_time/xmldoc/date_algorithms.xml
/trunk/libs/date_time/xmldoc/date_class.xml
/trunk/libs/date_time/xmldoc/date_duration.xml
/trunk/libs/date_time/xmldoc/date_facet.xml
/trunk/libs/date_time/xmldoc/date_input_facet.xml
/trunk/libs/date_time/xmldoc/date_iterators.xml
/trunk/libs/date_time/xmldoc/date_period.xml
/trunk/libs/date_time/xmldoc/date_time.xml
/trunk/libs/date_time/xmldoc/date_time_io.xml
/trunk/libs/date_time/xmldoc/design_concepts.xml
/trunk/libs/date_time/xmldoc/design_goals.xml
/trunk/libs/date_time/xmldoc/details.xml
/trunk/libs/date_time/xmldoc/domain_concepts.xml
/trunk/libs/date_time/xmldoc/doxy.xml
/trunk/libs/date_time/xmldoc/ex_calc_rules.xml
/trunk/libs/date_time/xmldoc/ex_date_period_calc.xml
/trunk/libs/date_time/xmldoc/ex_dates_as_strings.xml
/trunk/libs/date_time/xmldoc/ex_days_alive.xml
/trunk/libs/date_time/xmldoc/ex_days_between_new_years.xml
/trunk/libs/date_time/xmldoc/ex_find_last_day_of_months.xml
/trunk/libs/date_time/xmldoc/ex_flight.xml
/trunk/libs/date_time/xmldoc/ex_local_utc_conversion.xml
/trunk/libs/date_time/xmldoc/ex_localization.xml
/trunk/libs/date_time/xmldoc/ex_month_add.xml
/trunk/libs/date_time/xmldoc/ex_print_holidays.xml
/trunk/libs/date_time/xmldoc/ex_print_hours.xml
/trunk/libs/date_time/xmldoc/ex_print_month.xml
/trunk/libs/date_time/xmldoc/ex_seconds_since_epoch.xml
/trunk/libs/date_time/xmldoc/ex_simple_time_zone.xml
/trunk/libs/date_time/xmldoc/ex_time_math.xml
/trunk/libs/date_time/xmldoc/ex_time_periods.xml
/trunk/libs/date_time/xmldoc/examples.xml
/trunk/libs/date_time/xmldoc/format_flags.xml
/trunk/libs/date_time/xmldoc/gregorian.xml
/trunk/libs/date_time/xmldoc/gregorian_calendar.xml
/trunk/libs/date_time/xmldoc/io_objects.xml
/trunk/libs/date_time/xmldoc/io_tutorial.xml
/trunk/libs/date_time/xmldoc/local_date_time.xml
/trunk/libs/date_time/xmldoc/local_time.xml
/trunk/libs/date_time/xmldoc/local_time_period.xml
/trunk/libs/date_time/xmldoc/motivation.xml
/trunk/libs/date_time/xmldoc/posix_time.xml
/trunk/libs/date_time/xmldoc/posix_time_zone.xml
/trunk/libs/date_time/xmldoc/ptime_class.xml
/trunk/libs/date_time/xmldoc/references.xml
/trunk/libs/date_time/xmldoc/serialization.xml
/trunk/libs/date_time/xmldoc/terminology.xml
/trunk/libs/date_time/xmldoc/tests.xml
/trunk/libs/date_time/xmldoc/time_duration.xml
/trunk/libs/date_time/xmldoc/time_facet.xml
/trunk/libs/date_time/xmldoc/time_input_facet.xml
/trunk/libs/date_time/xmldoc/time_iterators.xml
/trunk/libs/date_time/xmldoc/time_period.xml
/trunk/libs/date_time/xmldoc/time_zone_base.xml
/trunk/libs/date_time/xmldoc/tradeoffs.xml
/trunk/libs/date_time/xmldoc/tz_database.xml
/trunk/libs/date_time/xmldoc/usage_examples.xml
=======================================
--- /trunk/libs/date_time/xmldoc/acknowledgements.xml Mon Dec 28 23:05:14
2009
+++ /trunk/libs/date_time/xmldoc/acknowledgements.xml Wed Jan 6 17:26:22
2010
@@ -1,16 +1,14 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!DOCTYPE library PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN"
-"../../../tools/boostbook/dtd/boostbook.dtd">
-
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE library PUBLIC "-//Boost//DTD BoostBook XML
V1.0//EN" "../../../tools/boostbook/dtd/boostbook.dtd" >
<!-- Copyright (c) 2001-2004 CrystalClear Software, Inc.
Subject to the Boost Software License, Version 1.0.
(See accompanying file LICENSE_1_0.txt or
http://www.boost.org/LICENSE_1_0.txt)
-->
-
<section id="date_time.acknowledgements">
- <title>Acknowledgements</title>
+ <title>Acknowledgements 鸣谢</title>
<para>
- Many people have contributed to the development of this library. In
particular Hugo Duncan and Joel de Guzman for help with porting to various
compilers. For initial development of concepts and design Corwin Joy and
Michael Kenniston deserve special thanks. Also extra thanks to Michael for
writing up the theory and tradeoffs part of the documentation. Dave Zumbro
for initial inspiration and sage thoughts. Many thanks to boost reviewers
and users including: William Seymour, Kjell Elster, Beman Dawes, Gary
Powell, Andrew Maclean, William Kempf, Peter Dimov, Chris Little, David
Moore, Darin Adler, Gennadiy Rozental, Joachim Achtzehnter, Paul Bristow,
Jan Langer, Mark Rodgers, Glen Knowles, Matthew Denman, and George
Heintzelman.
+ Many people have contributed to the development of this library. In
particular Hugo Duncan and Joel de Guzman for help with porting to various
compilers. For initial development of concepts and design Corwin Joy and
Michael Kenniston deserve special thanks. Also extra thanks to Michael for
writing up the theory and tradeoffs part of the documentation. Dave Zumbro
for initial inspiration and sage thoughts. Many thanks to boost reviewers
and users including: William Seymour, Kjell Elster, Beman Dawes, Gary
Powell, Andrew Maclean, William Kempf, Peter Dimov, Chris Little, David
Moore, Darin Adler, Gennadiy Rozental, Joachim Achtzehnter, Paul Bristow,
Jan Langer, Mark Rodgers, Glen Knowles, Matthew Denman, and George
Heintzelman. <sbr></sbr>
+ 许多人对本库的开发作出了贡献。Hugo Duncan 和 Joel de Guzman 为本库移植
到各种编译器给予了帮助。而概念和设计的初期开发则要感谢 Corwin Joy 和
Michael Kenniston。另外还要感谢 Michael 编写了本文档的理论和权衡部分。初期的
灵感和思想来自 Dave Zumbro。非常感谢 boost 详审员和用户，包括：William
Seymour, Kjell Elster, Beman Dawes, Gary Powell, Andrew Maclean, William
Kempf, Peter Dimov, Chris Little, David Moore, Darin Adler, Gennadiy
Rozental, Joachim Achtzehnter, Paul Bristow, Jan Langer, Mark Rodgers, Glen
Knowles, Matthew Denman, 和 George Heintzelman。
</para>
</section>
=======================================
--- /trunk/libs/date_time/xmldoc/buildinfo.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/buildinfo.xml Wed Jan 6 17:26:22 2010
@@ -8,40 +8,61 @@
-->
<section id="date_time.buildinfo">
- <title>Build-Compiler Information</title>
+ <title>Build-Compiler Information 构建和编译器信息</title>
<para>
- <link linkend="overview">Overview</link> --
- <link linkend="compile_options">Compilation Options</link> --
- <link linkend="portability">Compiler/Portability Notes</link> --
- <link linkend="dir_structure">Directory Structure</link> --
- <link linkend="other_boost_libs">Required Boost Libraries</link>
+ <link linkend="overview">Overview 简介</link> --
+ <link linkend="compile_options">Compilation Options 编译选项</link> --
+ <link linkend="portability">Compiler/Portability Notes 编译器/可移植性
说明</link> --
+ <link linkend="dir_structure">Directory Structure 目录结构</link> --
+ <link linkend="other_boost_libs">Required Boost Libraries 所需的
Boost库 </link>
</para>
<anchor id="overview" />
- <bridgehead renderas="sect3">Overview</bridgehead>
+ <bridgehead renderas="sect3">Overview 简介</bridgehead>
<para>
- 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.
+ 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. <sbr/>
+ 本库中有少量函数需要创建库文件(主要是 to_string, from_string 函数)。大
多数库用户无需构建库文件就可以正确地使用本库，
+ 只需要包含所需的头文件即可。如果需要库文件，位于 build 目录下的
Jamfile 将生成一个"静态"库(libboost_date_time)
+ 以及一个"动态/共享"库(boost_date_time)，其中包含了这些函数。
</para>
<anchor id="compile_options" />
- <bridgehead renderas="sect3">Compilation Options</bridgehead>
+ <bridgehead renderas="sect3">Compilation Options 编译选项</bridgehead>
<para>
- 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.
+ 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. <sbr/>
+ 缺省情况下，posix_time 系统内部使用一个64位整数来提供微秒级的解析度。作
为另一个选择，
+ 使用一个64位整数加一个32位整数(共96位精度)，可以提供纳秒级的解析度。
+ 缺省实现可以提供更好的性能和最小的内存占用，多数应用程序并不需要纳秒级
的解析度。
</para>
<para>
- To use the alternate resolution (96 bit nanosecond) the variable
<code>BOOST_DATE_TIME_POSIX_TIME_STD_CONFIG</code> must be defined in the
library users project files (ie Makefile, Jamfile, etc). This macro is not
used by the Gregorian system and therefore has no effect when building the
library.
+ To use the alternate resolution (96 bit nanosecond) the variable
<code>BOOST_DATE_TIME_POSIX_TIME_STD_CONFIG</code> must be defined in the
library users project files (ie Makefile, Jamfile, etc). This macro is not
used by the Gregorian system and therefore has no effect when building the
library.<sbr/>
+ 要使用更高的解析度(96位纳秒级别)，必须在库用户的工程文件(如 Makefile,
Jamfile, 等等)中定义变量
+ BOOST_DATE_TIME_POSIX_TIME_STD_CONFIG. 该宏并不被格里历系统使用，因此在
构建本库时没有作用。
</para>
- <para>As of version 1.33, the date_time library introduced a new IO
streaming system. Some compilers are not capable of utilizing this new
system. For those compilers the earlier ("legacy") IO system is still
available. Non-supported compilers will select the legacy system
automatically but the user can force the usage of the legacy system by
defining <code>USE_DATE_TIME_PRE_1_33_FACET_IO</code>.</para>
-
- <para>As a convenience, <code>date_time</code> has provided some <link
linkend="additional_duration_types">additional duration types</link>. Use
of these types may have unexpected results due to the snap-to-end-of-month
behavior (see <link linkend="snap_to_details">Reversibility of Operations
Pitfall</link> for complete details and examples). These types are enabled
by default. To disable these types, simply undefine
<code>BOOST_DATE_TIME_OPTIONAL_GREGORIAN_TYPES</code> in your project
file.</para>
-
- <para>Another convenience is the default constructors for <code><link
linkend="date_time.gregorian.date_class">date</link></code>, and
<code><link linkend="date_time.posix_time.ptime_class">ptime</link></code>.
These constructors are enabled by default. To disable them, simply define
<code>DATE_TIME_NO_DEFAULT_CONSTRUCTOR</code> in your project file.</para>
+ <para>As of version 1.33, the date_time library introduced a new IO
streaming system. Some compilers are not capable of utilizing this new
system. For those compilers the earlier ("legacy") IO system is still
available. Non-supported compilers will select the legacy system
automatically but the user can force the usage of the legacy system by
defining <code>USE_DATE_TIME_PRE_1_33_FACET_IO</code>.<sbr/>
+ 和版本1.33一样，date_time 库引入了一个新的IO流系统。有些编译器不能使用这
个新系统。对于这些编译器，
+ 早期的("遗留")IO系统仍然可用。不被支持的编译器将自动选择遗留系统，但用户
也可以通过定义
+ <code>USE_DATE_TIME_PRE_1_33_FACET_IO</code> 来强制使用遗留系统。</para>
+
+ <para>As a convenience, <code>date_time</code> has provided some <link
linkend="additional_duration_types">additional duration types</link>. Use
of these types may have unexpected results due to the snap-to-end-of-month
behavior (see <link linkend="snap_to_details">Reversibility of Operations
Pitfall</link> for complete details and examples). These types are enabled
by default. To disable these types, simply undefine
<code>BOOST_DATE_TIME_OPTIONAL_GREGORIAN_TYPES</code> in your project
file.<sbr/>
+ 为方便使用，<code>date_time</code> 提供了一些 <link
linkend="additional_duration_types">额外的时间长度类型</link>。
+ 使用这些类型可能会由于“保持为月末”的行为而导致意外结果(完整细节和例子请见
+ <link linkend="snap_to_details">操作可逆性的缺陷</link>)。缺省情况下，这
些类型都是可用的。
+ 要禁止这些类型，只需在你的工程文件中去定义
<code>BOOST_DATE_TIME_OPTIONAL_GREGORIAN_TYPES</code> 即可。</para>
+
+ <para>Another convenience is the default constructors for <code><link
linkend="date_time.gregorian.date_class">date</link></code>, and
<code><link linkend="date_time.posix_time.ptime_class">ptime</link></code>.
These constructors are enabled by default. To disable them, simply define
<code>DATE_TIME_NO_DEFAULT_CONSTRUCTOR</code> in your project file.<sbr/>
+ 另一个方便的用法是 <code><link
linkend="date_time.gregorian.date_class">date</link></code> 和
+ <code><link
linkend="date_time.posix_time.ptime_class">ptime</link></code> 的缺省构造函
数。
+ 缺省情况下这些构造函数是可用的。要禁止它们，只需在你的工程文件中定义
<code>DATE_TIME_NO_DEFAULT_CONSTRUCTOR</code>
+ 即可。</para>
<anchor id="portability" />
- <bridgehead renderas="sect3">Compiler/Portability Notes</bridgehead>
+ <bridgehead renderas="sect3">Compiler/Portability Notes 编译器/可移植性说
明</bridgehead>
<para>
- 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:
+ 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:<sbr/>
+ Boost Date-Time 库已经在多个编译器和平台上进行了构建和测试。但是，有些
编译器和标准库存在问题。
+ 而这些问题中有些可以绕过，其它一些则很难绕过。以下编译器已知完全支持本
库：
<itemizedlist mark="bullet">
<listitem>Codewarrior 9.4 Windows</listitem>
<listitem>GCC 3.2 - 3.4, 4.x on Linux</listitem>
@@ -61,7 +82,10 @@
to avoid this as much as possible, but if you are using the legacy IO
option
(NOT the default with VC8) then the issue can still arise. See the
- <ulink
url="http://lists.boost.org/Archives/boost/2006/02/101122.php";>mailing list
archive</ulink> for more details.
+ <ulink
url="http://lists.boost.org/Archives/boost/2006/02/101122.php";>mailing list
archive</ulink> for more details.<sbr/>
+ 不幸的是，VC8 编译器对于 date-time 代码有些问题。其中最严重的问题
是，在引入VC8标准库的 basic_stream
+ 代码时存在内存泄漏。Date-time 的代码已经尽可能作出修改以避免这一问
题，但如果你使用遗留IO选项(这不是VC8的缺省选项)，
+ 那么问题仍会出现。更多细节请见 <ulink
url="http://lists.boost.org/Archives/boost/2006/02/101122.php";>邮件列表存档
</ulink>。
</para>
<para>
@@ -71,12 +95,15 @@
restriction added in the VC8. The effect is that dates prior to the
year
1900 will cause exceptions. There is, unfortunately, no easy
workaround for
this issue. Note that the new 64bit version of the VC8 compiler
- does not appear to have this limitation.
+ does not appear to have this limitation. <sbr/>
+ 除了以上问题，有些版本的VC8库限制了 <code>std::tm</code> 结构中的值为
正值。这是VC8中新增的限制。产生的影响是，
+ 1900年以前的日期将引发异常。不幸的是，这一问题没有替代方案。注意，新的
64位版本VC8编译器不再存在这一限制。
</para>
<para>
These compilers support all aspects of the library except
<code>wstring/wstream</code>
- output.
+ output.<sbr/>
+ 以下编译器支持本库除 <code>wstring/wstream</code> 输出以外的所有功能。
<itemizedlist mark="bullet">
<listitem>MinGW 3.2, 3.4, 3.5 *</listitem>
<listitem>GCC 3.2 (cygwin) *</listitem>
@@ -84,14 +111,17 @@
</para>
<para>
- In particular, a lack of support for standard locales limits the
ability of the library to support iostream based input output. For these
compilers a set of more limited string based input-output is provided. Some
compilers/standard libraries with this limitation include:
+ In particular, a lack of support for standard locales limits the
ability of the library to support iostream based input output. For these
compilers a set of more limited string based input-output is provided. Some
compilers/standard libraries with this limitation include: <sbr/>
+ 特别地，缺乏标准 locales 支持将会限制本库的能力，无法支持基于 iostream
的输入输出。
+ 对于这些编译器，我们提供一组更为有限的基于字符串的输入输出。具有这种限
制的编译器/标准库包括：
<itemizedlist mark="bullet">
<listitem>Borland 5.6</listitem>
</itemizedlist>
</para>
<para>
- Official support for some older compilers has now been dropped. This
includes:
+ Official support for some older compilers has now been dropped. This
includes:<sbr/>
+ 对一些较老的编译器的官方支持现在已被停止。它们包括：
<itemizedlist mark="bullet">
<listitem>GCC 2.9x</listitem>
<listitem>Borland 5.1.1</listitem>
@@ -100,45 +130,56 @@
</para>
<bridgehead renderas="sect5">Visual Studio & STLPort</bridgehead>
- <para>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>wchar_t</code>. The default build of STLPort does not support
<code>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.
+ <para>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>wchar_t</code>. The default build of STLPort does not support
<code>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.<sbr/>
+ 对于 Visual Studio (7.0 & 7.1) 和 STLPort，有一个著名的问题。构建错误
通常会指向一个类型问题或
+ 'no acceptable conversion' 以及试图以 <code>wchar_t</code> 实例化一个模
板。STLPort 的缺省构建并不支持
+ <code>wchar_t</code>. 这个问题有两个解决方法。最简单的方法是，用法可以构
建不带宽字符流/宽字符串的 date_time.
+ 另一个方法是，重建 STLPort 以支持 wchar_t.
</para>
- <para>To build date_time with no wide stream/string etc, execute the
following command from <code>$BOOST_ROOT</code>:
+ <para>To build date_time with no wide stream/string etc, execute the
following command from <code>$BOOST_ROOT</code>:<sbr/>
+ 要构建不带宽字符流/宽字符串的 date_time, 在 <code>$BOOST_ROOT</code> 下执
行以下命令：
<screen>bjam -a "-sTOOLS=vc-7_1-stlport" "-sSTLPORT_PATH=..." \
"-sBUILD=<define>BOOST_NO_STD_WSTRING" \
--stagedir=... --with-date_time stage</screen>
- (replace the ellipsis with the correct paths for the build system and
adjust the <code>TOOLS</code> to the proper toolset if necessary)
+ (replace the ellipsis with the correct paths for the build system and
adjust the <code>TOOLS</code> to the proper toolset if necessary)<sbr/>
+ (将省略号换为构建系统的正确路径，有需要时将 <code>TOOLS</code> 调整为正
确的工具集)
</para>
- <para>Rebuilding STLPort with <code>wchar_t</code> support involves
placing <code>/Zc:wchar_t</code> in the STLPort makefile. Date_time should
then be built with the following command from <code>$BOOST_ROOT</code>:
+ <para>Rebuilding STLPort with <code>wchar_t</code> support involves
placing <code>/Zc:wchar_t</code> in the STLPort makefile. Date_time should
then be built with the following command from
<code>$BOOST_ROOT</code>:<sbr/>
+ 要重建 STLPort 以支持 <code>wchar_t</code>，只需在 STLPort 的 makefile中
指定 <code>/Zc:wchar_t</code>.
+ 然后从 <code>$BOOST_ROOT</code> 执行以下命令以构建 Date_time:
<screen>bjam -a "-sTOOLS=vc-7_1-stlport" "-sSTLPORT_PATH=..." \
"-sBUILD=&native-wchar_t>on" \
--stagedir=... --with-date_time stage</screen>
- (replace the ellipsis with the correct paths for the build system and
adjust the <code>TOOLS</code> to the proper toolset if necessary)
+ (replace the ellipsis with the correct paths for the build system and
adjust the <code>TOOLS</code> to the proper toolset if necessary)<sbr/>
+ (将省略号换为构建系统的正确路径，有需要时将 <code>TOOLS</code> 调整为正
确的工具集)
</para>
<anchor id="dir_structure" />
- <bridgehead renderas="sect3">Directory Structure</bridgehead>
+ <bridgehead renderas="sect3">Directory Structure 目录结构</bridgehead>
<para>
- The directory tree has the following structure:
- <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...)</programlisting>
+ The directory tree has the following structure:<sbr/>
+ 目录树结构如下：
+ <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 Posix时间
系统头文件
+/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 posix_time系统的测试程序
+/libs/date_time/test/local_time -- test battery for the local_time
system local_time系统的测试程序
+/libs/date_time/examples/gregorian -- example programs for dates dates的
例子程序
+/libs/date_time/examples/posix_time -- time example programs time的例子程
序
+/libs/date_time/examples/local_time -- nifty example programs nifty的例子
程序
+/libs/date_time/src/gregorian -- cpp files for libboost_date_time
libboost_date_time 的cpp文件
+/libs/date_time/src/posix_time -- empty (one file, but no source
code...) 空 (有一个文件，但无源代码...)</programlisting>
</para>
<anchor id="other_boost_libs" />
- <bridgehead renderas="sect3">Required Boost Libraries</bridgehead>
+ <bridgehead renderas="sect3">Required Boost Libraries 所需的 Boost 库
</bridgehead>
<para>
- Various parts of date-time depend on other boost libraries. These
include:
+ Various parts of date-time depend on other boost libraries. These
include:<sbr/>
+ date-time 的各个部分依赖于某些 boost 库。它们包括：
<itemizedlist mark="bullet">
<listitem><ulink
url="../../libs/tokenizer/index.html">boost.tokenizer</ulink> </listitem>
<listitem><ulink
url="../../libs/integer/cstdint.htm">boost.integer(cstdint)</ulink>
</listitem>
@@ -148,6 +189,7 @@
<listitem><ulink
url="../../libs/algorithm/string/">boost::string_algorithms </ulink>
</listitem>
<listitem><ulink
url="../../libs/serialization/index.html">boost::serialize (serialization
code only) </ulink> </listitem>
</itemizedlist>
- so these libraries need to be installed.
+ so these libraries need to be installed. <sbr/>
+ 所以这些库必须被安装。
</para>
</section>
=======================================
--- /trunk/libs/date_time/xmldoc/calculations.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/calculations.xml Wed Jan 6 17:26:22 2010
@@ -8,24 +8,26 @@
-->
<section id="date_time.calculations">
- <title>Calculations</title>
+ <title>Calculations 运算</title>
<para>
- <link linkend="timepoints">Timepoints</link> --
- <link linkend="durations">Durations</link> --
- <link linkend="intervals">Intervals (Periods)</link> --
- <link linkend="special_value_handling">Special Value Handling</link>
+ <link linkend="timepoints">Timepoints 时间点</link> --
+ <link linkend="durations">Durations 时长</link> --
+ <link linkend="intervals">Intervals (Periods) 时间间隔(时间段) </link>
--
+ <link linkend="special_value_handling">Special Value Handling 特殊值的
处理 </link>
</para>
<anchor id="timepoints" />
- <bridgehead renderas="sect3">Timepoints</bridgehead>
+ <bridgehead renderas="sect3">Timepoints 时间点</bridgehead>
<para>
- 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:
+ 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:<sbr/>
+ 本节描述一些用于时间点的基本算术规则。通常，时间点支持以下与时长的基本
算术操作：
<programlisting>
Timepoint + Duration --> Timepoint
Timepoint - Duration --> Timepoint
Timepoint - Timepoint --> Duration
</programlisting>
- Unlike regular numeric types, the following operations are undefined:
+ Unlike regular numeric types, the following operations are
undefined:<sbr/>
+ 和普通的算术类型不同，以下操作是未定义的：
<programlisting>
Duration + Timepoint --> Undefined
Duration - Timepoint --> Undefined
@@ -33,31 +35,35 @@
</programlisting>
</para>
<anchor id="durations" />
- <bridgehead renderas="sect3">Durations</bridgehead>
+ <bridgehead renderas="sect3">Durations 时长</bridgehead>
<para>
- 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:
+ 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:<sbr/>
+ 时长表示一段时间的长度，它的值可正可负。它通常会与另一个时长或者简单的
整数值进行运算。以下描述了这些运算：
<programlisting>
Duration + Duration --> Duration
Duration - Duration --> Duration
Duration * Integer --> Duration
Integer * Duration --> Duration
- Duration / Integer --> Duration (Integer Division rules)
+ Duration / Integer --> Duration (Integer Division rules 整数除法规
则)
</programlisting>
</para>
<anchor id="intervals" />
- <bridgehead renderas="sect3">Intervals (Periods)</bridgehead>
+ <bridgehead renderas="sect3">Intervals (Periods) 时间间隔(时间段)
</bridgehead>
<para>
- 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:
+ 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: <sbr/>
+ 时间间隔对于简化日期和时间的很多'运算'是非常有用的。下面描述了基于半开
区间的时间段所提供的操作。
+ 以下操作基于两个输入时间段计算得到新的时间段：
<programlisting>
Timeperiod intersection Timeperiod --> Timeperiod
- (null interval if no intersection)
+ (null interval if no intersection 如果不相交则为空时间段)
Timeperiod merge Timeperiod --> Timeperiod
- (null interval if no intersection)
+ (null interval if no intersection 如果不相交则为空时间段)
Timeperiod shift Duration --> Timeperiod
- (shift start and end by duration amount)
+ (shift start and end by duration amount 将开始时间点和结束时间点位移一定
时长)
</programlisting>
- In addition, periods support various queries that calculate boolean
results. The first set is caluculations with other time periods:
+ In addition, periods support various queries that calculate boolean
results. The first set is caluculations with other time periods:<sbr/>
+ 另外，时间段支持多种查询操作，返回布尔类型的结果。第一组操作是与另一个
时间段进行运算：
<programlisting>
Timeperiod == Timeperiod --> bool
Timeperiod < Timeperiod --> bool (true if lhs.last <=
rhs.begin)
@@ -65,7 +71,8 @@
Timeperiod contains Timeperiod --> bool
Timeperiod is_adjacent Timeperiod --> bool
</programlisting>
- The following calculations are performed versus the Timepoint.
+ The following calculations are performed versus the Timepoint.<sbr/>
+ 以下是与时间点之间的运算：
<programlisting>
Timeperiod contains Timepoint --> bool
Timeperiod is_before Timepoint --> bool
@@ -73,16 +80,19 @@
</programlisting>
</para>
<anchor id="special_value_handling" />
- <bridgehead renderas="sect3">Special Value Handling</bridgehead>
+ <bridgehead renderas="sect3">Special Value Handling 特殊值的处理
</bridgehead>
<para>
- 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.
+ 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. <sbr/>
+ 让时长和时间点类型支持象无效日期时间(NADT)和无限时长这样的特殊值，对于
很多时间运算的问题来说是很有用的。通常，
+ 象无效日期时间(NADT)和无限时长这样的特殊值同样遵循浮点数的规则。注
意，你可以将系统配置为以抛出异常来替代 NADT 的结果。
<programlisting>
Timepoint(NADT) + Duration --> Timepoint(NADT)
Timepoint(∞) + Duration --> Timepoint(∞)
Timepoint + Duration(∞) --> Timepoint(∞)
Timepoint - Duration(∞) --> Timepoint(-∞)
</programlisting>
- When performing operations on both positive and negative infinities,
the library will produce results consistent with the following.
+ When performing operations on both positive and negative infinities,
the library will produce results consistent with the following. <sbr/>
+ 同时对正无限和负无限进行运算时，本库将产生以下结果：
<programlisting>
Timepoint(+∞) + Duration(-∞) --> NADT
Duration(+∞) + Duration(-∞) --> NADT
=======================================
--- /trunk/libs/date_time/xmldoc/changes.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/changes.xml Wed Jan 6 17:26:22 2010
@@ -8,7 +8,7 @@
-->
<section id="date_time.changes">
- <title>Change History</title>
+ <title>Change History 变更历史</title>
<!-- if each new change tgroup has a "Bug Fix" as the first "Type", the
columns will line up nicely -->
@@ -17,26 +17,30 @@
<tgroup cols="2">
<thead>
<row>
- <entry>Type</entry>
- <entry>Description</entry>
+ <entry>Type 类型</entry>
+ <entry>Description 说明</entry>
</row>
</thead>
<tbody>
<!--
<row>
- <entry>Feature</entry>
+ <entry>Feature 特性</entry>
<entry>
</entry>
</row>
-->
<row>
- <entry>Bug fix</entry>
+ <entry>Bug fix 缺陷修复</entry>
<entry>
Minor bug fixes (<ulink
url="https://svn.boost.org/trac/boost/ticket/2809";>#2809</ulink>,
<ulink
url="https://svn.boost.org/trac/boost/ticket/2824";>#2824</ulink>,
<ulink
url="https://svn.boost.org/trac/boost/ticket/3015";>#3015</ulink>,
- <ulink
url="https://svn.boost.org/trac/boost/ticket/3105";>#3105</ulink> and
others).
+ <ulink
url="https://svn.boost.org/trac/boost/ticket/3105";>#3105</ulink> and
others).<sbr/>
+ 次要缺陷修复(<ulink
url="https://svn.boost.org/trac/boost/ticket/2809";>#2809</ulink>,
+ <ulink
url="https://svn.boost.org/trac/boost/ticket/2824";>#2824</ulink>,
+ <ulink
url="https://svn.boost.org/trac/boost/ticket/3015";>#3015</ulink>,
+ <ulink
url="https://svn.boost.org/trac/boost/ticket/3105";>#3105</ulink> 及其它)。
</entry>
</row>
@@ -49,13 +53,13 @@
<tgroup cols="2">
<thead>
<row>
- <entry>Type</entry>
- <entry>Description</entry>
+ <entry>Type 类型</entry>
+ <entry>Description 说明</entry>
</row>
</thead>
<tbody>
<row>
- <entry>Feature</entry>
+ <entry>Feature 特性</entry>
<entry>
Added support for formatting and reading time durations longer
than 24 hours.
A new formatter <code>%O</code> is used indicate such long
durations in the
@@ -63,107 +67,129 @@
to represent durations that fit into two characters, in order
to retain support
for reading durations in ISO format. In case if it is detected
that the <code>%H</code>
format specifier is used with longer durations, the results
are not specified
- (an assertion in debug builds is raised).
+ (an assertion in debug builds is raised).<sbr/>
+ 增加了对长于24小时的时间长度的格式化和读入。使用一个新的格式化
符 <code>%O</code> 来表示格式化串中的较长时间跨度。
+ 为了保持对ISO格式的时间长度的读入，旧的 <code>%H</code> 格式化
符被限于所表示的时间长度必须适于2个字符的容量。
+ 如果检测到 <code>%H</code> 格式化符被用于较长的时间长度，则其结
果是未指定的(在调试构建中将触发一个断言)。
</entry>
</row>
<row>
- <entry>Bug fix</entry>
+ <entry>Bug fix 缺陷修复</entry>
<entry>
Added support for GCC 4.3. Several compilation issues were
solved, as well as
- compiler warnings were taken care of.
+ compiler warnings were taken care of.<sbr/>
+ 增加了对 GCC 4.3 的支持。解决了多个编译问题，并照顾到编译器的警
告信息。
</entry>
</row>
<row>
- <entry>Bug fix</entry>
+ <entry>Bug fix 缺陷修复</entry>
<entry>
- Added missing streaming operators for the
<code>local_time_period</code> class.
+ Added missing streaming operators for the
<code>local_time_period</code> class.<sbr/>
+ 增加了 <code>local_time_period</code> 类的流操作符。
</entry>
</row>
<row>
- <entry>Bug fix</entry>
+ <entry>Bug fix 缺陷修复</entry>
<entry>
Added several missing includes in different places. Some
includes that are
- not needed in some configurations were made conditional.
+ not needed in some configurations were made conditional.<sbr/>
+ 在多个不同地方增加了缺失的包含文件。在某些配置下可以不需要的包
含文件被设为条件性的。
</entry>
</row>
<row>
- <entry>Bug fix</entry>
+ <entry>Bug fix 缺陷修复</entry>
<entry>
Solved compilation problem that was caused by not finding
streaming operators
for <code>gregorian::date_duration</code> via ADL. The type is
now made actually
a class rather a typedef for the
<code>date_time::date_duration</code> template.
- The similar change was done for <code>gregorian::weeks</code>.
+ The similar change was done for
<code>gregorian::weeks</code>.<sbr/>
+ 解决了无法通过ADL查找到 <code>gregorian::date_duration</code>
的流操作符所引起的编译问题。
+ 该类型现在是一个真正的类，而不是
<code>date_time::date_duration</code> 模板的一个typedef了。
+ 对于 <code>gregorian::weeks</code>，也有相类似的修改。
</entry>
</row>
<row>
- <entry>Bug fix</entry>
+ <entry>Bug fix 缺陷修复</entry>
<entry>
Added a correctly spelled <code>date_time::hundredth</code>
time resolution enum
value. The old one <code>date_time::hundreth</code> is
considered deprecated and
- to be removed in future releases.
+ to be removed in future releases.<sbr/>
+ 增加了一个正确拼写的 <code>date_time::hundredth</code> 时间精度
枚举值。
+ 原有的 <code>date_time::hundreth</code> 建议不再使用，将在以后
的版本中删除。
</entry>
</row>
<row>
- <entry>Bug fix</entry>
+ <entry>Bug fix 缺陷修复</entry>
<entry>
Fixed compilation error in <code>format_date_parser.hpp</code>
because of incorrect
- stream type being used.
+ stream type being used.<sbr/>
+ 修正了 <code>format_date_parser.hpp</code> 中由于使用了不正确的
流类型所引起的编译错误。
</entry>
</row>
<row>
- <entry>Bug fix</entry>
+ <entry>Bug fix 缺陷修复</entry>
<entry>
On Windows platform made inclusion of <code>windows.h</code>
optional. The header is only used
when the <code>BOOST_USE_WINDOWS_H</code> macro is defined.
Otherwise (and by default),
- the library uses internal definitions of symbols from this
header.
+ the library uses internal definitions of symbols from this
header.<sbr/>
+ 在 Windows 平台上，将 <code>windows.h</code> 的包含列为可选。该
头文件仅在定义了
+ <code>BOOST_USE_WINDOWS_H</code> 宏时被使用。否则(也是缺省的
)，本库使用该头中的符号的内部定义。
</entry>
</row>
<row>
- <entry>Bug fix</entry>
+ <entry>Bug fix 缺陷修复</entry>
<entry>
On Windows platform function <code>from_ftime</code> could
return incorrect time if
- the <code>FILETIME</code> that is being passed to the function
contained dates before 1970-Jan-01.
+ the <code>FILETIME</code> that is being passed to the function
contained dates before 1970-Jan-01.<sbr/>
+ 在 Windows 平台上，函数 <code>from_ftime</code> 可以返回错误的
时间，如果传入的
+ <code>FILETIME</code> 带有 1970-Jan-01 以前的日期。
</entry>
</row>
<row>
- <entry>Bug fix</entry>
+ <entry>Bug fix 缺陷修复</entry>
<entry>
Fixed a possible crash in
<code>gregorian::special_value_from_string</code> if the string
- did not represent a valid special value.
+ did not represent a valid special value.<sbr/>
+ 修复了 <code>gregorian::special_value_from_string</code> 中的一
个可能的崩溃，如果该字符串不是表示一个有效的特定值。
</entry>
</row>
<row>
- <entry>Bug fix</entry>
+ <entry>Bug fix 缺陷修复</entry>
<entry>
Removed the <code>testfrmwk.hpp</code> file from the public
include directory. This file
- was internal for the library tests and was not documented.
+ was internal for the library tests and was not
documented.<sbr/>
+ 从公有包含目录中删除 <code>testfrmwk.hpp</code> 文件。该文件是
本库内部测试使用，不列入文档。
</entry>
</row>
<row>
- <entry>Bug fix</entry>
+ <entry>Bug fix 缺陷修复</entry>
<entry>
Fixed missing include in <code>filetime_functions.hpp</code>
- (<ulink
url="https://svn.boost.org/trac/boost/ticket/2688";>#2688</ulink>).
+ (<ulink
url="https://svn.boost.org/trac/boost/ticket/2688";>#2688</ulink>).<sbr/>
+ 修复 <code>filetime_functions.hpp</code> (<ulink
url="https://svn.boost.org/trac/boost/ticket/2688";>#2688</ulink>)
+ 中缺失的头文件包含。
</entry>
</row>
<row>
- <entry>Bug fix</entry>
+ <entry>Bug fix 缺陷修复</entry>
<entry>
Fixed dereferencing end string iterators in different places
of code,
which could cause crashes on MSVC
- (<ulink
url="https://svn.boost.org/trac/boost/ticket/2698";>#2698</ulink>).
+ (<ulink
url="https://svn.boost.org/trac/boost/ticket/2698";>#2698</ulink>).<sbr/>
+ 修复多处代码中对 end 字符串迭代器的解引用，这些解引用在 MSVC
+ (<ulink
url="https://svn.boost.org/trac/boost/ticket/2698";>#2698</ulink>)上会导致崩
溃。
</entry>
</row>
@@ -178,24 +204,27 @@
<tgroup cols="2">
<thead>
<row>
- <entry>Type</entry>
- <entry>Description</entry>
+ <entry>Type 类型</entry>
+ <entry>Description 说明</entry>
</row>
</thead>
<tbody>
<row>
- <entry>Feature</entry>
+ <entry>Feature 特性</entry>
<entry>
Updated the data in the date_time_zonespec.csv file to
reflect new US/Canada
daylight savings time rules for 2007. If you upgrade to the
new file, be aware
that the library will only give correct answers for
current/future date
conversions. So if you are converting dates from earlier
years the answers
will reflect current time zone rules not past rules. The
library doesn't support
- historic timezone rules presently.
+ historic timezone rules presently. <sbr/>
+ 更新了 date_time_zonespec.csv 文件中的数据，以反映美国/加拿大
2007年新的夏时制规则。如果你升级到了新的文件，
+ 那么要清楚本库只有对于当前或以后的日期转换才能得到正确的答案。
所以，如果你要对以前的年份进行日期转换，
+ 那么得到的答案将反映当前的时区规则而不是旧的规则。当前本库不能
支持历史时区。
</entry>
</row>
<row>
- <entry>Feature</entry>
+ <entry>Feature 特性</entry>
<entry>
Two other dst calculation features have also been update to
reflect the new
US/Canada timzone rules. This is the
boost::date_time::us_dst_rules and
@@ -210,56 +239,75 @@
<code>static date_type local_dst_start_day(year_type
year)</code> and
<code>static date_type local_dst_end_day(year_type
year)</code>.
Implementers should see
<code>date_time/local_timezone_defs.hpp</code> for
- examples.
+ examples.<sbr/>
+ 还更新了另外两个 dst 计算特性，以反映新的美国/加拿大时区规
则。它们是 boost::date_time::us_dst_rules 和
+ dst_calc_engine. us_dst_rules 已经被官方反对使用，Graham
Bennett
+ 提供的一个补丁可以让这个类正确用于历史和未来的日期。而
dst_calc_engine 也被更新，
+ 可以正确用于历史和未来的时间。这样，各个 local_adjustor 类均
可以正确工作。
+ 对于使用 dst_calc_engine 的类，其接口有些变化，变化是关于定制
的 dst traits 类的。
+ 该 traits 类的签名变为接受一个象 end_month 那样的 'year' 参
数。此外，该 traits 类需要2个新的函数：
+ <code>static date_type local_dst_start_day(year_type
year)</code> 和
+ <code>static date_type local_dst_end_day(year_type
year)</code>.
+ 实现请见 <code>date_time/local_timezone_defs.hpp</code> 中的
例子。
</entry>
</row>
<row>
- <entry>Bug Fix</entry>
- <entry>Fix DST traits for Austrialia (sf# 1672139) to set end of
DST at 3:00 am instead of 2:00 am.
+ <entry>Bug fix 缺陷修复</entry>
+ <entry>Fix DST traits for Austrialia (sf# 1672139) to set end of
DST at 3:00 am instead of 2:00 am.<sbr/>
+ 修复澳大利亚的 DST traits (sf# 1672139)，将DST的结束时间设为
3:00 am，替代原来的 2:00 am.
</entry>
</row>
<row>
- <entry>Bug Fix</entry>
+ <entry>Bug fix 缺陷修复</entry>
<entry>Fix a problem with potential linking error with multiple
definitions due
- to I/O code.
+ to I/O code.<sbr/>
+ 修复因I/O代码所引起的多重定义链接错误。
</entry>
</row>
<row>
- <entry>Bug Fix</entry>
+ <entry>Bug fix 缺陷修复</entry>
<entry>Changed serialization code in both greg_serialize.hpp and
time_serialize.hpp
to eliminate warnings due to unused variables for version
and file_version.
- Thanks to Caleb Epstein for the patch suggestion.
+ Thanks to Caleb Epstein for the patch suggestion.<sbr/>
+ 修改 greg_serialize.hpp 和 time_serialize.hpp 中的序列化代
码，消除因未使用变量 version 和
+ file_version 引起的告警。感谢 Caleb Epstein 的建议。
</entry>
</row>
<row>
- <entry>Bug Fix</entry>
+ <entry>Bug fix 缺陷修复</entry>
<entry>Fix regression errors that showed up under FreeBSD with
GCC and the
LANG environment set to russian -- changed parser to use
classic
- locale instead of blank locale.
+ locale instead of blank locale.<sbr/>
+ 修复在 FreeBSD 的 GCC 下将 LANG 环境变量设为 russian 时出
现的退化错误 --
+ 将分析器改为使用 classic locale 而不是 blank locale.
</entry>
</row>
<row>
- <entry>Bug Fix</entry>
+ <entry>Bug fix 缺陷修复</entry>
<entry>Changes for tracker issue 1178092 -- change in
convert_to_lower to make
- local a const static and speed up parsing.
+ local a const static and speed up parsing.<sbr/>
+ 修改 tracker 问题 1178092 -- 修改 convert_to_lower，将
local 改为 const static 以加快分析的速度。
</entry>
</row>
<row>
- <entry>Bug Fix</entry>
- <entry>Patches from Ulrich Eckhardt to fix support for EVC++ 4.
+ <entry>Bug fix 缺陷修复</entry>
+ <entry>Patches from Ulrich Eckhardt to fix support for EVC++
4.<sbr/>
+ 来自 Ulrich Eckhardt 的补丁，修复对 EVC++ 4 的支持。
</entry>
</row>
<row>
- <entry>Feature</entry>
+ <entry>Feature 特性</entry>
<entry>Reduce the usage of basic_stringstream as much a possible
to work around
a bug in the VC8 standard library. See
<ulink
url="http://lists.boost.org/Archives/boost/2006/02/101122.php";>mailing list
archive</ulink>
- for more information.
+ for more information.<sbr/>
+ 尽量减少对 basic_stringstream 的使用，以避开 VC8 标准库中
的缺陷。更多信息请见
+ <ulink
url="http://lists.boost.org/Archives/boost/2006/02/101122.php";>邮件列表存档
</ulink>。
</entry>
</row>
@@ -273,119 +321,142 @@
<tgroup cols="2">
<thead>
<row>
- <entry>Type</entry>
- <entry>Description</entry>
+ <entry>Type 类型</entry>
+ <entry>Description 说明</entry>
</row>
</thead>
<tbody>
<row>
- <entry>Bug Fix</entry>
- <entry>Period lengths, when beginning and end points are the
same, or are consecutive, were being incorrectly calculated. The corrected
behavior, where end and beginning points are equal, or a period is created
with a zero duration, now return a length of zero. A period where beginning
and end points are consecutive will return a length of one.
+ <entry>Bug fix 缺陷修复</entry>
+ <entry>Period lengths, when beginning and end points are the
same, or are consecutive, were being incorrectly calculated. The corrected
behavior, where end and beginning points are equal, or a period is created
with a zero duration, now return a length of zero. A period where beginning
and end points are consecutive will return a length of one.<sbr/>
+ 如果时间段的开始点和结束点相同或相连，则时间段长度的计算会有错。
在修正后，当开始点和结束点相同时，
+ 或者时间段以零时长创建时，现在将返回长度0。对于开始点和结束点相连
的时间段，则返回长度1。
</entry>
</row>
<row>
- <entry>Bug Fix</entry>
- <entry>Time_input_facet was missing functions to set iso
formats. It also failed to parse time values that did not use a separator
(%H%M%S). Both these bugs have been corrected.
+ <entry>Bug fix 缺陷修复</entry>
+ <entry>Time_input_facet was missing functions to set iso
formats. It also failed to parse time values that did not use a separator
(%H%M%S). Both these bugs have been corrected.<sbr/>
+ Time_input_facet 缺少设为ISO格式的函数。而且在不使用分隔符时
(%H%M%S)，将不能进行分析。这两个缺陷均已修正。
</entry>
</row>
<row>
- <entry>Feature</entry>
- <entry>Preliminary names of ptime_facet and ptime_input_facet
changed to simply time_facet and time_input_facet. The ptime_* versions
have been removed all together.
+ <entry>Feature 特性</entry>
+ <entry>Preliminary names of ptime_facet and ptime_input_facet
changed to simply time_facet and time_input_facet. The ptime_* versions
have been removed all together.<sbr/>
+ 将 ptime_facet 和 ptime_input_facet 的名字改为 time_facet 和
time_input_facet. 同时删除所有 ptime_* 版本。
</entry>
</row>
<row>
- <entry>Feature</entry>
- <entry>The from_iso_string function failed to parse fractional
digits. We added code that correctly parses when input has more digits, or
too few digits, that the compiled library precision. Ptimes with only a
decimal are also correctly parsed.
+ <entry>Feature 特性</entry>
+ <entry>The from_iso_string function failed to parse fractional
digits. We added code that correctly parses when input has more digits, or
too few digits, that the compiled library precision. Ptimes with only a
decimal are also correctly parsed.<sbr/>
+ 函数 from_iso_string function 不能分析小数。我们增加了代码以正确
地按已编译库的精度进行过多或过少数位的分析。
+ 带小数的 Ptimes 也可以正确分析。
</entry>
</row>
<row>
- <entry>Bug Fix</entry>
- <entry>The parsing mechanism in the new IO would consume the
next character after a match was made. This bug presented itself when
attempting to parse a period that had special value for it's beginning
point.
+ <entry>Bug fix 缺陷修复</entry>
+ <entry>The parsing mechanism in the new IO would consume the
next character after a match was made. This bug presented itself when
attempting to parse a period that had special value for it's beginning
point.<sbr/>
+ 新IO中的分析机制在进一次匹配后会吃掉下一个字符。在试图分析以特殊
值作为开始点的时间段时就会出现这个缺陷。
</entry>
</row>
<row>
- <entry>Bug Fix</entry>
- <entry>The new IO system failed to provide the ability for the
user to "turn on" exceptions on the stream. The failbit was also not set
when parsing failed. Both of these problems have been fixed.
+ <entry>Bug fix 缺陷修复</entry>
+ <entry>The new IO system failed to provide the ability for the
user to "turn on" exceptions on the stream. The failbit was also not set
when parsing failed. Both of these problems have been fixed.<sbr/>
+ 新的IO系统无法为用户提供“打开”流操作的异常机制的功能。即使分析失
败，failbit 位也不会置位。现在这些问题都已得到修正。
</entry>
</row>
<row>
- <entry>Bug Fix</entry>
- <entry>Parsing of special values, by means of from_*_string
functions, has been fixed. This also effects the libraries ability to
serialize special values. Time_duration now serializes as either a string
or individual fields (depending on is_special()).
+ <entry>Bug fix 缺陷修复</entry>
+ <entry>Parsing of special values, by means of from_*_string
functions, has been fixed. This also effects the libraries ability to
serialize special values. Time_duration now serializes as either a string
or individual fields (depending on is_special()).<sbr/>
+ 以 from_*_string 函数分析特殊值的问题已修正。这使得本库可以对特殊
值进行序列化。
+ Time_duration 现在可以序列化为字符串或单独的字段(取决于
is_special())。
</entry>
</row>
<row>
- <entry>Bug Fix</entry>
- <entry>Previously, output streaming of <code>partial_date</code>
would display the day as either a single or double digit integer (ie '1',
or '12'). This has been corrected to always display a double digit integer
(ie '01').
+ <entry>Bug fix 缺陷修复</entry>
+ <entry>Previously, output streaming of <code>partial_date</code>
would display the day as either a single or double digit integer (ie '1',
or '12'). This has been corrected to always display a double digit integer
(ie '01').<sbr/>
+ 以前，<code>partial_date</code> 的流输出会以一位或两位数字的方式
来显示天数
+ (即 '1', 或 '12')。现在已更正为只使用两位数字(即 '01')。
</entry>
</row>
<row>
- <entry>Feature</entry>
+ <entry>Feature 特性</entry>
<entry>Major new features related to management of local times.
This includes the introduction of a series of new classes
to
- represent time zones and local times (see <link
linkend="date_time.local_time">Date Time Local Time</link> for complete
details).
+ represent time zones and local times (see <link
linkend="date_time.local_time">Date Time Local Time</link> for complete
details).<sbr/>
+ 主要的新特性都与本地时间的管理有关。包括引入了一系列新
类，用于表示时区和本地时间
+ (完整的细节请见 <link linkend="date_time.local_time">日期
与时间的本地时间</link>)。
</entry>
</row>
<row>
- <entry>Feature</entry>
+ <entry>Feature 特性</entry>
<entry>Input and output facets have been re-written to support
format-based
- redefinition of formats (see <link
linkend="date_time.date_time_io">Date Time IO</link> for complete details).
+ redefinition of formats (see <link
linkend="date_time.date_time_io">Date Time IO</link> for complete
details).<sbr/>
+ 输入和输出 facets 已被重写以支持基于格式的格式重定义(完整的细节
请见
+ <link linkend="date_time.date_time_io">日期和时间的IO</link>)。
</entry>
</row>
<row>
- <entry>Feature</entry>
- <entry>Functions have been added to facilitate conversions
between <code>tm</code> structs for <code>date</code>, <code>ptime</code>,
<code>time_duration</code>, and <code>local_date_time</code>. Functions for
converting <code>FILETIME</code>, and <code>time_t</code> to
<code>ptime</code> are also provided. See the individual sections for
details.
+ <entry>Feature 特性</entry>
+ <entry>Functions have been added to facilitate conversions
between <code>tm</code> structs for <code>date</code>, <code>ptime</code>,
<code>time_duration</code>, and <code>local_date_time</code>. Functions for
converting <code>FILETIME</code>, and <code>time_t</code> to
<code>ptime</code> are also provided. See the individual sections for
details.<sbr/>
+ 增加一些函数，以方便在 <code>tm</code> 结构与 <code>date</code>,
<code>ptime</code>, <code>time_duration</code>,
+ 和 <code>local_date_time</code> 之间的转换。还提供了将
<code>FILETIME</code> 和 <code>time_t</code> 转换为
+ <code>ptime</code> 的函数。详情请见单独的章节。
</entry>
</row>
<row>
- <entry>Feature</entry>
- <entry>A <code>universal_time</code> function has been added to
the <code>microsec_time_clock</code> (full details of this function can be
found <link linkend="ptime_from_clock">here</link>).
+ <entry>Feature 特性</entry>
+ <entry>A <code>universal_time</code> function has been added to
the <code>microsec_time_clock</code> (full details of this function can be
found <link linkend="ptime_from_clock">here</link>).<sbr/>
+ 在 <code>microsec_time_clock</code> 中增加了一个
<code>universal_time</code> 函数
+ (有关该函数的完整细节请见 <link linkend="ptime_from_clock">这里
</link>)。
</entry>
</row>
<row>
- <entry>Feature</entry>
- <entry>Functions have been added to facilitate conversions
between <code>tm</code> structs for <code>date</code>, <code>ptime</code>,
<code>time_duration</code>, and <code>local_date_time</code>. Functions for
converting <code>FILETIME</code>, and <code>time_t</code> to
<code>ptime</code> are also provided. See the individual sections for
details.
- </entry>
- </row>
- <row>
- <entry>Feature</entry>
- <entry>A <code>universal_time</code> function has been added to
the <code>microsec_time_clock</code> (full details of this function can be
found <link linkend="ptime_from_clock">here</link>).
- </entry>
- </row>
- <row>
- <entry>Feature</entry>
+ <entry>Feature 特性</entry>
<entry>Date-time now uses reentrant POSIX functions on those
platforms that
- support them when BOOST_HAS_THREADS is defined.
+ support them when BOOST_HAS_THREADS is defined. <sbr/>
+ Date-time 现在在可支持的平台上将使用重入的 POSIX 函数，如果定义
了 BOOST_HAS_THREADS。
</entry>
</row>
<row>
- <entry>Bug Fix</entry>
+ <entry>Bug fix 缺陷修复</entry>
<entry>Fixed a bug in serialization code where special values
(not-a-date-time, infinities, etc) for
ptime, time_duration would not read back correctly from an
archive.
The output serialization code wrote subfields such
as time_duration.seconds() which are invalid for special
values and
thus undefined values. Thus when read back the values
could cause
- strange behavior including execeptions on construction.
+ strange behavior including execeptions on
construction.<sbr/>
+ 修正了在序列化代码中不能从存档中正确读回 ptime,
time_duration 的特殊值
+ (not-a-date-time, infinities, 等等)的缺陷。输出用的序列化代
码为特殊值和未定义值的无效
+ time_duration.seconds() 写出子字段。这样当读回这些值时，可
以引发奇特的行为，包括在构造时抛出异常。
</entry>
</row>
<row>
- <entry>Bug Fix</entry>
- <entry>Fixed multiple warnings generated with various
platforms/compilers.
+ <entry>Bug fix 缺陷修复</entry>
+ <entry>Fixed multiple warnings generated with various
platforms/compilers.<sbr/>
+ 修正了由不同平台/编译器产生的多个告警。
</entry>
</row>
<row>
- <entry>Bug Fix</entry>
- <entry>Construction of a ptime with a time_duration beyond the
range of 00:00 to 23:59:59.9... now adjusts the date and time to make the
time_duration fall within this range (ie <code>ptime(date(2005,2,1),
hours(-5))</code> -> "2005-Jan-31 19:00:00" &
<code>ptime(date(2005,2,1), hours(35))</code> -> "2005-Feb-02 11:00:00").
+ <entry>Bug fix 缺陷修复</entry>
+ <entry>Construction of a ptime with a time_duration beyond the
range of 00:00 to 23:59:59.9... now adjusts the date and time to make the
time_duration fall within this range (ie <code>ptime(date(2005,2,1),
hours(-5))</code> -> "2005-Jan-31 19:00:00" &
<code>ptime(date(2005,2,1), hours(35))</code> -> "2005-Feb-02
11:00:00").<sbr/>
+ 以一个超过从 00:00 到 23:59:59.9... 范围的 time_duration 来构造
ptime，现在会对日期和时间进行调整，
+ 以使得 time_duration 落在这一范围内(即
<code>ptime(date(2005,2,1), hours(-5))</code> -> "2005-Jan-31 19:00:00"，
+ 而 <code>ptime(date(2005,2,1), hours(35))</code> -> "2005-Feb-02
11:00:00")。
</entry>
</row>
<row>
- <entry>Bug Fix</entry>
- <entry>Time parsing now correctly handles excessive digits for
fractional seconds. Leading zeros are dropped ("000100" -> 100 frac_sec),
and excessive digits are truncated at the proper place ("123456789876" ->
123456 or 123456789 depending on what precision the library was compiled
with).
+ <entry>Bug fix 缺陷修复</entry>
+ <entry>Time parsing now correctly handles excessive digits for
fractional seconds. Leading zeros are dropped ("000100" -> 100 frac_sec),
and excessive digits are truncated at the proper place ("123456789876" ->
123456 or 123456789 depending on what precision the library was compiled
with).<sbr/>
+ 时间分析现在可以正确处理过多位的小数秒。前导的0将被扔掉("000100"
-> 100 frac_sec)，
+ 而过多的数位将在正确的位置被截断("123456789876" -> 123456 或
123456789，取决于编译本库时的精度)。
</entry>
</row>
<row>
- <entry>Bug Fix</entry>
- <entry>Changes to the <code>boost::serialization</code>
interface broke serialization compatibility for <code>date_time</code>. The
user must provide a function to insure <code>date_time</code> objects are
<code>const</code> before they are serialized. The function should be
similar to:
+ <entry>Bug fix 缺陷修复</entry>
+ <entry>Changes to the <code>boost::serialization</code>
interface broke serialization compatibility for <code>date_time</code>. The
user must provide a function to insure <code>date_time</code> objects are
<code>const</code> before they are serialized. The function should be
similar to:<sbr/>
+ 改为 <code>boost::serialization</code> 的接口破坏了
<code>date_time</code> 的序列化兼容性。
+ 用户必须提供函数来在序列化之前确保 <code>date_time</code> 对象是
<code>const</code> 的。该函数类似于：
<screen>template<class archive_type, class temporal_type>
void save_to(archive_type& ar,
const temporal_type& tt)
@@ -395,13 +466,15 @@
</entry>
</row>
<row>
- <entry>Bug Fix</entry>
- <entry>Use of the depricated <code>boost::tokenizer</code>
interface has been updated to the current interface. This fixes compiler
errors on some older compilers.
+ <entry>Bug fix 缺陷修复</entry>
+ <entry>Use of the depricated <code>boost::tokenizer</code>
interface has been updated to the current interface. This fixes compiler
errors on some older compilers.<sbr/>
+ 对于已不使用的 <code>boost::tokenizer</code> 接口，已升级为当前的
接口。修正了在某些旧编译器上的编译错误。
</entry>
</row>
<row>
- <entry>Bug Fix</entry>
- <entry>Templatized formatters in the legacy IO system to accept
char type. Also removed calls to <code>boost::lexical_cast</code>.
+ <entry>Bug fix 缺陷修复</entry>
+ <entry>Templatized formatters in the legacy IO system to accept
char type. Also removed calls to <code>boost::lexical_cast</code>.<sbr/>
+ 在遗留IO系统中的模板化格式化器接受 char 类型。同时删掉了对
<code>boost::lexical_cast</code> 的调用。
</entry>
</row>
</tbody>
@@ -414,71 +487,88 @@
<tgroup cols="2">
<thead>
<row>
- <entry>Type</entry>
- <entry>Description</entry>
+ <entry>Type 类型</entry>
+ <entry>Description 说明</entry>
</row>
</thead>
<tbody>
<row>
- <entry>Bug Fix</entry>
+ <entry>Bug fix 缺陷修复</entry>
<entry>Snap to end of month behavior corrected for year_functor.
Previously, starting
from 2000-Feb-28 (leap year and not end of month) and
iterating through the next
leap year would result in 2004-Feb-29 instead of
2004-Feb-28. This behavior has
been corrected to produce the correct result of
2004-Feb-28. Thanks to Bart Garst
- for this change.
+ for this change.<sbr/>
+ 修正了 year_functor 的“保持为月末”的行为。以前，从
2000-Feb-28 (闰年的非月末日期)开始迭代到下一个闰年，
+ 会得到 2004-Feb-29 而不是 2004-Feb-28. 这一行为已得到改
正，以生成正确结果 2004-Feb-28.
+ 感谢 Bart Garst 所做的修正。
</entry>
</row>
<row>
- <entry>Feature</entry>
+ <entry>Feature 特性</entry>
<entry>Free function for creating a ptime object from a FILETIME
struct. This function
- is only available on platforms that define
BOOST_HAS_FTIME.
+ is only available on platforms that define
BOOST_HAS_FTIME.<sbr/>
+ 从 FILETIME 结构创建 ptime 对象的自由函数。该函数只在定义
了 BOOST_HAS_FTIME 的平台上可用。
</entry>
</row>
<row>
- <entry>Feature</entry>
+ <entry>Feature 特性</entry>
<entry>Microsecond time clock is now available on most windows
compilers as well as
- Unix.
+ Unix.<sbr/>
+ 微秒时钟现在在多数 windows 和 Unix 编译器上都可以用了。
</entry>
</row>
<row>
- <entry>Feature</entry>
+ <entry>Feature 特性</entry>
<entry>Use of the boost::serialization library is now available
with most of the
date_time classes. Classes capable of serialization are:
date_generator classes,
date, days, date_period, greg_month, greg_weekday,
greg_day, ptime, time_duration,
- and time_period. Thanks to Bart Garst for this change.
+ and time_period. Thanks to Bart Garst for this
change.<sbr/>
+ 现在 boost::serialization 库可以和多数 date_time 类一起使
用。具有序列化能力的类有：
+ date_generator 类, date, days, date_period, greg_month,
greg_weekday, greg_day, ptime,
+ time_duration, 和 time_period. 感谢 Bart Garst 所做的修
正。
</entry>
</row>
<row>
- <entry>Feature</entry>
+ <entry>Feature 特性</entry>
<entry>Functions added to convert date and time classes to
wstring. The library now
provides to_*_wstring as well as to_*_string functions
for: simple, iso,
iso_extended, and sql for dates and compilers that
support wstrings. Thanks to
- Bart Garst for this change.
+ Bart Garst for this change.<sbr/>
+ 新增了将 date 和 time 类转换为 wstring 的函数。本库现在提
供 to_*_wstring，
+ 和 to_*_string 函数一样，simple, iso, iso_extended, 和
sql for dates
+ 以及编译器均支持 wstrings. 感谢 Bart Garst 所做的修正。
</entry>
</row>
<row>
- <entry>Feature</entry>
+ <entry>Feature 特性</entry>
<entry>Period classes now handle zero length and NULL periods
correctly. A NULL period
is a period with a negative length. Thanks to Frank Wolf
and Bart Garst for this
- change.
+ change.<sbr/>
+ 时间段类现在可以正确处理零时长和 NULL 时间段。NULL 时间段
是具有负长度的时间段。
+ 感谢 Frank Wolf 和 Bart Garst 所做的修改。
</entry>
</row>
<row>
- <entry>Feature</entry>
+ <entry>Feature 特性</entry>
<entry>Added end_of_month function to gregorian::date to return
the last day of
the current month represented by the date. Result is
undefined for
- not_a_date_time or infinities.
+ not_a_date_time or infinities.<sbr/>
+ 在 gregorian::date 中增加了 end_of_month 函数，以日期表示
法返回当前月的最后一天。
+ 对于 not_a_date_time 或无限日期，结果未定义。
</entry>
</row>
<row>
- <entry>Bug Fix</entry>
- <entry>Removed incorrect usage of BOOST_NO_CWCHAR macro
throughout library.
+ <entry>Bug fix 缺陷修复</entry>
+ <entry>Removed incorrect usage of BOOST_NO_CWCHAR macro
throughout library.<sbr/>
+ 删掉整个库中对 BOOST_NO_CWCHAR 宏的不正确使用。
</entry>
</row>
<row>
- <entry>Feature</entry>
+ <entry>Feature 特性</entry>
<entry>New names added for some date classes. Original names are
still valid but may
- some day be deprecated. Changes are:
+ some day be deprecated. Changes are:<sbr/>
+ 为一些日期类增加了新的名字。原来的名字仍然可用，但以后可能
会不再使用。改变如下：
<simplelist type='horiz' columns='3'>
<member>date_duration</member>
<member>is now</member>
@@ -502,23 +592,28 @@
</entry>
</row>
<row>
- <entry>Feature</entry>
- <entry>Free functions for date generators added. Functions are:
days_until_weekday, days_before_weekday, next_weekday, and previous_weekday.
+ <entry>Feature 特性</entry>
+ <entry>Free functions for date generators added. Functions are:
days_until_weekday, days_before_weekday, next_weekday, and
previous_weekday.<sbr/>
+ 增加了日期生成器的自由函数。新增的函数是：days_until_weekday,
days_before_weekday, next_weekday, 和 previous_weekday.
<screen>days days_until_weekday(date, greg_weekday);
days days_before_weekday(date, greg_weekday);
date next_weekday(date, greg_weekday);
date previous_weekday(date, greg_weekday);</screen>
- Thanks to Bart Garst for this change.
+ Thanks to Bart Garst for this change.<sbr/>
+ 感谢 Bart Garst 所做的修改。
</entry>
</row>
<row>
- <entry>Feature</entry>
+ <entry>Feature 特性</entry>
<entry>New experimental duration types added for months, years,
and weeks. These classes
also provide mathematical operators for use with date and
time classes. Be aware
that adding of months or years a time or date past the
28th of a month may show
non-normal mathematical properties. This is a result
of 'end-of-month'
snapping used in the calculation. The last example below
illustrates the
- issue.
+ issue. <sbr/>
+ 为月数、年数和周数增加新的试验用时长类型。这些类还提供了与
日期和时间类的数学操作符。
+ 一个28日之后的时间或日期加上一定的月数或年数，可能会出现不
正常的数学特性。这是由于这一运算采用了'月末'保持。
+ 以下例子示范了这一问题。
<screen>months m(12);
years y(1);
@@ -532,60 +627,74 @@
d += months(1); //2004-Feb-29
d -= months(1); //2004-Jan-29</screen>
Input streaming is not yet implemented for these types.
- Thanks to Bart Garst for this change.
+ Thanks to Bart Garst for this change.<sbr/>
+ 这些类型的流输入尚未实现。感谢 Bart Garst 所做的修改。
</entry>
</row>
<row>
- <entry>Feature</entry>
- <entry>Unifying base class for date_generators brought in to
gregorian namespace. See <link
linkend="date_time.examples.print_holidays">Print Holidays Example</link>.
+ <entry>Feature 特性</entry>
+ <entry>Unifying base class for date_generators brought in to
gregorian namespace. See <link
linkend="date_time.examples.print_holidays">Print Holidays
Example</link>.<sbr/>
+ 统一 date_generators 的基类并带入到 gregorian 名字空间中。请见
+ <link linkend="date_time.examples.print_holidays">打印假日的例子
</link>。
</entry>
</row>
<row>
- <entry>Feature</entry>
+ <entry>Feature 特性</entry>
<entry>Added constructors for date and ptime that allow for
default construction (both)
and special values construction (ptime, both now support
this). Default
- constructors initialize the objects to not_a_date_time
(NADT).
+ constructors initialize the objects to not_a_date_time
(NADT).<sbr/>
+ 增加了 date 和 ptime 的缺省构造函数(两者都有)以及特殊值的
构造函数(ptime, 现在两者均支持)。
+ 缺省构造函数将对象初始化为
<screen>ptime p_nadt(not_a_date_time);
ptime p_posinf(pos_infin);
ptime p; // p == NADT
date d; // d == NADT</screen>
- Thanks to Bart Garst for this change.
+ Thanks to Bart Garst for this change.<sbr/>
+ 感谢 Bart Garst 所做的修改。
</entry>
</row>
<row>
- <entry>Feature</entry>
- <entry>Output streaming now supports wide stream output on compiler /
standard library combinations that support wide streams. This allows code
like:
+ <entry>Feature 特性</entry>
+ <entry>Output streaming now supports wide stream output on compiler /
standard library combinations that support wide streams. This allows code
like:<sbr/>
+ 流输出现在已可以在支持宽字符流的编译器/标准库组合上支持宽字符流。如以
下代码：
<screen>std::wstringstream wss;
date d(2003,Aug,21);
wss << d;</screen>
- Thanks to Bart Garst for this change.
+ Thanks to Bart Garst for this change.<sbr/>
+ 感谢 Bart Garst 所做的修改。
</entry>
</row>
<row>
- <entry>Feature</entry>
- <entry>Input streaming for date and time types is now supported
on both wide and narrow streams:
+ <entry>Feature 特性</entry>
+ <entry>Input streaming for date and time types is now supported
on both wide and narrow streams:<sbr/>
+ date 和 time 类型的流输入现在已可以支持宽字符和窄字符流：
<screen>date d(not_a_date_time);
std::stringstream ss("2000-FEB-29");
ss >> d; //Feb 29th, 2000
std::wstringstream ws("2000-FEB-29");
ws >> d; //Feb 29th, 2000</screen>
- Thanks to Bart Garst for this change.
+ Thanks to Bart Garst for this change.<sbr/>
+ 感谢 Bart Garst 所做的修改。
</entry>
</row>
<row>
- <entry>Bug Fix</entry>
+ <entry>Bug fix 缺陷修复</entry>
<entry> Fixed bug in duration_from_string() where a string formatted
with
less than full amount of fractional digits created an
incorrect
time_duration. With microsecond resolution for time
durations
the string "1:01:01.010" created a time duration of
- 01:01:01.000010 instead of 01:01:01.010000
+ 01:01:01.000010 instead of 01:01:01.010000<sbr/>
+ 修正了以下缺陷：duration_from_string() 当字符串的格式中的
小数位不足时会创建一个不正确的
+ time_duration. 在微秒解析度下，字符串 "1:01:01.010" 会创
建时长 01:01:01.000010 而不是 01:01:01.010000
</entry>
</row>
<row>
- <entry>Bug Fix</entry>
+ <entry>Bug fix 缺陷修复</entry>
<entry>Fixed the special value constructor for gregorian::date and
posix_time::ptime
when constructing with min_date_time or max_date_time.
The wrong value was
- constructed for these.
+ constructed for these.<sbr/>
+ 修正了 gregorian::date 和 posix_time::ptime 的特殊值构造函
数以 min_date_time 或
+ max_date_time 进行构造的问题。这些情形下会构造出错误的值。
</entry>
</row>
</tbody>
@@ -597,56 +706,73 @@
<tgroup cols="2">
<thead>
<row>
- <entry>Type</entry>
- <entry>Description</entry>
+ <entry>Type 类型</entry>
+ <entry>Description 说明</entry>
</row>
</thead>
<tbody>
<row>
- <entry>Bug Fix</entry>
- <entry>Build configuration updated so dll, statically, and dynamically
linkable library files are now produced with MSVC compilers. See <link
linkend="date_time.buildinfo">Build/Compiler Information</link> for more
details.</entry>
+ <entry>Bug fix 缺陷修复</entry>
+ <entry>Build configuration updated so dll, statically, and dynamically
linkable library files are now produced with MSVC compilers. See <link
linkend="date_time.buildinfo">Build/Compiler Information</link> for more
details.<sbr/>
+ 更新了构建配置文件，现在可以用MSVC编译器生成 dll, 静态和动态链接的库
文件。更多细节请见
+ <link linkend="date_time.buildinfo">构建/编译器信息</link>。</entry>
</row>
<row>
- <entry>Bug Fix</entry>
- <entry>Time_duration from_string is now correctly constructed from a
negative value. (ie "-0:39:00.000") Code provided by Bart Garst.</entry>
+ <entry>Bug fix 缺陷修复</entry>
+ <entry>Time_duration from_string is now correctly constructed from a
negative value. (ie "-0:39:00.000") Code provided by Bart Garst.<sbr/>
+ Time_duration from_string 现在可以正确地从负值进行构造
(如 "-0:39:00.000")。代码由 Bart Garst 提供。</entry>
</row>
<row>
- <entry>Bug Fix</entry>
- <entry>Fixed many MSVC compiler warnings when compiled with warning
level 4.</entry>
+ <entry>Bug fix 缺陷修复</entry>
+ <entry>Fixed many MSVC compiler warnings when compiled with warning
level 4.<sbr/>
+ 修正了在MSVC编译器下以4级告警级别编译时的多个告警。</entry>
</row>
<row>
- <entry>Feature</entry>
- <entry>Added prefix decrement operator (--) for date and time
iterators. See <link linkend="date_time.posix_time.time_iterators">Time
Iterators</link> and <link
linkend="date_time.gregorian.date_iterators">Date Iterators</link> for more
details. Code provided by Bart Garst.</entry>
+ <entry>Feature 特性</entry>
+ <entry>Added prefix decrement operator (--) for date and time
iterators. See <link linkend="date_time.posix_time.time_iterators">Time
Iterators</link> and <link
linkend="date_time.gregorian.date_iterators">Date Iterators</link> for more
details. Code provided by Bart Garst.<sbr/>
+ 为 date 和 time 迭代器增加了前缀递减操作符。更多细节请见 <link
linkend="date_time.posix_time.time_iterators">
+ Time 迭代器</link> 和 <link
linkend="date_time.gregorian.date_iterators">Date 迭代器</link>。代码由
Bart Garst 提供。</entry>
</row>
<row>
- <entry>Feature</entry>
- <entry>Special_values functionality added for date_duration,
time_duration and time classes. Code provided by Bart Garst.</entry>
+ <entry>Feature 特性</entry>
+ <entry>Special_values functionality added for date_duration,
time_duration and time classes. Code provided by Bart Garst.<sbr/>
+ Special_values 功能被增加到 date_duration, time_duration 和 time 类。
代码由 Bart Garst 提供。</entry>
</row>
<row>
- <entry>Bug Fix</entry>
- <entry>Fixed time_duration_traits calculation bug which was causing
time duration to be limited to 32bit range even when 64 bits were
available. Thanks to Joe de Guzman for tracking this down.</entry>
+ <entry>Bug fix 缺陷修复</entry>
+ <entry>Fixed time_duration_traits calculation bug which was causing
time duration to be limited to 32bit range even when 64 bits were
available. Thanks to Joe de Guzman for tracking this down.<sbr/>
+ 修正了 time_duration_traits 运算中的以下缺陷：尽管有64位环境可用，时
长还是被限制在32位的范围内。
+ 感谢 Joe de Guzman 对此缺陷的跟踪。</entry>
</row>
<row>
- <entry>Bug Fix</entry>
- <entry>Provided additional operators for duration types (eg:
date_duration, time_duration). This includes dividable by integer and fixes
to allow +=, -= operators. Thanks to Bart Garst for writing this code.
Also, the documentation of <link
linkend="date_time.calculations">Calculations</link> has been
improved.</entry>
+ <entry>Bug fix 缺陷修复</entry>
+ <entry>Provided additional operators for duration types (eg:
date_duration, time_duration). This includes dividable by integer and fixes
to allow +=, -= operators. Thanks to Bart Garst for writing this code.
Also, the documentation of <link
linkend="date_time.calculations">Calculations</link> has been
improved.<sbr/>
+ 为时间长度类型(如：date_duration, time_duration)提供了其它操作符。这
些操作包括：与整数相除以及 +=, -= 操作符。
+ 感谢 Bart Garst 编写了这些代码。另外，相关的 <link
linkend="date_time.calculations">运算</link> 文档也有了改进。</entry>
</row>
<row>
- <entry>Bug Fix</entry>
- <entry>Added typedefs to boost::gregorian gregorian_types.hpp various
date_generator function classes.</entry>
+ <entry>Bug fix 缺陷修复</entry>
+ <entry>Added typedefs to boost::gregorian gregorian_types.hpp various
date_generator function classes.<sbr/>
+ 为 boost::gregorian gregorian_types.hpp 中多个 date_generator 函数类
增加了 typedef.</entry>
</row>
<row>
- <entry>Feature</entry>
- <entry>Added from_time_t function to convert time_t to a
ptime.</entry>
+ <entry>Feature 特性</entry>
+ <entry>Added from_time_t function to convert time_t to a ptime.<sbr/>
+ 增加了 from_time_t function 将 time_t 转换为 ptime.</entry>
</row>
<row>
- <entry>Feature</entry>
- <entry>Added a span function for combining periods. See <link
linkend="date_time.gregorian.date_period">date period</link> and <link
linkend="date_time.posix_time.time_period">time period</link> docs.</entry>
+ <entry>Feature 特性</entry>
+ <entry>Added a span function for combining periods. See <link
linkend="date_time.gregorian.date_period">date period</link> and <link
linkend="date_time.posix_time.time_period">time period</link> docs.<sbr/>
+ 增加了对时间段进行合并的 span 函数。请见 <link
linkend="date_time.gregorian.date_period">日期段</link> 和
+ <link linkend="date_time.posix_time.time_period">时间段</link> 的文
档。</entry>
</row>
<row>
- <entry>Feature</entry>
+ <entry>Feature 特性</entry>
<entry>Added a function to time_duration to get the total number of
seconds in a
duration truncating any fractional seconds. In addition,
other resolutions
- were added to allow for easy conversions. For example
+ were added to allow for easy conversions. For
example<sbr/>
+ 为 time_duration 增加了一个函数，以取出在时长内的总秒
数，截断小数部分。
+ 另外，还增加了其它解析度以方便转换。例如：
<screen>seconds(1).total_milliseconds() == 1000
seconds(1).total_microseconds() == 1000000
hours(1).total_milliseconds() == 3600*1000 //3600 sec/hour
@@ -655,27 +781,38 @@
</entry>
</row>
<row>
- <entry>Feature</entry>
- <entry>Added output streaming operators for the <link
linkend="date_time.gregorian.date_algorithms">date generator</link> classes
- partial_date, first_kday_after, first_kday_before, etc. Thanks to Bart
Garst for this work.</entry>
+ <entry>Feature 特性</entry>
+ <entry>Added output streaming operators for the <link
linkend="date_time.gregorian.date_algorithms">date generator</link> classes
- partial_date, first_kday_after, first_kday_before, etc. Thanks to Bart
Garst for this work.<sbr/>
+ 为 <link linkend="date_time.gregorian.date_algorithms">日期生成器
</link> 类 - partial_date, first_kday_after,
+ first_kday_before, 等等 - 增加了流输出操作符。感谢 Bart Garst 的工
作。</entry>
</row>
<row>
- <entry>Feature</entry>
- <entry>Added unary- operators for durations for reversing the sign of a
time duration. For example:
+ <entry>Feature 特性</entry>
+ <entry>Added unary- operators for durations for reversing the sign of a
time duration. For example:<sbr/>
+ 为时长类型增加了单参数的 - 操作符，将时长的符号反转。例如：
<screen>time_duration td(5,0,0); //5 hours
td = -td; //-5 hours</screen>
- Thanks to Bart Garst for this work.</entry>
+ Thanks to Bart Garst for this work.<sbr/>
+ 感谢 Bart Garst 的工作。</entry>
</row>
<row>
- <entry>Feature</entry>
- <entry>Added support for parsing strings with 'month names'. Thus
creating a date object from string now accepts multiple formats
("2003-10-31","2003-Oct-31", and "2003-October-31"). Thus, date d =
from_simple_string("2003-Feb-27") is now allowed. A bad month name string (
from_simple_string("2003-SomeBogusMonthName-27")) will cause a bad_month
exception. On most compilers the string compare is case insensitive. Thanks
to Bart Garst for this work.</entry>
+ <entry>Feature 特性</entry>
+ <entry>Added support for parsing strings with 'month names'. Thus
creating a date object from string now accepts multiple formats
("2003-10-31","2003-Oct-31", and "2003-October-31"). Thus, date d =
from_simple_string("2003-Feb-27") is now allowed. A bad month name string (
from_simple_string("2003-SomeBogusMonthName-27")) will cause a bad_month
exception. On most compilers the string compare is case insensitive. Thanks
to Bart Garst for this work.<sbr/>
+ 增加了对‘月份名’字符串的分析支持。现在可以从字符串创建 date 对象，可
以接受多种格式 ("2003-10-31","2003-Oct-31",
+ 和 "2003-October-31")。因此，现在可以写 date d =
from_simple_string("2003-Feb-27"). 错误的月份名字符串
+ ( from_simple_string("2003-SomeBogusMonthName-27")) 将引发一个
bad_month 异常。
+ 多数编译器上，字符串的比较是大小写敏感的。感谢 Bart Garst 的工作。
</entry>
</row>
<row>
- <entry>Feature</entry>
- <entry>In addition to support for month names or numbers, functions
have been added to create date objects from multi-ordered date strings.
Ex: "January-21-2002", "2002-Jan-21", and "21-Jan-2003". See <link
linkend="date_time.gregorian.date_class">Date Class</link> for more
details.</entry>
+ <entry>Feature 特性</entry>
+ <entry>In addition to support for month names or numbers, functions
have been added to create date objects from multi-ordered date strings.
Ex: "January-21-2002", "2002-Jan-21", and "21-Jan-2003". See <link
linkend="date_time.gregorian.date_class">Date Class</link> for more
details.<sbr/>
+ 增加了对月份名或月份数的支持，加入了从多顺序日期字符串创建 date 对象
的函数。如： "January-21-2002", "2002-Jan-21",
+ 和 "21-Jan-2003". 更多详情请见 <link
linkend="date_time.gregorian.date_class">Date 类</link>。</entry>
</row>
<row>
<entry>Bug-Fix</entry><!-- leave '-' so table cell doesn't wrap -->
- <entry>Various documentation fixes. Thanks to Bart Garst for
updates.</entry>
+ <entry>Various documentation fixes. Thanks to Bart Garst for
updates.<sbr/>
+ 多个文档上的修正。感谢 Bart Garst 所做的更新。</entry>
</row>
</tbody>
</tgroup>
@@ -683,60 +820,77 @@
<bridgehead renderas="sect3">Changes from Boost 1.29 to 1.30 (date_time
1.00 to 1.01)</bridgehead>
<para>
- Notice: The interface to the partial_date class (see <link
linkend="date_time.gregorian.date_algorithms">date_algorithms</link>) 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);
+ Notice: The interface to the partial_date class (see <link
linkend="date_time.gregorian.date_algorithms">date_algorithms</link>) 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); <sbr/>
+ 说明：partial_date 类的接口(见 <link
linkend="date_time.gregorian.date_algorithms">日期算法</link>) 有所改变。
+ 构造函数的参数顺序有所变化，这会导致某些代码执行失败。这个改变是为了便
于提供更多的本地时间调整泛型代码。
+ 因此，要将使用 partial_date pd(Dec,25) 的代码改为 partial_date pd(25,
Dec);
</para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry>Type</entry>
- <entry>Description</entry>
+ <entry>Type 类型</entry>
+ <entry>Description 说明</entry>
</row>
</thead>
<tbody>
<row>
- <entry>Bug Fix</entry>
- <entry>Added new experimental feature for Daylight Savings Time
calculations. This allows traits based specification of dst rules.</entry>
+ <entry>Bug fix 缺陷修复</entry>
+ <entry>Added new experimental feature for Daylight Savings Time
calculations. This allows traits based specification of dst rules.<sbr/>
+ 增加了新的试验特性：夏时制计算。基于 traits 来指定 dst 规则。</entry>
</row>
<row>
- <entry>Feature</entry>
- <entry>Added new interfaces to calculate julian day and modified julian
day to the gregorian date class. See <link
linkend="date_time.gregorian.date_class">boost::gregorian::date</link>.</entry>
+ <entry>Feature 特性</entry>
+ <entry>Added new interfaces to calculate julian day and modified julian
day to the gregorian date class. See <link
linkend="date_time.gregorian.date_class">boost::gregorian::date</link>.<sbr/>
+ 增加了新的接口，以计算儒略日以及将儒略日修改为 gregorian date 类。请
见
+ <link
linkend="date_time.gregorian.date_class">boost::gregorian::date</link>.</entry>
</row>
<row>
- <entry>Feature</entry>
- <entry>Add new interface to calculate iso 8601 week number for a date.
See <link
linkend="date_time.gregorian.date_class">boost::gregorian::date</link>.</entry>
+ <entry>Feature 特性</entry>
+ <entry>Add new interface to calculate iso 8601 week number for a date.
See <link
linkend="date_time.gregorian.date_class">boost::gregorian::date</link>.<sbr/>
+ 增加了新的接口，计算某个日期的 iso 8601 周数。请见 <link
linkend="date_time.gregorian.date_class">
+ boost::gregorian::date</link>.</entry>
</row>
<row>
- <entry>Feature</entry>
- <entry>Add an iso 8601 time date-time format (eg: YYYYMMDDTHHHMMSS)
parsing function. See <link
linkend="date_time.posix_time.ptime_class">Class ptime</link> for more
information.</entry>
+ <entry>Feature 特性</entry>
+ <entry>Add an iso 8601 time date-time format (eg: YYYYMMDDTHHHMMSS)
parsing function. See <link
linkend="date_time.posix_time.ptime_class">Class ptime</link> for more
information.<sbr/>
+ 增加了一个 iso 8601 时间的 date-time 格式 (如：YYYYMMDDTHHHMMSS) 分析
函数。更多信息请见 <link linkend="date_time.posix_time.ptime_class">类
ptime</link>。</entry>
</row>
<row>
- <entry>Feature</entry>
- <entry> Added a length function to the period template so that both
date_periods and time_periods will now support this function.</entry>
+ <entry>Feature 特性</entry>
+ <entry> Added a length function to the period template so that both
date_periods and time_periods will now support this function.<sbr/>
+ 为 period 模板增加一个 length 函数，date_periods 和 time_periods 现在
都将支持这个函数。</entry>
</row>
<row>
- <entry>Bug Fix</entry>
- <entry>Split Jamfiles so that libs/date_time/build/Jamfile only builds
library and /libs/date_time/libs/test/Jamfile which runs tests.</entry>
+ <entry>Bug fix 缺陷修复</entry>
+ <entry>Split Jamfiles so that libs/date_time/build/Jamfile only builds
library and /libs/date_time/libs/test/Jamfile which runs tests.<sbr/>
+ 对 Jamfiles 进行分离，libs/date_time/build/Jamfile 仅构建库文件，而
/libs/date_time/libs/test/Jamfile 则运行测试。</entry>
</row>
<row>
***The diff for this file has been truncated for email.***
=======================================
--- /trunk/libs/date_time/xmldoc/conceptual.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/conceptual.xml Wed Jan 6 17:26:22 2010
@@ -8,7 +8,7 @@
-->
<section id="date_time.conceptual"
xmlns:xi="http://www.w3.org/2001/XInclude";>
- <title>Conceptual</title>
+ <title>Conceptual 概念</title>
<xi:include href="motivation.xml"/>
<xi:include href="domain_concepts.xml"/>
=======================================
--- /trunk/libs/date_time/xmldoc/custom_time_zone.xml Mon Dec 28 23:05:14
2009
+++ /trunk/libs/date_time/xmldoc/custom_time_zone.xml Wed Jan 6 17:26:22
2010
@@ -8,49 +8,60 @@
-->
<section id="date_time.local_time.custom_time_zone">
- <title>Custom Time Zone</title>
-
- <link linkend="custom_time_zone_intro">Introduction</link> --
- <link linkend="custom_time_zone_header">Header</link> --
- <link linkend="custom_time_zone_constr">Construction</link> --
- <link linkend="custom_time_zone_accessors">Accessors</link> --
- <link linkend="custom_time_zone_dependents">Dependent Types</link>
+ <title>Custom Time Zone 定制时区</title>
+
+ <link linkend="custom_time_zone_intro">Introduction 简介</link> --
+ <link linkend="custom_time_zone_header">Header 头文件</link> --
+ <link linkend="custom_time_zone_constr">Construction 构造</link> --
+ <link linkend="custom_time_zone_accessors">Accessors 访问器</link> --
+ <link linkend="custom_time_zone_dependents">Dependent Types 相关类型
</link>
<anchor id="custom_time_zone_intro" />
- <bridgehead renderas="sect3">Introduction</bridgehead>
+ <bridgehead renderas="sect3">Introduction 简介</bridgehead>
<para>
- A custom_time_zone object is a set of data and rules that provide
information about a time zone. Information such as the offset from UTC,
it's name and abbreviation, as well as daylight savings rules, called <link
linkend="date_time.local_time.dst_calc_rules">dst_calc_rules</link>. These
rules are handled via a boost::shared_ptr<dst_calc_rules>. Not all
time zones utilize daylight savings, therefore, time_zone objects can be
used with a NULL-assigned shared_ptr.
+ A custom_time_zone object is a set of data and rules that provide
information about a time zone. Information such as the offset from UTC,
it's name and abbreviation, as well as daylight savings rules, called <link
linkend="date_time.local_time.dst_calc_rules">dst_calc_rules</link>. These
rules are handled via a boost::shared_ptr<dst_calc_rules>. Not all
time zones utilize daylight savings, therefore, time_zone objects can be
used with a NULL-assigned shared_ptr.<sbr/>
+ custom_time_zone 对象是一组数据和规则，提供了关于时区的相关信息。这些信
息包括有：与UTC的偏移量，时区的名字和缩写，
+ 被称为 <link
linkend="date_time.local_time.dst_calc_rules">dst_calc_rules</link> 的夏令时
规则。
+ 这些规则通过一个 boost::shared_ptr<dst_calc_rules> 来处理。不是所
有时区都使用夏令时，
+ 因此，time_zone 对象可以带一个空赋值的 shared_ptr.
</para>
<para>
- As a convenience, a typedef for shared_ptr<dst_calc_rules> is
provided.
+ As a convenience, a typedef for shared_ptr<dst_calc_rules> is
provided.<sbr/>
+ 为方便使用，提供了对 shared_ptr<dst_calc_rules> 的一个 typedef.
<programlisting>typedef boost::shared_ptr<dst_calc_rules>
local_time::dst_calc_rule_ptr;</programlisting>
</para>
<anchor id="date_time.local_time.custom_time_zone_ptr" />
<para>
- The time_zone objects are used via a
boost::shared_ptr<local_time::time_zone>. As a convenience, a typedef
for boost::shared_ptr<local_time::time_zone> is provided:
+ The time_zone objects are used via a
boost::shared_ptr<local_time::time_zone>. As a convenience, a typedef
for boost::shared_ptr<local_time::time_zone> is provided: <sbr/>
+ time_zone 对象通过一个 boost::shared_ptr<local_time::time_zone>
来使用。为方便起见，
+ 提供了对 boost::shared_ptr<local_time::time_zone> 的 typedef:
<programlisting>typedef boost::shared_ptr<time_zone>
local_time::time_zone_ptr;</programlisting>
</para>
<anchor id="custom_time_zone_header" />
- <bridgehead renderas="sect3">Header</bridgehead>
+ <bridgehead renderas="sect3">Header 头文件</bridgehead>
<para>
- The inclusion of a single header will bring in all boost::local_time
types, functions, and IO operators.
+ The inclusion of a single header will bring in all boost::local_time
types, functions, and IO operators.<sbr/>
+ 包含单个头文件即可引入所有 boost::local_time 类型、函数和 IO 操作符。
<programlisting>#include "boost/date_time/local_time/local_time.hpp"</programlisting>
</para>
<anchor id="custom_time_zone_constr" />
- <bridgehead renderas="sect3">Construction</bridgehead>
+ <bridgehead renderas="sect3">Construction 构造</bridgehead>
<para>
Construction of a custom_time_zone is dependent on four objects: a
- <link
linkend="date_time.posix_time.time_duration">time_duration</link>, a <link
linkend="time_zone_names">time_zone_names</link>, a <link
linkend="dst_adjustment_offsets">dst_adjustment_offsets</link>, and a
shared_ptr to a <link
linkend="date_time.local_time.dst_calc_rules">dst_calc_rule</link>.
+ <link
linkend="date_time.posix_time.time_duration">time_duration</link>, a <link
linkend="time_zone_names">time_zone_names</link>, a <link
linkend="dst_adjustment_offsets">dst_adjustment_offsets</link>, and a
shared_ptr to a <link
linkend="date_time.local_time.dst_calc_rules">dst_calc_rule</link>.<sbr/>
+ custom_time_zone 的构造依赖于四个对象：一个 <link
linkend="date_time.posix_time.time_duration">time_duration</link>,
+ 一个 <link linkend="time_zone_names">time_zone_names</link>, 一个
<link linkend="dst_adjustment_offsets">dst_adjustment_offsets
+ </link>, 和一个指向 <link
linkend="date_time.local_time.dst_calc_rules">dst_calc_rule</link> 的
shared_ptr.
</para>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry>Syntax</entry>
- <entry>Example</entry>
+ <entry>Syntax 语法</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
@@ -61,7 +72,8 @@
<link linkend="date_time.posix_time.time_duration">gmt_offset</link>,
<link linkend="dst_adjustment_offsets">dst_offsets</link>,
<link linkend="date_time.local_time.dst_calc_rules">dst_rules</link>
</screen></entry>
- <entry>See <link
linkend="date_time.examples.simple_time_zone">simple_time_zone</link>
example for time_zone usage</entry>
+ <entry>See <link
linkend="date_time.examples.simple_time_zone">simple_time_zone</link>
example for time_zone usage<sbr/>
+ 有关 time_zone 的用法请见 <link
linkend="date_time.examples.simple_time_zone">简单的时区</link>。</entry>
</row>
</tbody>
</tgroup>
@@ -69,17 +81,17 @@
</para>
<anchor id="custom_time_zone_accessors" />
- <bridgehead renderas="sect3">Accessors</bridgehead>
+ <bridgehead renderas="sect3">Accessors 访问器</bridgehead>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
@@ -192,25 +204,27 @@
</para>
<anchor id="custom_time_zone_dependents" />
- <bridgehead renderas="sect3">Dependent Types</bridgehead>
- <link linkend="time_zone_names">Time Zone Names</link> --
- <link linkend="dst_adjustment_offsets">Dst Adjustment Offsets</link> --
- <link linkend="date_time.local_time.dst_calc_rules">Daylight Savings
Calc Rules</link>
+ <bridgehead renderas="sect3">Dependent Types 相关类型</bridgehead>
+ <link linkend="time_zone_names">Time Zone Names 时区名</link> --
+ <link linkend="dst_adjustment_offsets">Dst Adjustment Offsets Dst调整量
</link> --
+ <link linkend="date_time.local_time.dst_calc_rules">Daylight Savings
Calc Rules 夏令时计算规则</link>
<anchor id="time_zone_names" />
- <bridgehead renderas="sect3">Time Zone Names</bridgehead>
+ <bridgehead renderas="sect3">Time Zone Names 时区名</bridgehead>
<para>
- The time_zone_names_base type is an immutable template class of four
strings. One each for the name and abbreviation in standard time and
daylight savings time. The time_zone_names type is a typedef of
time_zone_names_base<char>.
+ The time_zone_names_base type is an immutable template class of four
strings. One each for the name and abbreviation in standard time and
daylight savings time. The time_zone_names type is a typedef of
time_zone_names_base<char>.<sbr/>
+ time_zone_names_base 类型是带四个字符串的不可变模板类。每个字符串分别为
标准时和夏令时的全称和缩写。
+ time_zone_names 类型是 time_zone_names_base<char> 的 typedef.
</para>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
@@ -221,7 +235,8 @@
string std_abbrev
string dst_name
string dst_abbrev</screen></entry>
- <entry>The only constructor, all four strings must be
provided.</entry>
+ <entry>The only constructor, all four strings must be
provided.<sbr/>
+ 唯一的构造函数，必须提供所有四个字符串。</entry>
</row>
<row>
<entry><screen>string sn("Eastern Standard Time");
@@ -235,7 +250,8 @@
<row>
<entry valign="top" morerows="1"><screen>std::string
std_zone_name()</screen></entry>
- <entry>Returns the standard zone name</entry>
+ <entry>Returns the standard zone name<sbr/>
+ 返回标准的时区名。</entry>
</row>
<row>
<entry><screen>nyc_names.std_zone_name();
@@ -244,7 +260,8 @@
<row>
<entry valign="top" morerows="1"><screen>std::string
std_zone_abbrev()</screen></entry>
- <entry>Returns the standard zone abbreviation</entry>
+ <entry>Returns the standard zone abbreviation<sbr/>
+ 返回标准的时区缩写。</entry>
</row>
<row>
<entry><screen>nyc_names.std_zone_abbrev();
@@ -253,7 +270,8 @@
<row>
<entry valign="top" morerows="1"><screen>std::string
dst_zone_name()</screen></entry>
- <entry>Returns the daylight savings zone name</entry>
+ <entry>Returns the daylight savings zone name<sbr/>
+ 返回夏令时的时区名。</entry>
</row>
<row>
<entry><screen>nyc_names.std_zone_name();
@@ -262,7 +280,8 @@
<row>
<entry valign="top" morerows="1"><screen>std::string
dst_zone_abbrev()</screen></entry>
- <entry>Returns the daylight savings zone abbreviation</entry>
+ <entry>Returns the daylight savings zone abbreviation<sbr/>
+ 返回夏令时的时区缩写。</entry>
</row>
<row>
<entry><screen>nyc_names.std_zone_abbrev();
@@ -274,20 +293,21 @@
</para>
<anchor id="dst_adjustment_offsets" />
- <bridgehead renderas="sect3">Dst Adjustment Offsets</bridgehead>
+ <bridgehead renderas="sect3">Dst Adjustment Offsets Dst调整量
</bridgehead>
<para>
- The dst_adjustment_offsets type is a collection of three <link
linkend="date_time.posix_time.time_duration">time_duration</link> objects.
+ The dst_adjustment_offsets type is a collection of three <link
linkend="date_time.posix_time.time_duration">time_duration</link>
objects.<sbr/>
+ dst_adjustment_offsets 类型是三个 <link
linkend="date_time.posix_time.time_duration">时间长度</link> 对象的集合。
</para>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
@@ -297,7 +317,9 @@
time_duration dst_adjust
time_duration start_offset
time_duration end_offset</screen></entry>
- <entry>The first time_duration is the daylight savings
adjustment. The second is the time which daylight savings starts on the
start day. The third is the time daylight savings ends on the ending
day.</entry>
+ <entry>The first time_duration is the daylight savings
adjustment. The second is the time which daylight savings starts on the
start day. The third is the time daylight savings ends on the ending
day.<sbr/>
+ 第一个 time_duration 是夏令时的调整量。第二个是在夏令时开始当天
的夏令时开始时间。
+ 第三个为在夏令时结束当天的夏令时结束时间。</entry>
</row>
<row>
<entry><screen>
@@ -311,20 +333,23 @@
</para>
<anchor id="date_time.local_time.dst_calc_rules" />
- <bridgehead renderas="sect3">Daylight Savings Calc Rules</bridgehead>
+ <bridgehead renderas="sect3">Daylight Savings Calc Rules 夏令时计算规则
</bridgehead>
<para>
- Daylight savings calc rules, named dst_calc_rules, are a series of
objects that group appropriate <link
linkend="date_time.gregorian.date_algorithms">date_generators</link>
together to form rule sets. The individual rules objects are used via
dst_calc_rule_ptr.
+ Daylight savings calc rules, named dst_calc_rules, are a series of
objects that group appropriate <link
linkend="date_time.gregorian.date_algorithms">date_generators</link>
together to form rule sets. The individual rules objects are used via
dst_calc_rule_ptr.<sbr/>
+ 夏令时计算规则，称为 dst_calc_rules, 是一系列对象，将多个合适的 <link
linkend="date_time.gregorian.date_algorithms">
+ 日期生成器</link> 组合起来以形成规则集。单个规则对象通过
dst_calc_rule_ptr 使用。
</para>
<para>
- For a complete example of all five dst_calc_rule types, see: <link
linkend="date_time.examples.calc_rules">calc_rules example</link>.
+ For a complete example of all five dst_calc_rule types, see: <link
linkend="date_time.examples.calc_rules">calc_rules example</link>.<sbr/>
+ 有关所有五个 dst_calc_rule 类型的完整例子，请见：<link
linkend="date_time.examples.calc_rules">计算规则举例</link>。
</para>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry>Syntax</entry>
- <entry>Description</entry>
+ <entry>Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
</thead>
<tbody>
@@ -333,28 +358,34 @@
Parameters:
start_rule
end_rule</screen></entry>
- <entry>Both the start and end rules are of type
gregorian::partial_date.</entry>
+ <entry>Both the start and end rules are of type
gregorian::partial_date.<sbr/>
+ 开始和结束规则均为类型 gregorian::partial_date.</entry>
</row>
<row>
<entry valign="top"><screen>first_last_dst_rule(...)
Parameters:
start_rule
end_rule</screen></entry>
- <entry>The DST start rule is of type
gregorian::first_day_of_the_week_in_month and the end rule is of type
gregorian::last_day_of_the_week_in_month.</entry>
+ <entry>The DST start rule is of type
gregorian::first_day_of_the_week_in_month and the end rule is of type
gregorian::last_day_of_the_week_in_month.<sbr/>
+ DST 开始规则为类型 gregorian::first_day_of_the_week_in_month 而
结束规则为类型
+ gregorian::last_day_of_the_week_in_month.</entry>
</row>
<row>
<entry valign="top"><screen>last_last_dst_rule(...)
Parameters:
start_rule
end_rule</screen></entry>
- <entry>Both the start and end rules are of type
gregorian::last_day_of_the_week_in_month.</entry>
+ <entry>Both the start and end rules are of type
gregorian::last_day_of_the_week_in_month.<sbr/>
+ 开始和结束规则均为类型
gregorian::last_day_of_the_week_in_month.</entry>
</row>
<row>
<entry valign="top"><screen>nth_last_dst_rule(...)
Parameters:
start_rule
end_rule</screen></entry>
- <entry>The DST start rule is of type
gregorian::nth_day_of_the_week_in_month and the end rule is of type
gregorian::last_day_of_the_week_in_month.</entry>
+ <entry>The DST start rule is of type
gregorian::nth_day_of_the_week_in_month and the end rule is of type
gregorian::last_day_of_the_week_in_month.<sbr/>
+ DST 开始规则为类型 gregorian::nth_day_of_the_week_in_month 而结
束规则为类型
+ gregorian::last_day_of_the_week_in_month.</entry>
</row>
<row>
<entry valign="top"><screen>nth_kday_dst_rule(...)
@@ -363,7 +394,8 @@
end_rule)
(see note* below)</screen>
</entry>
- <entry>Both rules are of type
gregorian::nth_day_of_the_week_in_month.</entry>
+ <entry>Both rules are of type
gregorian::nth_day_of_the_week_in_month.<sbr/>
+ 两个规则均为类型
gregorian::nth_day_of_the_week_in_month.</entry>
</row>
</tbody>
</tgroup>
=======================================
--- /trunk/libs/date_time/xmldoc/date_algorithms.xml Mon Dec 28 23:05:14
2009
+++ /trunk/libs/date_time/xmldoc/date_algorithms.xml Wed Jan 6 17:26:22
2010
@@ -8,60 +8,71 @@
-->
<section id="date_time.gregorian.date_algorithms">
- <title>Date Generators/Algorithms</title>
- <bridgehead renderas="sect2">Date Generators/Algorithms</bridgehead>
- <link linkend="algo_intro">Introduction</link> --
- <link linkend="algo_header">Header</link> --
- <link linkend="algo_overview">Class Overview</link> --
- <link linkend="algo_func_overview">Function Overview</link>
+ <title>Date Generators/Algorithms 日期生成器/算法</title>
+ <bridgehead renderas="sect2">Date Generators/Algorithms 日期生成器/算法
</bridgehead>
+ <link linkend="algo_intro">Introduction 简介</link> --
+ <link linkend="algo_header">Header 头文件</link> --
+ <link linkend="algo_overview">Class Overview 类概要</link> --
+ <link linkend="algo_func_overview">Function Overview 函数概要</link>
<anchor id="algo_intro" />
- <bridgehead renderas="sect3">Introduction</bridgehead>
+ <bridgehead renderas="sect3">Introduction 简介</bridgehead>
<para>
Date algorithms or generators are tools for generating other dates or
schedules of dates. A generator function starts with some part of a date
such as a month and day and is supplied another part to then generate a
concrete date. This allows the programmer to represent concepts such
as "The first Sunday in February" and then create a concrete set of dates
when provided with one or more years.
- <emphasis>Note</emphasis>: As of boost version 1_31_0, date generator
names have been changed. Old names are still available but are no longer
documented and may someday be deprecated
+ <emphasis>Note</emphasis>: As of boost version 1_31_0, date generator
names have been changed. Old names are still available but are no longer
documented and may someday be deprecated<sbr/>
+ 日期算法或生成器是一些生成其它日期或日期时间表的工具。生成器函数以日期
的某些部分如月份和日子开始，
+ 并通过提供其它部分以生成一个具体的日期。这使得程序员可以表示象"二月的第
一个星期天"这样的概念，
+ 并在提供一个或多个年份后创建一组具体的日期。
<emphasis>注：</emphasis>从 boost 的 1_31_0 版本起，
+ 日期生成器的名字已被改变。旧的名字现在还可以使用，但是不再提供文档，并
可能在某个时候取消。
</para>
- <para>Also provided are stand-alone functions for generating a date, or
calculation a duration of days. These functions take a date object and a
weekday object as parameters.
+ <para>Also provided are stand-alone functions for generating a date, or
calculation a duration of days. These functions take a date object and a
weekday object as parameters.<sbr/>
+ 同时还提供了生成一个日期或计算一段日期长度的独立函数。这些函数以一个
date 对象和一个 weekday 对象为参数。
</para>
- <para>All date generator classes and functions are in the
boost::gregorian namespace.
+ <para>All date generator classes and functions are in the
boost::gregorian namespace.<sbr/>
+ 所有日期生成器类和函数均位于 boost::gregorian 名字空间中。
</para>
<para>
- The <link linkend="date_time.examples.print_holidays">print
holidays</link> example shows a detailed usage example.
+ The <link linkend="date_time.examples.print_holidays">print
holidays</link> example shows a detailed usage example. <sbr/>
+ 例子 <link linkend="date_time.examples.print_holidays">打印假日</link>
示范了详细的用法。
</para>
<anchor id="algo_header" />
- <bridgehead renderas="sect3">Header</bridgehead>
+ <bridgehead renderas="sect3">Header 头文件</bridgehead>
<para><programlisting>#include "boost/date_time/gregorian/gregorian.hpp"</programlisting>
</para>
<anchor id="algo_overview" />
- <bridgehead renderas="sect3">Overview</bridgehead>
+ <bridgehead renderas="sect3">Overview 概要</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Class and get_date
Parameter</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Class and get_date Parameter 类
和get_date参数</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>year_based_generator
date get_date(greg_year year)</screen></entry>
- <entry>A unifying (abstract) date_generator base type for:
<code>partial_date</code>, <code>nth_day_of_the_week_in_month</code>,
<code>first_day_of_the_week_in_month</code>, and
<code>last_day_of_the_week_in_month</code>.</entry>
+ <entry>A unifying (abstract) date_generator base type for:
<code>partial_date</code>, <code>nth_day_of_the_week_in_month</code>,
<code>first_day_of_the_week_in_month</code>, and
<code>last_day_of_the_week_in_month</code>.<sbr/>
+ 以下类型的统一(抽象)的日期生成器基类：<code>partial_date</code>,
<code>nth_day_of_the_week_in_month</code>,
+ <code>first_day_of_the_week_in_month</code>, 和
<code>last_day_of_the_week_in_month</code>.</entry>
</row>
<row>
- <entry>The <link
linkend="date_time.examples.print_holidays">print holidays</link> example
shows a detailed usage example.</entry>
+ <entry>The <link
linkend="date_time.examples.print_holidays">print holidays</link> example
shows a detailed usage example.<sbr/>
+ 例子 <link linkend="date_time.examples.print_holidays">打印假日
</link> 示范了详细的用法。</entry>
</row>
<row>
<entry valign="top"
morerows="1"><screen>last_day_of_the_week_in_month(greg_weekday,
greg_month)
date get_date(greg_year year)</screen></entry>
- <entry>Calculate something like last Monday of January</entry>
+ <entry>Calculate something like last Monday of January<sbr/>
+ 计算象一月的最后一个星期天这样的日期。</entry>
</row>
<row>
<entry><screen>last_day_of_the_week_in_month lwdm(Monday,Jan);
@@ -74,7 +85,8 @@
<entry valign="top"
morerows="1"><screen>first_day_of_the_week_in_month(greg_weekday,
greg_month)
date get_date(greg_year year)</screen></entry>
- <entry>Calculate something like first Monday of January</entry>
+ <entry>Calculate something like first Monday of January<sbr/>
+ 计算象一月的第一个星期一这样的日期。</entry>
</row>
<row>
<entry><screen>first_day_of_the_week_in_month fdm(Monday,Jan);
@@ -88,7 +100,10 @@
greg_weekday,
greg_month)
date get_date(greg_year year)</screen></entry>
- <entry><code>week_num</code> is a public enum member of
<code>nth_day_of_the_week_in_month</code>. Calculate something like first
Monday of January, second Tuesday of March, Third Sunday of December, etc.
(first through fifth are provided, fifth is the equivalent of last)</entry>
+ <entry><code>week_num</code> is a public enum member of
<code>nth_day_of_the_week_in_month</code>. Calculate something like first
Monday of January, second Tuesday of March, Third Sunday of December, etc.
(first through fifth are provided, fifth is the equivalent of last)<sbr/>
+ <code>week_num</code> 是
<code>nth_day_of_the_week_in_month</code> 的一个公有枚举成员。
+ 计算象一月的第一个星期一、三月的第二个星期二、十二月的第三个星期
日等这样的日期。
+ (支持第一到第五个，第五个相当于最后一个)</entry>
</row>
<row>
<entry><screen>typedef nth_day_of_the_week_in_month nth_dow;
@@ -101,7 +116,8 @@
<row>
<entry valign="top" morerows="1"><screen>partial_date(greg_day,
greg_month)
date get_date(greg_year year)</screen></entry>
- <entry>Generates a date by applying the year to the given month and
day.</entry>
+ <entry>Generates a date by applying the year to the given month and
day.<sbr/>
+ 为给定的月份和日子提供一个年份以生成日期。</entry>
</row>
<row>
<entry><screen>partial_date pd(1,Jan);
@@ -113,7 +129,8 @@
<row>
<entry valign="top"
morerows="1"><screen>first_day_of_the_week_after(greg_weekday)
date get_date(date d)</screen></entry>
- <entry>Calculate something like First Sunday after Jan 1,2002</entry>
+ <entry>Calculate something like First Sunday after Jan 1,2002<sbr/>
+ 计算象 Jan 1,2002 后的第一个星期天这样的日期。</entry>
</row>
<row>
<entry><screen>first_day_of_the_week_after fdaf(Monday);
@@ -125,7 +142,8 @@
<row>
<entry valign="top"
morerows="1"><screen>first_day_of_the_week_before(greg_weekday)
date get_date(date d)</screen></entry>
- <entry>Calculate something like First Monday before Feb 1,2002</entry>
+ <entry>Calculate something like First Monday before Feb 1,2002<sbr/>
+ 计算象 Feb 1,2002 之前的第一个星期一这样的日期。</entry>
</row>
<row>
<entry><screen>first_day_of_the_week_before fdbf(Monday);
@@ -139,25 +157,26 @@
<anchor id="algo_func_overview" />
- <bridgehead renderas="sect3">Function Overview</bridgehead>
+ <bridgehead renderas="sect3">Function Overview 函数概要</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Function Prototype</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Function Prototype 函数原型</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>days days_until_weekday date,
greg_weekday)</screen></entry>
- <entry> Calculates the number of days from given date until given
weekday.</entry>
+ <entry> Calculates the number of days from given date until given
weekday.<sbr/>
+ 计算从给定日期到给定周日的天数。</entry>
</row>
<row>
- <entry><screen>date d(2004,Jun,1); // Tuesday
+ <entry><screen>date d(2004,Jun,1); // Tuesday 星期二
greg_weekday gw(Friday);
days_until_weekday(d, gw); // 3 days</screen>
</entry>
@@ -165,10 +184,11 @@
<row>
<entry valign="top" morerows="1"><screen>days days_before_weekday(date,
greg_weekday)</screen></entry>
- <entry> Calculates the number of day from given date to previous given
weekday.</entry>
+ <entry> Calculates the number of day from given date to previous given
weekday.<sbr/>
+ 计算从给定日期到前一个给定周日的天数。</entry>
</row>
<row>
- <entry><screen>date d(2004,Jun,1); // Tuesday
+ <entry><screen>date d(2004,Jun,1); // Tuesday 星期二
greg_weekday gw(Friday);
days_before_weekday(d, gw); // 4 days</screen>
</entry>
@@ -176,10 +196,11 @@
<row>
<entry valign="top" morerows="1"><screen>date next_weekday(date,
greg_weekday)</screen></entry>
- <entry> Generates a date object representing the date of the following
weekday from the given date.</entry>
+ <entry> Generates a date object representing the date of the following
weekday from the given date.<sbr/>
+ 生成一个 date 对象，表示给定日期之后的某个周日的日期。</entry>
</row>
<row>
- <entry><screen>date d(2004,Jun,1); // Tuesday
+ <entry><screen>date d(2004,Jun,1); // Tuesday 星期二
greg_weekday gw(Friday);
next_weekday(d, gw); // 2004-Jun-4</screen>
</entry>
@@ -187,10 +208,11 @@
<row>
<entry valign="top" morerows="1"><screen>date previous_weekday(date,
greg_weekday)</screen></entry>
- <entry> Generates a date object representing the date of the previous
weekday from the given date.</entry>
+ <entry> Generates a date object representing the date of the previous
weekday from the given date.<sbr/>
+ 生成一个 date 对象，表示给定日期之前的某个周日的日期。</entry>
</row>
<row>
- <entry><screen>date d(2004,Jun,1); // Tuesday
+ <entry><screen>date d(2004,Jun,1); // Tuesday 星期二
greg_weekday gw(Friday);
previous_weekday(d, gw); // 2004-May-28</screen>
</entry>
=======================================
--- /trunk/libs/date_time/xmldoc/date_class.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/date_class.xml Wed Jan 6 17:26:22 2010
@@ -8,20 +8,20 @@
-->
<section id="date_time.gregorian.date_class">
- <title>Date</title>
-
- <link linkend="date_intro">Introduction</link> --
- <link linkend="date_header">Header</link> --
- <link linkend="date_construction">Construction</link> --
- <link linkend="date_construct_from_string">Construct from String</link>
--
- <link linkend="date_construct_from_clock">Construct from Clock</link> --
- <link linkend="date_accessors">Accessors</link> --
- <link linkend="date_convert_to_string">Convert to String</link> --
- <link linkend="date_operators">Operators</link> --
- <link linkend="date_tm_funcs">Struct tm Functions</link>
+ <title>Date 日期</title>
+
+ <link linkend="date_intro">Introduction 简介</link> --
+ <link linkend="date_header">Header 头文件</link> --
+ <link linkend="date_construction">Construction 构造</link> --
+ <link linkend="date_construct_from_string">Construct from String 从字符串
构造</link> --
+ <link linkend="date_construct_from_clock">Construct from Clock 从时钟构造
</link> --
+ <link linkend="date_accessors">Accessors 访问器</link> --
+ <link linkend="date_convert_to_string">Convert to String 转换为字符串
</link> --
+ <link linkend="date_operators">Operators 操作符</link> --
+ <link linkend="date_tm_funcs">Struct tm Functions Struct tm 函数</link>
<anchor id="date_intro" />
- <bridgehead renderas="sect3">Introduction</bridgehead>
+ <bridgehead renderas="sect3">Introduction 简介</bridgehead>
<para>
The class boost::gregorian::date is the primary interface for date
programming. In general,
the date class is immutable once constructed although it does allow
assignment from another
@@ -29,13 +29,20 @@
Techniques for creating dates include reading the
<link linkend="date_construct_from_clock">current date from the
clock</link>,
using <link linkend="date_time.gregorian.date_iterators">date
iterators</link>, and
- <link linkend="date_time.gregorian.date_algorithms">date algorithms or
generators</link>.
+ <link linkend="date_time.gregorian.date_algorithms">date algorithms or
generators</link>. <sbr/>
+ 类 boost::gregorian::date 是日期编程的主要接口。通常 date 类一旦构造出
来就是不可变的，
+ 不过它也允许从另一个 date 进行赋值。创建 date 的方法包括：
+ <link linkend="date_construct_from_clock">从时钟读取当前日期</link>，
+ 使用 <link linkend="date_time.gregorian.date_iterators">日期迭代器
</link>，
+ 以及 <link linkend="date_time.gregorian.date_algorithms">日期算法或生成
器</link>。
</para>
<para>
Internally boost::gregorian::date is stored as a 32 bit integer type.
The class is specifically
designed to NOT contain virtual functions. This design allows for
efficient
- calculation and memory usage with large collections of dates.
+ calculation and memory usage with large collections of dates.<sbr/>
+ 在内部，boost::gregorian::date 是保存为一个32位整数类型的。该类特别被设
计为不含虚函数。
+ 这样的设计可以进行高效的运算，以及处理大量日期时具有高效的内存使用率。
</para>
<para>
@@ -43,34 +50,39 @@
construct an 'invalid' date. That is 2001-Feb-29 cannot be
constructed as a date.
Various exceptions derived from std::out_of_range are thrown to
indicate which aspect
of the date input is invalid. Note that the
- special value not-a-date-time can be used as 'invalid' or 'null' date
if so desired.
+ special value not-a-date-time can be used as 'invalid' or 'null' date
if so desired.<sbr/>
+ 构造一个 date 时将检查所有的输入，所以不可能构造一个无效的 date.
+ 如 2001-Feb-29 就不可能被构造为一个 date. 多个派生自 std::out_of_range
的异常将被抛出以表示日期输入的哪个方面有错。
+ 注意，如果需要，可以用一个无效日期的特殊值来作为 '无效' 或 '空' 的
date.
</para>
<anchor id="date_header" />
- <bridgehead renderas="sect3">Header</bridgehead>
+ <bridgehead renderas="sect3">Header 头文件</bridgehead>
<para>
- <programlisting>#include "boost/date_time/gregorian/gregorian.hpp"
//include all types plus i/o
+ <programlisting>#include "boost/date_time/gregorian/gregorian.hpp"
//include all types plus i/o 包含所有类型及i/o
or
-#include "boost/date_time/gregorian/gregorian_types.hpp" //no i/o just
types</programlisting>
+#include "boost/date_time/gregorian/gregorian_types.hpp" //no i/o just
types 只有类型不含i/o</programlisting>
</para>
<anchor id="date_construction" />
- <bridgehead renderas="sect3">Construction</bridgehead>
+ <bridgehead renderas="sect3">Construction 构造</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>date(greg_year, greg_month,
greg_day)</screen></entry>
- <entry>Construct from parts of date. Throws bad_year, bad_day_of_month,
or bad_day_month (derivatives of std::out_of_range) if the year, month or
day are out of range.</entry>
+ <entry>Construct from parts of date. Throws bad_year, bad_day_of_month,
or bad_day_month (derivatives of std::out_of_range) if the year, month or
day are out of range.<sbr/>
+ 从日期的各部分进行构造。如果年、月或日超出范围，则抛出 bad_year,
bad_day_of_month, 或 bad_day_month
+ (均派生自 std::out_of_range)。</entry>
</row>
<row>
<entry><screen>date d(2002,Jan,10);</screen></entry>
@@ -78,7 +90,8 @@
<row>
<entry valign="top" morerows="1"><screen>date(date d)</screen></entry>
- <entry>Copy constructor</entry>
+ <entry>Copy constructor<sbr/>
+ 复制构造函数</entry>
</row>
<row>
<entry><screen>date d1(d);</screen></entry>
@@ -86,7 +99,8 @@
<row>
<entry valign="top" morerows="1"><screen>date(special_values
sv)</screen></entry>
- <entry>Constructor for infinities, not-a-date-time, max_date_time, and
min_date_time</entry>
+ <entry>Constructor for infinities, not-a-date-time, max_date_time, and
min_date_time<sbr/>
+ 无限日期、无效日期、最大日期、最小日期的构造函函数</entry>
</row>
<row>
<entry><screen>date d1(neg_infin);
@@ -98,7 +112,9 @@
<row>
<entry valign="top" morerows="1"><screen>date()</screen></entry>
- <entry>Default constructor. Creates a date object initialized to
not_a_date_time. NOTE: this constructor can be disabled by defining
DATE_TIME_NO_DEFAULT_CONSTRUCTOR (see compiler_config.hpp)</entry>
+ <entry>Default constructor. Creates a date object initialized to
not_a_date_time. NOTE: this constructor can be disabled by defining
DATE_TIME_NO_DEFAULT_CONSTRUCTOR (see compiler_config.hpp)<sbr/>
+ 缺省构造函数。创建一个 date 对象，初始化为 not_a_date_time. 注：这个
构造函数可以通过定义
+ DATE_TIME_NO_DEFAULT_CONSTRUCTOR 来禁止(请见 compiler_config.hpp)。
</entry>
</row>
<row>
<entry><screen>date d; // d =>
not_a_date_time</screen></entry>
@@ -108,22 +124,23 @@
</informaltable>
<anchor id="date_construct_from_string" />
- <bridgehead renderas="sect3">Construct from String</bridgehead>
+ <bridgehead renderas="sect3">Construct from String 从字符串构造
</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>date
from_string(std::string)</screen></entry>
- <entry>From delimited date string where with order year-month-day eg:
2002-1-25</entry>
+ <entry>From delimited date string where with order year-month-day eg:
2002-1-25<sbr/>
+ 从日期字符串构造，字符串的顺序应为年-月-日，如：2002-1-25</entry>
</row>
<row>
<entry><screen>std::string ds("2002/1/25");
@@ -132,7 +149,8 @@
<row>
<entry valign="top" morerows="1"><screen>date
from_undelimited_string(std::string)</screen></entry>
- <entry>From iso type date string where with order year-month-day eg:
20020125</entry>
+ <entry>From iso type date string where with order year-month-day eg:
20020125<sbr/>
+ 从 iso 类型的日期字符串构造，顺序为年-月-日，如：20020125</entry>
</row>
<row>
<entry><screen>std::string ds("20020125");
@@ -143,22 +161,23 @@
</informaltable>
<anchor id="date_construct_from_clock" />
- <bridgehead renderas="sect3">Construct from Clock</bridgehead>
+ <bridgehead renderas="sect3">Construct from Clock 从时钟构造</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"
morerows="1"><screen>day_clock::local_day()</screen></entry>
- <entry>Get the local day based on the time zone settings of the
computer.</entry>
+ <entry>Get the local day based on the time zone settings of the
computer.<sbr/>
+ 取出本地日期，基于计算机的时区设置。</entry>
</row>
<row>
<entry><screen>date d(day_clock::local_day());</screen></entry>
@@ -166,7 +185,8 @@
<row>
<entry valign="top"
morerows="1"><screen>day_clock::universal_day()</screen></entry>
- <entry>Get the UTC day.</entry>
+ <entry>Get the UTC day.<sbr/>
+ 取出UTC日期。</entry>
</row>
<row>
<entry><screen>date d(day_clock::universal_day());</screen></entry>
@@ -176,22 +196,23 @@
</informaltable>
<anchor id="date_accessors" />
- <bridgehead renderas="sect3">Accessors</bridgehead>
+ <bridgehead renderas="sect3">Accessors 访问器</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>greg_year year()
const</screen></entry>
- <entry>Get the year part of the date.</entry>
+ <entry>Get the year part of the date.<sbr/>
+ 取出日期中的年份。</entry>
</row>
<row>
<entry><screen>date d(2002,Jan,10);
@@ -200,7 +221,8 @@
<row>
<entry valign="top" morerows="1"><screen>greg_month month()
const</screen></entry>
- <entry>Get the month part of the date.</entry>
+ <entry>Get the month part of the date.<sbr/>
+ 取出日期中的月份。</entry>
</row>
<row>
<entry><screen>date d(2002,Jan,10);
@@ -209,7 +231,8 @@
<row>
<entry valign="top" morerows="1"><screen>greg_day day()
const</screen></entry>
- <entry> Get the day part of the date.</entry>
+ <entry> Get the day part of the date.<sbr/>
+ 取出日期中的日子。</entry>
</row>
<row>
<entry><screen>date d(2002,Jan,10);
@@ -218,7 +241,8 @@
<row>
<entry valign="top" morerows="1"><screen>greg_ymd year_month_day()
const</screen></entry>
- <entry>Return a year_month_day struct. More efficient when all 3 parts
of the date are needed.</entry>
+ <entry>Return a year_month_day struct. More efficient when all 3 parts
of the date are needed.<sbr/>
+ 返回一个 year_month_day 结构。在需要日期的所有三个组成部分时，这一方
法更高效。</entry>
</row>
<row>
<entry><screen>date d(2002,Jan,10);
@@ -230,16 +254,18 @@
<row>
<entry valign="top" morerows="1"><screen>greg_day_of_week day_of_week()
const</screen></entry>
- <entry>Get the day of the week (Sunday, Monday, etc.)</entry>
+ <entry>Get the day of the week (Sunday, Monday, etc.)<sbr/>
+ 返回星期几(如：星期天、星期一等等)。</entry>
</row>
<row>
<entry><screen>date d(2002,Jan,10);
-d.day(); // --> Thursday</screen></entry>
+d.day(); // --> Thursday 星期四</screen></entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>greg_day_of_year day_of_year()
const</screen></entry>
- <entry>Get the day of the year. Number from 1 to 366 </entry>
+ <entry>Get the day of the year. Number from 1 to 366 <sbr/>
+ 返回本年的第几天。从 1 到 366 </entry>
</row>
<row>
<entry><screen>date d(2000,Jan,10);
@@ -248,7 +274,8 @@
<row>
<entry valign="top" morerows="1"><screen>date end_of_month()
const</screen></entry>
- <entry>Returns a <code>date</code> object set to the last day of
the calling objects current month.</entry>
+ <entry>Returns a <code>date</code> object set to the last day of
the calling objects current month.<sbr/>
+ 返回一个 <code>date</code> 对象，设置为传入对象当月的最后一天。
</entry>
</row>
<row>
<entry><screen>date d(2000,Jan,10);
@@ -257,7 +284,8 @@
<row>
<entry valign="top" morerows="1"><screen>bool is_infinity()
const</screen></entry>
- <entry>Returns true if date is either positive or negative
infinity</entry>
+ <entry>Returns true if date is either positive or negative
infinity<sbr/>
+ 返回 true 如果 date 为正无限或负无限。</entry>
</row>
<row>
<entry><screen>date d(pos_infin);
@@ -266,7 +294,8 @@
<row>
<entry valign="top" morerows="1"><screen>bool is_neg_infinity()
const</screen></entry>
- <entry>Returns true if date is negative infinity</entry>
+ <entry>Returns true if date is negative infinity<sbr/>
+ 返回 true 如果 date 为负无限。</entry>
</row>
<row>
<entry><screen>date d(neg_infin);
@@ -275,7 +304,8 @@
<row>
<entry valign="top" morerows="1"><screen>bool is_pos_infinity()
const</screen></entry>
- <entry>Returns true if date is positive infinity</entry>
+ <entry>Returns true if date is positive infinity<sbr/>
+ 返回 true 如果 date 为正无限。</entry>
</row>
<row>
<entry><screen>date d(neg_infin);
@@ -284,7 +314,8 @@
<row>
<entry valign="top" morerows="1"><screen>bool is_not_a_date()
const</screen></entry>
- <entry>Returns true if value is not a date</entry>
+ <entry>Returns true if value is not a date<sbr/>
+ 返回 true 如果 date 不是一个日期。</entry>
</row>
<row>
<entry><screen>date d(not_a_date_time);
@@ -293,7 +324,8 @@
<row>
<entry valign="top" morerows="1"><screen>bool is_special()
const</screen></entry>
- <entry>Returns true if date is any
<code>special_value</code></entry>
+ <entry>Returns true if date is any
<code>special_value</code><sbr/>
+ 返回 true 如果 date 为任意 <code>special_value</code> </entry>
</row>
<row>
<entry><screen>date d(pos_infin);
@@ -306,7 +338,8 @@
<row>
<entry valign="top" morerows="1"><screen>special_value as_special()
const</screen></entry>
- <entry>Returns represented <code>special_value</code> or
<code>not_special</code> if the represented date is a normal date.</entry>
+ <entry>Returns represented <code>special_value</code> or
<code>not_special</code> if the represented date is a normal date.<sbr/>
+ 返回相应的 <code>special_value</code>，或者返回
<code>not_special</code> 如果 date 为正常日期。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -314,7 +347,8 @@
<row>
<entry valign="top" morerows="1"><screen>long modjulian_day()
const</screen></entry>
- <entry>Returns the modified julian day for the date.</entry>
+ <entry>Returns the modified julian day for the date.<sbr/>
+ 返回修正后的罗马儒略历日期。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -322,7 +356,8 @@
<row>
<entry valign="top" morerows="1"><screen>long julian_day()
const</screen></entry>
- <entry>Returns the julian day for the date.</entry>
+ <entry>Returns the julian day for the date.<sbr/>
+ 返回罗马儒略历日期。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -330,18 +365,20 @@
<row>
<entry valign="top" morerows="1"><screen>int week_number()
const</screen></entry>
- <entry>Returns the ISO 8601 week number for the date.</entry>
+ <entry>Returns the ISO 8601 week number for the date.<sbr/>
+ 返回 ISO 8601 的周数。</entry>
</row>
<row>
<entry><screen></screen></entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>date end_of_month_day()
const</screen></entry>
- <entry>Returns the last day of the month for the date.</entry>
+ <entry>Returns the last day of the month for the date.<sbr/>
+ 返回当月的最后一天。</entry>
</row>
<row>
<entry><screen>date d(2000,Feb,1);
-//gets Feb 28 -- 2000 was leap year
+//gets Feb 28 -- 2000 was leap year 取得 Feb 28 -- 2000 为闰年
date eom = d.end_of_month_day();</screen></entry>
</row>
</tbody>
@@ -349,22 +386,23 @@
</informaltable>
<anchor id="date_convert_to_string" />
- <bridgehead renderas="sect3">Convert to String</bridgehead>
+ <bridgehead renderas="sect3">Convert to String 转换为字符串</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>std::string
to_simple_string(date d)</screen></entry>
- <entry>To <code>YYYY-mmm-DD</code> string where <code>mmm</code>
is a 3 char month name.</entry>
+ <entry>To <code>YYYY-mmm-DD</code> string where <code>mmm</code>
is a 3 char month name.<sbr/>
+ 转换为 YYYY-mmm-DD 字符串，其中 mmm 为3字符的月份名。</entry>
</row>
<row>
<entry><screen>"2002-Jan-01"</screen></entry>
@@ -372,7 +410,8 @@
<row>
<entry valign="top" morerows="1"><screen>std::string to_iso_string(date
d)</screen></entry>
- <entry>To <code>YYYYMMDD</code> where all components are
integers.</entry>
+ <entry>To <code>YYYYMMDD</code> where all components are
integers.<sbr/>
+ 转换为 YYYYMMDD，所有部分均为整数。</entry>
</row>
<row>
<entry><screen>"20020131"</screen></entry>
@@ -380,7 +419,8 @@
<row>
<entry valign="top" morerows="1"><screen>std::string
to_iso_extended_string(date d)</screen></entry>
- <entry> To <code>YYYY-MM-DD</code> where all components are
integers.</entry>
+ <entry> To <code>YYYY-MM-DD</code> where all components are
integers.<sbr/>
+ 转换为 YYYY-MM-DD，所有部分均为整数。</entry>
</row>
<row>
<entry><screen>"2002-01-31"</screen></entry>
@@ -390,22 +430,23 @@
</informaltable>
<anchor id="date_operators" />
- <bridgehead renderas="sect3">Operators</bridgehead>
+ <bridgehead renderas="sect3">Operators 操作符</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"
morerows="1"><screen>operator<<</screen></entry>
- <entry>Stream output operator</entry>
+ <entry>Stream output operator<sbr/>
+ 流输出操作符</entry>
</row>
<row>
<entry><screen>date d(2002,Jan,1);
@@ -415,7 +456,9 @@
<row>
<entry valign="top"
morerows="1"><screen>operator>></screen></entry>
- <entry>Stream input operator. <emphasis
role="strong">Note:</emphasis> As of version 1.33, streaming operations
have been greatly improved. See <link linkend="date_time.date_time_io">Date
Time IO System</link> for details on exceptions and error
conditions.</entry>
+ <entry>Stream input operator. <emphasis
role="strong">Note:</emphasis> As of version 1.33, streaming operations
have been greatly improved. See <link linkend="date_time.date_time_io">Date
Time IO System</link> for details on exceptions and error conditions.<sbr/>
+ 流输入操作符。<emphasis role="strong">注：</emphasis>与版本1.33相
比，流操作已进行了显著改进。
+ 有关异常和错误条件的详情请见 <link
linkend="date_time.date_time_io">日期时间IO系统</link>。</entry>
</row>
<row>
<entry><screen>date d(not_a_date_time);
@@ -428,7 +471,8 @@
<entry valign="top" morerows="1"><screen>operator==, operator!=,
operator>, operator<,
operator>=, operator<=</screen></entry>
- <entry>A full complement of comparison operators</entry>
+ <entry>A full complement of comparison operators<sbr/>
+ 完整的比较操作符</entry>
</row>
<row>
<entry><screen>d1 == d2, etc</screen></entry>
@@ -436,7 +480,8 @@
<row>
<entry valign="top" morerows="1"><screen>date operator+(date_duration)
const</screen></entry>
- <entry>Return a date adding a day offset</entry>
+ <entry>Return a date adding a day offset<sbr/>
+ 返回加上一个日期偏移量后的 date</entry>
</row>
<row>
<entry><screen>date d(2002,Jan,1);
@@ -447,7 +492,8 @@
<row>
<entry valign="top" morerows="1"><screen>date operator-(date_duration)
const</screen></entry>
- <entry>Return a date by substracting a day offset</entry>
+ <entry>Return a date by substracting a day offset<sbr/>
+ 返回减去一个日期偏移量后的 date</entry>
</row>
<row>
<entry><screen>date d(2002,Jan,1);
@@ -458,7 +504,8 @@
<row>
<entry valign="top" morerows="1"><screen>date_duration operator-(date)
const</screen></entry>
- <entry>Return a date_duration by subtracting two dates</entry>
+ <entry>Return a date_duration by subtracting two dates<sbr/>
+ 对两个 date 进行相减，返回一个 date_duration</entry>
</row>
<row>
<entry><screen>date d1(2002,Jan,1);
@@ -471,23 +518,26 @@
</informaltable>
<anchor id="date_tm_funcs" />
- <bridgehead renderas="sect3">Struct tm Functions</bridgehead>
- <para>Functions for converting a <code>date</code> object to, and from,
a <code>tm</code> struct are provided.</para>
+ <bridgehead renderas="sect3">Struct tm Functions Struct tm 函数
</bridgehead>
+ <para>Functions for converting a <code>date</code> object to, and from,
a <code>tm</code> struct are provided.<sbr/>
+ 以下函数用于 <code>date</code> 对象与 <code>tm</code> 结构的互转。</para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>tm
to_tm(date)</screen></entry>
- <entry>A function for converting a <code>date</code> object to a
<code>tm</code> struct. The fields: <code>tm_hour</code>,
<code>tm_min</code>, and <code>tm_sec</code> are set to zero. The
<code>tm_isdst</code> field is set to -1.</entry>
+ <entry>A function for converting a <code>date</code> object to a
<code>tm</code> struct. The fields: <code>tm_hour</code>,
<code>tm_min</code>, and <code>tm_sec</code> are set to zero. The
<code>tm_isdst</code> field is set to -1.<sbr/>
+ 将 <code>date</code> 对象转换为 <code>tm</code> 结构。字段
<code>tm_hour</code>, <code>tm_min</code>,
+ 和 <code>tm_sec</code> 均设为零。<code>tm_isdst</code> 字段设为
-1.</entry>
</row>
<row>
<entry><screen>date d(2005,Jan,1);
@@ -506,7 +556,9 @@
<row>
<entry valign="top" morerows="1"><screen>date date_from_tm(tm
datetm)</screen></entry>
- <entry>A function for converting a <code>tm</code> struct to a
<code>date</code> object. The fields: <code>tm_wday </code>, <code>tm_yday
</code>, <code>tm_hour</code>, <code>tm_min</code>, <code>tm_sec</code>,
and <code>tm_isdst</code> are ignored.</entry>
+ <entry>A function for converting a <code>tm</code> struct to a
<code>date</code> object. The fields: <code>tm_wday </code>, <code>tm_yday
</code>, <code>tm_hour</code>, <code>tm_min</code>, <code>tm_sec</code>,
and <code>tm_isdst</code> are ignored.<sbr/>
+ 将 <code>tm</code> 结构转换为 <code>date</code> 对象。字段
<code>tm_wday</code>, <code>tm_yday</code>,
+ <code>tm_hour</code>, <code>tm_min</code>, <code>tm_sec</code>,
和 <code>tm_isdst</code> 均忽略。</entry>
</row>
<row>
<entry><screen>tm d_tm;
=======================================
--- /trunk/libs/date_time/xmldoc/date_duration.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/date_duration.xml Wed Jan 6 17:26:22 2010
@@ -8,49 +8,54 @@
-->
<section xmlns:xi="http://www.w3.org/2001/XInclude";
id="date_time.gregorian.date_duration">
- <title>Date Duration (aka Days)</title>
-
- <link linkend="duration_intro">Introduction</link> --
- <link linkend="duration_header">Header</link> --
- <link linkend="duration_construction">Construction</link> --
- <link linkend="duration_accessors">Accessors</link> --
- <link linkend="duration_operators">Operators</link> --
- <link linkend="additional_duration_types">Additional Duration
Types</link>
+ <title>Date Duration (aka Days) 日期长度</title>
+
+ <link linkend="duration_intro">Introduction 简介</link> --
+ <link linkend="duration_header">Header 头文件</link> --
+ <link linkend="duration_construction">Construction 构造</link> --
+ <link linkend="duration_accessors">Accessors 访问器</link> --
+ <link linkend="duration_operators">Operators 操作符</link> --
+ <link linkend="additional_duration_types">Additional Duration Types 其它
日期长度类型</link>
<anchor id="duration_intro" />
- <bridgehead renderas="sect3">Introduction</bridgehead>
+ <bridgehead renderas="sect3">Introduction 简介</bridgehead>
<para>
- The class boost::gregorian::date_duration is a simple day count used
for arithmetic with <link
linkend="date_time.gregorian.date_class">gregorian::date</link>. A duration
can be either positive or negative.
+ The class boost::gregorian::date_duration is a simple day count used
for arithmetic with <link
linkend="date_time.gregorian.date_class">gregorian::date</link>. A duration
can be either positive or negative. <sbr/>
+ 类 boost::gregorian::date_duration 是一个简单的日子计数器，用于
+ <link linkend="date_time.gregorian.date_class">gregorian::date</link>
的运算。日期长度可正可负。
</para>
<para>
- As of version 1_32 the date_duration class has been typedef'd as days
in the boost::gregorian namespace. Throughout the examples you will find
days used instead of date_duration.
+ As of version 1_32 the date_duration class has been typedef'd as days
in the boost::gregorian namespace. Throughout the Examples you will find
days used instead of date_duration.<sbr/>
+ 和版本1_32一样，date_duration 类被 typedef 为 boost::gregorian 名字空间
中的 days.
+ 在以下所有例子中，你都能看到 days 被用于替代 date_duration.
</para>
<anchor id="duration_header" />
- <bridgehead renderas="sect3">Header</bridgehead>
+ <bridgehead renderas="sect3">Header 头文件</bridgehead>
<para>
- <programlisting>#include "boost/date_time/gregorian/gregorian.hpp"
//include all types plus i/o
+ <programlisting>#include "boost/date_time/gregorian/gregorian.hpp"
//include all types plus i/o 包含所有类型以及i/o
or
-#include "boost/date_time/gregorian/gregorian_types.hpp" //no i/o just
types</programlisting>
+#include "boost/date_time/gregorian/gregorian_types.hpp" //no i/o just
types 只有类型没有i/o</programlisting>
</para>
<anchor id="duration_construction" />
- <bridgehead renderas="sect3">Construction</bridgehead>
+ <bridgehead renderas="sect3">Construction 构造</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"
morerows="1"><screen>date_duration(long)</screen></entry>
- <entry>Create a duration count.</entry>
+ <entry>Create a duration count.<sbr/>
+ 创建一个日期长度计数。</entry>
</row>
<row>
<entry><screen>date_duration dd(3); //3 days</screen></entry>
@@ -58,7 +63,8 @@
<row>
<entry valign="top" morerows="1"><screen>days(special_values
sv)</screen></entry>
- <entry>Constructor for infinities, not-a-date-time, max_date_time, and
min_date_time</entry>
+ <entry>Constructor for infinities, not-a-date-time, max_date_time, and
min_date_time<sbr/>
+ 无限长度、非日期、最大日期、最小日期的构造函数</entry>
</row>
<row>
<entry><screen>days dd1(neg_infin);
@@ -73,22 +79,23 @@
</informaltable>
<anchor id="duration_accessors" />
- <bridgehead renderas="sect3">Accessors</bridgehead>
+ <bridgehead renderas="sect3">Accessors 访问器</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>long days()
const</screen></entry>
- <entry>Get the day count.</entry>
+ <entry>Get the day count.<sbr/>
+ 返回 days 的计数。</entry>
</row>
<row>
<entry><screen>date_duration dd(3); dd.days() --> 3</screen></entry>
@@ -96,7 +103,8 @@
<row>
<entry valign="top" morerows="1"><screen>bool is_negative()
const</screen></entry>
- <entry>True if number of days is less than zero.</entry>
+ <entry>True if number of days is less than zero.<sbr/>
+ 返回 true 如果 days 小于零。</entry>
</row>
<row>
<entry><screen>date_duration dd(-1); dd.is_negative() -->
true</screen></entry>
@@ -104,7 +112,8 @@
<row>
<entry valign="top" morerows="1"><screen>static date_duration
unit()</screen></entry>
- <entry>Return smallest possible unit of duration type.</entry>
+ <entry>Return smallest possible unit of duration type.<sbr/>
+ 返回日期长度类型的最小可能单元。</entry>
</row>
<row>
<entry><screen>date_duration::unit() -->
date_duration(1)</screen></entry>
@@ -112,7 +121,8 @@
<row>
<entry valign="top" morerows="1"><screen>bool is_special()
const</screen></entry>
- <entry>Returns true if days is any
<code>special_value</code></entry>
+ <entry>Returns true if days is any
<code>special_value</code><sbr/>
+ 返回 true 如果 days 为任意 <code>special_value</code> </entry>
</row>
<row>
<entry><screen>days dd(pos_infin);
@@ -128,22 +138,24 @@
</informaltable>
<anchor id="duration_operators" />
- <bridgehead renderas="sect3">Operators</bridgehead>
+ <bridgehead renderas="sect3">Operators 操作符</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>operator<<,
operator>></screen></entry>
- <entry>Streaming operators. <emphasis
role="strong">Note:</emphasis> As of version 1.33, streaming operations
have been greatly improved. See <link linkend="date_time.date_time_io">Date
Time IO System</link> for more details (including exceptions and error
conditions).</entry>
+ <entry>Streaming operators. <emphasis
role="strong">Note:</emphasis> As of version 1.33, streaming operations
have been greatly improved. See <link linkend="date_time.date_time_io">Date
Time IO System</link> for more details (including exceptions and error
conditions).<sbr/>
+ 流操作符。<emphasis role="strong">注：</emphasis>从版本1.33起，流
操作已经得到很大改进。
+ 详情请见 <link linkend="date_time.date_time_io">日期时间IO系统
</link> (包括异常和错误的情况)。</entry>
</row>
<row>
<entry><screen>date d(not_a_date_time);
@@ -159,7 +171,8 @@
operator>, operator<,
operator>=, operator<=</screen>
</entry>
- <entry>A full complement of comparison operators</entry>
+ <entry>A full complement of comparison operators<sbr/>
+ 完整的比较操作符。</entry>
</row>
<row>
<entry><screen>dd1 == dd2, etc</screen></entry>
@@ -167,7 +180,8 @@
<row>
<entry valign="top" morerows="1"><screen>date_duration
operator+(date_duration) const</screen></entry>
- <entry>Add date durations.</entry>
+ <entry>Add date durations.<sbr/>
+ 加日期长度。</entry>
</row>
<row>
<entry><screen>date_duration dd1(3);
@@ -178,7 +192,8 @@
<row>
<entry valign="top" morerows="1"><screen>date_duration
operator-(date_duration) const</screen></entry>
- <entry>Subtract durations.</entry>
+ <entry>Subtract durations.<sbr/>
+ 减日期长度。</entry>
</row>
<row>
<entry><screen>date_duration dd1(3);
@@ -191,23 +206,27 @@
</informaltable>
<anchor id="additional_duration_types" />
- <bridgehead renderas="sect3">Additional Duration Types</bridgehead>
+ <bridgehead renderas="sect3">Additional Duration Types 其它日期长度类型
</bridgehead>
<para>These additional types are logical representations of spans of
days.</para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>months(int
num_of_months)</screen></entry>
- <entry>A logical month representation. Depending on the usage,
this <code>months</code> object may cover a span of 28 to 31 days. The
objects also use a snap to end-of-month behavior when used in conjunction
with a date that is the last day of a given month. <emphasis
role="strong">WARNING: this behavior may lead to unexpected
results.</emphasis> See: <link linkend="snap_to_details">Reversibility of
Operations Pitfall</link> for complete details and alternatives.</entry>
+ <entry>A logical month representation. Depending on the usage,
this <code>months</code> object may cover a span of 28 to 31 days. The
objects also use a snap to end-of-month behavior when used in conjunction
with a date that is the last day of a given month. <emphasis
role="strong">WARNING: this behavior may lead to unexpected
results.</emphasis> See: <link linkend="snap_to_details">Reversibility of
Operations Pitfall</link> for complete details and alternatives.<sbr/>
+ 月份的逻辑表示法。根据不同的用法，<code>months</code> 对象可以表
示28到31天的跨度。
+ 该对象与某月的最后一天一起使用时，其行为会保持为月末。
+ <emphasis role="strong">警告：该行为可能导致非期望的结果。
</emphasis>
+ 完整的细节和其它请参见：<link linkend="snap_to_details">操作可逆
性的缺陷</link>。</entry>
</row>
<row>
<entry><screen>months single(1);
@@ -222,7 +241,8 @@
<row>
<entry valign="top" morerows="1"><screen>years(int
num_of_years)</screen></entry>
- <entry>A logical representation of a year. The
<code>years</code> object has the same behavior as the <code>months</code>
objects with regards to the end-of-the-month.</entry>
+ <entry>A logical representation of a year. The
<code>years</code> object has the same behavior as the <code>months</code>
objects with regards to the end-of-the-month.<sbr/>
+ 年份的逻辑表示法。<code>years</code> 对象具有与
<code>months</code> 对象的月末特殊行为相同的行为。</entry>
</row>
<row>
<entry><screen>years single(1);
@@ -234,7 +254,8 @@
<row>
<entry valign="top" morerows="1"><screen>weeks(int
num_of_weeks)</screen></entry>
- <entry>A duration type representing a number of <code>n *
7</code> days.</entry>
+ <entry>A duration type representing a number of <code>n *
7</code> days.<sbr/>
+ 表示 <code>n * 7</code> 天的日期长度类型。</entry>
</row>
<row>
<entry><screen>weeks single(1);
=======================================
--- /trunk/libs/date_time/xmldoc/date_facet.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/date_facet.xml Wed Jan 6 17:26:22 2010
@@ -8,39 +8,44 @@
-->
<section id="date_time.date_facet">
- <title>Date Facet</title>
-
- <link linkend="date_facet_intro">Introduction</link> -
- <link linkend="date_facet_constr">Construction</link> -
- <link linkend="date_facet_accessors">Accessors</link>
+ <title>Date Facet 日期Facet</title>
+
+ <link linkend="date_facet_intro">Introduction 简介</link> -
+ <link linkend="date_facet_constr">Construction 构造</link> -
+ <link linkend="date_facet_accessors">Accessors 访问器</link>
<anchor id="date_facet_intro" />
- <bridgehead renderas="sect3">Introduction</bridgehead>
- <para>The <code>boost::date_time::date_facet</code> enables users to
have significant control over the output streaming of dates (and other
gregorian objects). The date_facet is typedef'd in the
<code>gregorian</code> namespace as <code>date_facet</code> and
<code>wdate_facet</code>.
+ <bridgehead renderas="sect3">Introduction 简介</bridgehead>
+ <para>The <code>boost::date_time::date_facet</code> enables users to
have significant control over the output streaming of dates (and other
gregorian objects). The date_facet is typedef'd in the
<code>gregorian</code> namespace as <code>date_facet</code> and
<code>wdate_facet</code>. <sbr/>
+ <code>boost::date_time::date_facet</code> 让用户可以对日期(以及其它格里历
对象)的流输出进行控制。date_facet 被 typedef 为
+ <code>gregorian</code> 名字空间中的 <code>date_facet</code> 和
<code>wdate_facet</code>.
</para>
<anchor id="date_facet_constr" />
- <bridgehead renderas="sect3">Construction</bridgehead>
+ <bridgehead renderas="sect3">Construction 构造</bridgehead>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry>Syntax</entry>
- <entry>Description</entry>
+ <entry>Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"><screen>date_facet()</screen></entry>
- <entry>Default constructor</entry>
+ <entry>Default constructor<sbr/>
+ 缺省构造函数。</entry>
</row>
<row>
<entry valign="top"><screen>date_facet(...)
Parameters:
char_type* format
input_collection_type</screen></entry>
- <entry>Format given will be used for date output. All other
formats will use their defaults. Collection is the set of short names to be
used for months. All other name collections will use their defaults.</entry>
+ <entry>Format given will be used for date output. All other
formats will use their defaults. Collection is the set of short names to be
used for months. All other name collections will use their defaults.<sbr/>
+ format 指定了用于日期输出的格式。其它格式将使用它们的缺省值。
Collection 是用于月份的一组缩写名。
+ 其它的名字使用其缺省值。</entry>
</row>
<row>
<entry valign="top"><screen>date_facet(...)
@@ -49,7 +54,10 @@
period_formatter_type
special_values_formatter_type
date_gen_formatter_type</screen></entry>
- <entry>Format given will be used for date output. The
remaining parameters are formatter objects. Further details on these
objects can be found <link linkend="date_time.io_objects">here</link>. This
constructor also provides default arguments for all parameters except the
format. Therefore, <code>date_facet("%m %d %Y")</code> will work.</entry>
+ <entry>Format given will be used for date output. The
remaining parameters are formatter objects. Further details on these
objects can be found <link linkend="date_time.io_objects">here</link>. This
constructor also provides default arguments for all parameters except the
format. Therefore, <code>date_facet("%m %d %Y")</code> will work.<sbr/>
+ format 指定了用于日期输出的格式。其余参数为格式化器对象。有关这
些对象的更多详情请看
+ <link linkend="date_time.io_objects">这里</link>。这个构造函数
为 format 以外的所有参数提供了缺省值。
+ 因此，可以使用 <code>date_facet("%m %d %Y")</code>.</entry>
</row>
</tbody>
</tgroup>
@@ -57,23 +65,24 @@
</para>
<anchor id="date_facet_accessors" />
- <bridgehead renderas="sect3">Accessors</bridgehead>
+ <bridgehead renderas="sect3">Accessors 访问器</bridgehead>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>void
format(char_type*)</screen></entry>
- <entry>Set the format for dates.</entry>
+ <entry>Set the format for dates.<sbr/>
+ 设置日期的格式。</entry>
</row>
<row>
<entry><screen>date_facet* f = new date_facet();
@@ -82,7 +91,8 @@
<row>
<entry valign="top" morerows="1"><screen>void
set_iso_format()</screen></entry>
- <entry>Sets the date format to ISO</entry>
+ <entry>Sets the date format to ISO<sbr/>
+ 设置 ISO 格式。</entry>
</row>
<row>
<entry><screen>f->set_iso_format();
@@ -91,7 +101,8 @@
<row>
<entry valign="top" morerows="1"><screen>void
set_iso_extended_format()</screen></entry>
- <entry>Sets the date format to ISO Extended</entry>
+ <entry>Sets the date format to ISO Extended<sbr/>
+ 设置 ISO 扩展的日期格式。</entry>
</row>
<row>
<entry><screen>f->set_iso_extended_format();
@@ -100,7 +111,8 @@
<row>
<entry valign="top" morerows="1"><screen>void
month_format(char_type*)</screen></entry>
- <entry>Set the format for months when they are 'put'
individually.</entry>
+ <entry>Set the format for months when they are 'put'
individually.<sbr/>
+ 设置单独输出月份的格式。</entry>
</row>
<row>
<entry><screen>f->month_format("%B");
@@ -109,7 +121,8 @@
<row>
<entry valign="top" morerows="1"><screen>void
weekday_format(char_type*)</screen></entry>
- <entry>Set the format for weekdays when they are 'put'
individually.</entry>
+ <entry>Set the format for weekdays when they are 'put'
individually.<sbr/>
+ 设置单独输出周日的格式。</entry>
</row>
<row>
<entry><screen>f->weekday_format("%a");
@@ -120,20 +133,24 @@
<entry valign="top" morerows="1"><screen>void
period_formatter(...)
Parameter:
period_formatter_type</screen></entry>
- <entry>Replaces the period formatter object with a user
created one.</entry>
+ <entry>Replaces the period formatter object with a user
created one.<sbr/>
+ 以用户创建的对象替换时间段格式化器对象。</entry>
</row>
<row>
- <entry>see the <link
linkend="date_time.io_tutorial">tutorial</link> for a complete
example.</entry>
+ <entry>see the <link
linkend="date_time.io_tutorial">tutorial</link> for a complete
example.<sbr/>
+ 完整的例子请见 <link linkend="date_time.io_tutorial">指南
</link>。</entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>void
special_values_formatter(...)
Parameter:
special_values_formatter_type</screen></entry>
- <entry>Replaces the special_values formatter object with a
user created one.</entry>
+ <entry>Replaces the special_values formatter object with a
user created one.<sbr/>
+ 以用户创建的对象替换 special_values 格式化器对象。</entry>
</row>
<row>
- <entry>see the <link
linkend="date_time.io_tutorial">tutorial</link> for a complete
example.</entry>
+ <entry>see the <link
linkend="date_time.io_tutorial">tutorial</link> for a complete
example.<sbr/>
+ 完整的例子请见 <link linkend="date_time.io_tutorial">指南
</link>。</entry>
</row>
<row>
@@ -142,7 +159,11 @@
input_collection_type
date_gen_formatter_type::
phrase_elements</screen></entry>
- <entry>Sets new date generator phrase strings in
date_gen_formatter. The input collection is a vector of strings (for
details on these strings see <link
linkend="io_objects.date_generators">date generator formatter/parser
documentation</link>). The phrase_elements parameter is an enum, defined in
the date_generator_formatter object, that has a default value of 'first'.
It is used to indicate what the position of the first string in the
collection will be.</entry>
+ <entry>Sets new date generator phrase strings in
date_gen_formatter. The input collection is a vector of strings (for
details on these strings see <link
linkend="io_objects.date_generators">date generator formatter/parser
documentation</link>). The phrase_elements parameter is an enum, defined in
the date_generator_formatter object, that has a default value of 'first'.
It is used to indicate what the position of the first string in the
collection will be.<sbr/>
+ 在 date_gen_formatter 中设置新的日期生成器短语串。其中 input
collection 是一个字符串 vector
+ (有关这些字符串的具体说明请见 <link
linkend="io_objects.date_generators">日期生成器格式化器/分析器的文档
</link>)。
+ 参数 phrase_elements 为枚举类型，在 date_generator_formatter 对
象中定义，其缺省值为 'first'.
+ 它用于表示在 collection 第一个字符串的位置。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -152,40 +173,48 @@
<entry valign="top" morerows="1"><screen>void
short_weekday_names(...)
Parameter:
input_collection_type</screen></entry>
- <entry>Replace strings used when 'putting' short
weekdays.</entry>
+ <entry>Replace strings used when 'putting' short
weekdays.<sbr/>
+ 替换输出短周日名时使用的字符串。</entry>
</row>
<row>
- <entry>see the <link
linkend="date_time.io_tutorial">tutorial</link> for a complete
example.</entry>
+ <entry>see the <link
linkend="date_time.io_tutorial">tutorial</link> for a complete
example.<sbr/>
+ 完整的例子请见 <link linkend="date_time.io_tutorial">指南
</link>。</entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>void
long_weekday_names(...)
Parameter:
input_collection_type</screen></entry>
- <entry>Replace strings used when 'putting' long
weekdays.</entry>
+ <entry>Replace strings used when 'putting' long weekdays.<sbr/>
+ 替换输出长周日名时使用的字符串。</entry>
</row>
<row>
- <entry>see the <link
linkend="date_time.io_tutorial">tutorial</link> for a complete
example.</entry>
+ <entry>see the <link
linkend="date_time.io_tutorial">tutorial</link> for a complete
example.<sbr/>
+ 完整的例子请见 <link linkend="date_time.io_tutorial">指南
</link>。</entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>void
short_month_names(...)
Parameter:
input_collection_type</screen></entry>
- <entry>Replace strings used when 'putting' short
months.</entry>
+ <entry>Replace strings used when 'putting' short months.<sbr/>
+ 替换输出短月份名时使用的字符串。</entry>
</row>
<row>
- <entry>see the <link
linkend="date_time.io_tutorial">tutorial</link> for a complete
example.</entry>
+ <entry>see the <link
linkend="date_time.io_tutorial">tutorial</link> for a complete
example.<sbr/>
+ 完整的例子请见 <link linkend="date_time.io_tutorial">指南
</link>。</entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>void
long_month_names(...)
Parameter:
input_collection_type</screen></entry>
- <entry>Replace strings used when 'putting' long months.</entry>
+ <entry>Replace strings used when 'putting' long months.<sbr/>
+ 替换输出长月份名时使用的字符串。</entry>
</row>
<row>
- <entry>see the <link
linkend="date_time.io_tutorial">tutorial</link> for a complete
example.</entry>
+ <entry>see the <link
linkend="date_time.io_tutorial">tutorial</link> for a complete
example.<sbr/>
+ 完整的例子请见 <link linkend="date_time.io_tutorial">指南
</link>。</entry>
</row>
<row>
@@ -197,7 +226,9 @@
char_type
Unique parameter for 'put' funcs:
gregorian object</screen></entry>
- <entry>There are 12 put functions in the date_facet. The
common paraeters are: an iterator pointing to the next item in the stream,
an ios_base object, and the fill character. Each unique gregorian object
has it's own put function. Each unique put function is described
below.</entry>
+ <entry>There are 12 put functions in the date_facet. The
common paraeters are: an iterator pointing to the next item in the stream,
an ios_base object, and the fill character. Each unique gregorian object
has it's own put function. Each unique put function is described
below.<sbr/>
+ 在 date_facet 中有12个 put 函数。它们的共同参数是：一个指向流中
下一项的迭代器，一个 ios_base 对象，
+ 以及填充字符。每个格里历对象都有它自己的 put 函数。每个 put 函
数的描述如下。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -205,7 +236,8 @@
<row>
<entry valign="top" morerows="1"><screen>OutItrT put(...,
date)</screen></entry>
- <entry>Puts a date object into the stream using the format set
by <code>format(...)</code> or the default.</entry>
+ <entry>Puts a date object into the stream using the format set
by <code>format(...)</code> or the default.<sbr/>
+ 使用由 <code>format(...)</code> 设置的格式或缺省格式将一个日期
放入输出到流中。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -213,7 +245,8 @@
<row>
<entry valign="top" morerows="1"><screen>OutItrT put(...,
days)</screen></entry>
- <entry>Puts a days object into the stream as a number.</entry>
+ <entry>Puts a days object into the stream as a number.<sbr/>
+ 将一个 days 对象作为一个数字放入流中。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -221,7 +254,8 @@
<row>
<entry valign="top" morerows="1"><screen>OutItrT put(...,
month)</screen></entry>
- <entry>Puts a month object into the stream using the format
set by <code>month_format(...)</code> or the default.</entry>
+ <entry>Puts a month object into the stream using the format
set by <code>month_format(...)</code> or the default.<sbr/>
+ 将一个 month 对象放入流中，使用由
<code>month_format(...)</code> 设置的格式或者缺省格式。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -229,15 +263,17 @@
<row>
<entry valign="top" morerows="1"><screen>OutItrT put(...,
day)</screen></entry>
- <entry>Puts a day of month object into the stream as a two
digit number.</entry>
+ <entry>Puts a day of month object into the stream as a two
digit number.<sbr/>
+ 将一个 day of month 对象作为一个两位数放入流中。</entry>
</row>
<row>
- <entry><screen>"01" // January 1st</screen></entry>
+ <entry><screen>"01" // January 1st 1月1日</screen></entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>OutItrT put(...,
day_of_week)</screen></entry>
- <entry>Puts a day of week object into the stream using the
format set by <code>weekday_format(...)</code> or the default.</entry>
+ <entry>Puts a day of week object into the stream using the
format set by <code>weekday_format(...)</code> or the default.<sbr/>
+ 将一个 day of week 对象放入流中，使用由
<code>weekday_format(...)</code> 设置的格式或缺省格式。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -245,7 +281,9 @@
<row>
<entry valign="top" morerows="1"><screen>OutItrT put(...,
date_period)</screen></entry>
- <entry>Puts a date_period into the stream. The format of the
dates will use the format set by <code>format(..)</code> or the default
date format. The type of period (open or closed range) and the delimiters
used are those used by the period_formatter.</entry>
+ <entry>Puts a date_period into the stream. The format of the
dates will use the format set by <code>format(..)</code> or the default
date format. The type of period (open or closed range) and the delimiters
used are those used by the period_formatter.<sbr/>
+ 将一个 date_period 放入流中。日期的格式使用
<code>format(..)</code> 设置的格式或缺省格式。
+ period 的类型(开或闭区间)以及所使用的分隔符就是
period_formatter 所使用的。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -253,61 +291,78 @@
<row>
<entry valign="top" morerows="1"><screen>OutItrT put(...,
partial_date)</screen></entry>
- <entry>Puts a partial_date date_generator object into the
stream. The month format used is set by <code>month_format(..)</code> or
the default. The day of month is represented as a two digit number.</entry>
+ <entry>Puts a partial_date date_generator object into the
stream. The month format used is set by <code>month_format(..)</code> or
the default. The day of month is represented as a two digit number.<sbr/>
+ 将一个 partial_date date_generator 对象放入流中。所使用的月份格
式为由 <code>month_format(..)</code>
+ 所设置的格式或缺省格式。day of month 用两位数表示。</entry>
</row>
<row>
- <entry><screen>"01 Jan" // default formats
-"01 January" // long month format</screen></entry>
+ <entry><screen>"01 Jan" // default formats 缺省格式
+"01 January" // long month format 长月份名格式</screen></entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>OutItrT put(...,
date_generator)
Date Generator Type:
nth_day_of_the_week_in_month</screen></entry>
- <entry>Puts a nth_day_of_the_week_in_month object into the
stream. The month format is set by <code>month_format(...)</code> or the
default. The weekday format is set by <code>weekday_format(...)</code> or
the default. The remaining phrase elements are set in the <link linkend
="io_objects.date_generators">date_generator_formatter</link>.</entry>
+ <entry>Puts a nth_day_of_the_week_in_month object into the
stream. The month format is set by <code>month_format(...)</code> or the
default. The weekday format is set by <code>weekday_format(...)</code> or
the default. The remaining phrase elements are set in the <link linkend
="io_objects.date_generators">date_generator_formatter</link>.<sbr/>
+ 将一个 nth_day_of_the_week_in_month 对象放入流中。月份的格式由
<code>month_format(...)</code>
+ 设置或采用缺省格式。weekday 的格式由
<code>weekday_format(...)</code> 设置或采用缺省格式。
+ 其它短语元素在 <link linkend
="io_objects.date_generators">date_generator_formatter</link> 中设置。
</entry>
</row>
<row>
- <entry><screen>"third Fri in May" // defaults</screen></entry>
+ <entry><screen>"third Fri in May" // defaults 缺省
</screen></entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>OutItrT put(...,
date_generator)
Date Generator Type:
first_day_of_the_week_in_month</screen></entry>
- <entry>Puts a first_day_of_the_week_in_month object into the
stream. The month format is set by <code>month_format(...)</code> or the
default. The weekday format is set by <code>weekday_format(...)</code> or
the default. The remaining phrase elements are set in the <link linkend
="io_objects.date_generators">date_generator_formatter</link>.</entry>
+ <entry>Puts a first_day_of_the_week_in_month object into the
stream. The month format is set by <code>month_format(...)</code> or the
default. The weekday format is set by <code>weekday_format(...)</code> or
the default. The remaining phrase elements are set in the <link linkend
="io_objects.date_generators">date_generator_formatter</link>.<sbr/>
+ 将一个 first_day_of_the_week_in_month 对象放入流中。月份的格式
由 <code>month_format(...)</code>
+ 设置或采用缺省格式。weekday 的格式由
<code>weekday_format(...)</code> 设置或采用缺省格式。
+ 其它短语元素在 <link linkend
="io_objects.date_generators">date_generator_formatter</link> 中设置。
</entry>
</row>
<row>
- <entry><screen>"first Wed of Jun" // defaults</screen></entry>
+ <entry><screen>"first Wed of Jun" // defaults 缺省
</screen></entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>OutItrT put(...,
date_generator)
Date Generator Type:
last_day_of_the_week_in_month</screen></entry>
- <entry>Puts a last_day_of_the_week_in_month object into the
stream. The month format is set by <code>month_format(...)</code> or the
default. The weekday format is set by <code>weekday_format(...)</code> or
the default. The remaining phrase elements are set in the <link linkend
="io_objects.date_generators">date_generator_formatter</link>.</entry>
+ <entry>Puts a last_day_of_the_week_in_month object into the
stream. The month format is set by <code>month_format(...)</code> or the
default. The weekday format is set by <code>weekday_format(...)</code> or
the default. The remaining phrase elements are set in the <link linkend
="io_objects.date_generators">date_generator_formatter</link>.<sbr/>
+ 将一个 last_day_of_the_week_in_month 对象放入流中。月份的格式
由 <code>month_format(...)</code>
+ 设置或采用缺省格式。weekday 的格式由
<code>weekday_format(...)</code> 设置或采用缺省格式。
+ 其它短语元素在 <link linkend
="io_objects.date_generators">date_generator_formatter</link> 中设置。
</entry>
</row>
<row>
- <entry><screen>"last Tue of Mar" // defaults</screen></entry>
+ <entry><screen>"last Tue of Mar" // defaults 缺省
</screen></entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>OutItrT put(...,
date_generator)
Date Generator Type:
first_day_of_the_week_after</screen></entry>
- <entry>Puts a first_day_of_the_week_after object into the
stream. The weekday format is set by <code>weekday_format(...)</code> or
the default. The remaining phrase elements are set in the <link linkend
="io_objects.date_generators">date_generator_formatter</link>.</entry>
+ <entry>Puts a first_day_of_the_week_after object into the
stream. The weekday format is set by <code>weekday_format(...)</code> or
the default. The remaining phrase elements are set in the <link linkend
="io_objects.date_generators">date_generator_formatter</link>.<sbr/>
+ 将一个 first_day_of_the_week_after 对象放入流中。weekday 的格式
由 <code>weekday_format(...)</code>
+ 设置或采用缺省格式。其它短语元素在 <link linkend
="io_objects.date_generators">date_generator_formatter</link>
+ 中设置。</entry>
</row>
<row>
- <entry><screen>"first Sat after" // defaults</screen></entry>
+ <entry><screen>"first Sat after" // defaults 缺省
</screen></entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>OutItrT put(...,
date_generator)
Date Generator Type:
first_day_of_the_week_before</screen></entry>
- <entry>Puts a first_day_of_the_week_before object into the
stream. The weekday format is set by <code>weekday_format(...)</code> or
the default. The remaining phrase elements are set in the <link linkend
="io_objects.date_generators">date_generator_formatter</link>.</entry>
+ <entry>Puts a first_day_of_the_week_before object into the
stream. The weekday format is set by <code>weekday_format(...)</code> or
the default. The remaining phrase elements are set in the <link linkend
="io_objects.date_generators">date_generator_formatter</link>.<sbr/>
+ 将一个 first_day_of_the_week_before 对象放入流中。weekday 的格
式由 <code>weekday_format(...)</code>
+ 设置或采用缺省格式。其它短语元素在 <link linkend
="io_objects.date_generators">date_generator_formatter</link>
+ 中设置。</entry>
</row>
<row>
- <entry><screen>"first Mon before" // defaults</screen></entry>
+ <entry><screen>"first Mon before" // defaults 缺省
</screen></entry>
</row>
</tbody>
=======================================
--- /trunk/libs/date_time/xmldoc/date_input_facet.xml Mon Dec 28 23:05:14
2009
+++ /trunk/libs/date_time/xmldoc/date_input_facet.xml Wed Jan 6 17:26:22
2010
@@ -8,36 +8,41 @@
-->
<section id="date_time.date_input_facet">
- <title>Date Input Facet</title>
-
- <link linkend="date_input_facet_intro">Introduction</link> -
- <link linkend="date_input_facet_constr">Construction</link> -
- <link linkend="date_input_facet_accessors">Accessors</link>
+ <title>Date Input Facet 日期输入Facet</title>
+
+ <link linkend="date_input_facet_intro">Introduction 简介</link> -
+ <link linkend="date_input_facet_constr">Construction 构造</link> -
+ <link linkend="date_input_facet_accessors">Accessors 访问器</link>
<anchor id="date_input_facet_intro" />
- <bridgehead renderas="sect3">Introduction</bridgehead>
- <para>The <code>boost::date_time::date_input_facet</code> enables users
to have significant control how dates (and other gregorian objects) are
streamed in. The date_input_facet is typedef'd in the
<code>gregorian</code> namespace as <code>date_input_facet</code> and
<code>wdate_input_facet</code>.
+ <bridgehead renderas="sect3">Introduction 简介</bridgehead>
+ <para>The <code>boost::date_time::date_input_facet</code> enables users
to have significant control how dates (and other gregorian objects) are
streamed in. The date_input_facet is typedef'd in the
<code>gregorian</code> namespace as <code>date_input_facet</code> and
<code>wdate_input_facet</code>. <sbr/>
+ <code>boost::date_time::date_input_facet</code> 让用户可以控制如果从流中
输入 dates (以及其它格里历对象)。
+ date_input_facet 被 typedef 为 <code>gregorian</code> 名字空间中的
<code>date_input_facet</code> 和
+ <code>wdate_input_facet</code>.
</para>
<anchor id="date_input_facet_constr" />
- <bridgehead renderas="sect3">Construction</bridgehead>
+ <bridgehead renderas="sect3">Construction 构造</bridgehead>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry>Syntax</entry>
- <entry>Description</entry>
+ <entry>Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"><screen>date_input_facet()</screen></entry>
- <entry>Default constructor</entry>
+ <entry>Default constructor<sbr/>
+ 缺省构造函数。</entry>
</row>
<row>
<entry valign="top"><screen>date_input_facet(string_type
format)</screen></entry>
- <entry>Format given will be used for date input. All other
formats will use their defaults.</entry>
+ <entry>Format given will be used for date input. All other
formats will use their defaults.<sbr/>
+ 给定的 Format 将被用于 date 的输入。所有其它格式使用缺省值。
</entry>
</row>
<row>
<entry valign="top"><screen>date_input_facet(...)
@@ -47,7 +52,9 @@
special_values_parser_type
period_parser_type
date_gen_parser_type</screen></entry>
- <entry>Format given will be used for date input. The remaining
parameters are parser objects. Further details on these objects can be
found <link linkend="date_time.io_objects">here</link>.</entry>
+ <entry>Format given will be used for date input. The remaining
parameters are parser objects. Further details on these objects can be
found <link linkend="date_time.io_objects">here</link>.<sbr/>
+ 给定的 Format 将被用于 date 的输入。其它参数为分析器对象。有关
这些对象的更多细节请见
+ <link linkend="date_time.io_objects">这里</link>。</entry>
</row>
</tbody>
</tgroup>
@@ -55,23 +62,24 @@
</para>
<anchor id="date_input_facet_accessors" />
- <bridgehead renderas="sect3">Accessors</bridgehead>
+ <bridgehead renderas="sect3">Accessors 访问器</bridgehead>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>void
format(char_type*)</screen></entry>
- <entry>Set the format for dates.</entry>
+ <entry>Set the format for dates.<sbr/>
+ 设置日期的格式。</entry>
</row>
<row>
<entry><screen>date_input_facet* f =
@@ -81,7 +89,8 @@
<row>
<entry valign="top" morerows="1"><screen>void
set_iso_format()</screen></entry>
- <entry>Sets the date format to ISO</entry>
+ <entry>Sets the date format to ISO<sbr/>
+ 设置日期格式为 ISO</entry>
</row>
<row>
<entry><screen>f->set_iso_format();
@@ -90,7 +99,8 @@
<row>
<entry valign="top" morerows="1"><screen>void
set_iso_extended_format()</screen></entry>
- <entry>Sets the date format to ISO Extended</entry>
+ <entry>Sets the date format to ISO Extended<sbr/>
+ 设置日期格式为 ISO 扩展</entry>
</row>
<row>
<entry><screen>f->set_iso_extended_format();
@@ -99,7 +109,8 @@
<row>
<entry valign="top" morerows="1"><screen>void
month_format(char_type*)</screen></entry>
- <entry>Set the format when 'get'ing months
individually.</entry>
+ <entry>Set the format when 'get'ing months individually.<sbr/>
+ 单独设置月份的输入格式。</entry>
</row>
<row>
<entry><screen>f->month_format("%B");
@@ -109,7 +120,8 @@
<row>
<entry valign="top" morerows="1"><screen>void
weekday_format(char_type*)</screen></entry>
- <entry>Set the format when 'get'ing weekdays
individually.</entry>
+ <entry>Set the format when 'get'ing weekdays
individually.<sbr/>
+ 单独设置周日的输入格式。</entry>
</row>
<row>
<entry><screen>f->weekday_format("%a");
@@ -119,7 +131,8 @@
<row>
<entry valign="top" morerows="1"><screen>void
year_format(char_type*)</screen></entry>
- <entry>Set the format when 'get'ing years individually.</entry>
+ <entry>Set the format when 'get'ing years individually.<sbr/>
+ 单独设置年份的格式。</entry>
</row>
<row>
<entry><screen>f->weekday_format("%y");
@@ -131,27 +144,33 @@
<entry valign="top" morerows="1"><screen>void
period_parser(...)
Parameter:
period_parser_type</screen></entry>
- <entry>Replaces the period parser object with a user created
one.</entry>
+ <entry>Replaces the period parser object with a user created
one.<sbr/>
+ 将 period 分析器对象替换为用户创建的对象。</entry>
</row>
<row>
- <entry>see the <link
linkend="date_time.io_tutorial">tutorial</link> for a complete
example.</entry>
+ <entry>see the <link
linkend="date_time.io_tutorial">tutorial</link> for a complete
example.<sbr/>
+ 完整的例子请见 <link linkend="date_time.io_tutorial">指南
</link>。</entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>void
special_values_parser(...)
Parameter:
special_values_parser_type</screen></entry>
- <entry>Replaces the special_values parser object with a user
created one.</entry>
+ <entry>Replaces the special_values parser object with a user
created one.<sbr/>
+ 将 special_values 分析器替换为用户创建的对象。</entry>
</row>
<row>
- <entry>see the <link
linkend="date_time.io_tutorial">tutorial</link> for a complete
example.</entry>
+ <entry>see the <link
linkend="date_time.io_tutorial">tutorial</link> for a complete
example.<sbr/>
+ 完整的例子请见 <link linkend="date_time.io_tutorial">指南
</link>。</entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>void
date_gen_phrase_strings(...)
Parameters:
input_collection_type</screen></entry>
- <entry>Sets new date generator phrase strings in
date_gen_parser. The input collection is a vector of strings (for details
on these strings see <link linkend="io_objects.date_generators">date
generator formatter/parser documentation</link>).</entry>
+ <entry>Sets new date generator phrase strings in
date_gen_parser. The input collection is a vector of strings (for details
on these strings see <link linkend="io_objects.date_generators">date
generator formatter/parser documentation</link>).<sbr/>
+ 设置 date_gen_parser 中的新日期生成器对象。其中 input
collection 为字符串 vector(有关这些字符串的细节请见
+ <link linkend="io_objects.date_generators">日期生成器格式器/分
析器的文档</link>)。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -161,40 +180,48 @@
<entry valign="top" morerows="1"><screen>void
short_weekday_names(...)
Parameter:
input_collection_type</screen></entry>
- <entry>Replace strings used when 'getting' short
weekdays.</entry>
+ <entry>Replace strings used when 'getting' short
weekdays.<sbr/>
+ 替换用于输入短周日名的字符串。</entry>
</row>
<row>
- <entry>see the <link
linkend="date_time.io_tutorial">tutorial</link> for a complete
example.</entry>
+ <entry>see the <link
linkend="date_time.io_tutorial">tutorial</link> for a complete
example.<sbr/>
+ 完整的例子请见 <link linkend="date_time.io_tutorial">指南
</link>。</entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>void
long_weekday_names(...)
Parameter:
input_collection_type</screen></entry>
- <entry>Replace strings used when 'getting' long
weekdays.</entry>
+ <entry>Replace strings used when 'getting' long weekdays.<sbr/>
+ 替换用于输入长周日名的字符串。</entry>
</row>
<row>
- <entry>see the <link
linkend="date_time.io_tutorial">tutorial</link> for a complete
example.</entry>
+ <entry>see the <link
linkend="date_time.io_tutorial">tutorial</link> for a complete
example.<sbr/>
+ 完整的例子请见 <link linkend="date_time.io_tutorial">指南
</link>。</entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>void
short_month_names(...)
Parameter:
input_collection_type</screen></entry>
- <entry>Replace strings used when 'getting' short
months.</entry>
+ <entry>Replace strings used when 'getting' short months.<sbr/>
+ 替换用于输入短月份名的字符串。</entry>
</row>
<row>
- <entry>see the <link
linkend="date_time.io_tutorial">tutorial</link> for a complete
example.</entry>
+ <entry>see the <link
linkend="date_time.io_tutorial">tutorial</link> for a complete
example.<sbr/>
+ 完整的例子请见 <link linkend="date_time.io_tutorial">指南
</link>。</entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>void
long_month_names(...)
Parameter:
input_collection_type</screen></entry>
- <entry>Replace strings used when 'getting' long months.</entry>
+ <entry>Replace strings used when 'getting' long months.<sbr/>
+ 替换用于输入长月份名的字符串。</entry>
</row>
<row>
- <entry>see the <link
linkend="date_time.io_tutorial">tutorial</link> for a complete
example.</entry>
+ <entry>see the <link
linkend="date_time.io_tutorial">tutorial</link> for a complete
example.<sbr/>
+ 完整的例子请见 <link linkend="date_time.io_tutorial">指南
</link>。</entry>
</row>
<row>
@@ -206,7 +233,10 @@
ios_base
Unique parameter for 'get' funcs:
gregorian object</screen></entry>
- <entry>There are 13 get functions in the date_input_facet. The
common parameters are: an iterator pointing to the begining of the stream,
an iterator pointing to the end of the stream, and an ios_base object. Each
unique gregorian object has it's own get function. Each unique get function
is described below.</entry>
+ <entry>There are 13 get functions in the date_input_facet. The
common parameters are: an iterator pointing to the begining of the stream,
an iterator pointing to the end of the stream, and an ios_base object. Each
unique gregorian object has it's own get function. Each unique get function
is described below.<sbr/>
+ 在 date_input_facet 中有13个 get 函数。它们的共同参数是：一个指
向流的开始位置的迭代器，
+ 一个指向流的结束位置的迭代器，以及一个 ios_base 对象。每个格里
历对象都有自己的 get 函数。
+ 每个 get 函数描述如下。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -214,122 +244,148 @@
<row>
<entry valign="top" morerows="1"><screen>InItrT get(...,
date)</screen></entry>
- <entry>Gets a date object from the stream using the format set
by <code>format(...)</code> or the default.</entry>
+ <entry>Gets a date object from the stream using the format set
by <code>format(...)</code> or the default.<sbr/>
+ 从流中取出一个 date 对象，使用由 <code>format(...)</code> 设置
的格式或缺省格式。</entry>
</row>
<row>
<entry><screen>ss.str("2005-Jan-01");
-ss >> d; // default format</screen></entry>
+ss >> d; // default format 缺省格式</screen></entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>InItrT get(...,
month)</screen></entry>
- <entry>Gets a month object from the stream using the format
set by <code>month_format(...)</code> or the default.</entry>
+ <entry>Gets a month object from the stream using the format
set by <code>month_format(...)</code> or the default.<sbr/>
+ 从流中取出一个 month 对象，使用由
<code>month_format(...)</code> 设置的格式或缺省格式。</entry>
</row>
<row>
<entry><screen>ss.str("Feb");
-ss >> m; // default format</screen></entry>
+ss >> m; // default format 缺省格式</screen></entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>InItrT get(...,
day_of_week)</screen></entry>
- <entry>Gets a day of week object from the stream using the
format set by <code>weekday_format(...)</code> or the default.</entry>
+ <entry>Gets a day of week object from the stream using the
format set by <code>weekday_format(...)</code> or the default.<sbr/>
+ 从流中取出一个 day of week 对象，使用由
<code>weekday_format(...)</code> 设置的格式或缺省格式。</entry>
</row>
<row>
<entry><screen>ss.str("Sun");
-ss >> dow; // default format</screen></entry>
+ss >> dow; // default format 缺省格式</screen></entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>InItrT get(...,
day)</screen></entry>
- <entry>Gets a day of month object from the stream as a two
digit number.</entry>
+ <entry>Gets a day of month object from the stream as a two
digit number.<sbr/>
+ 从流中取出两位数字作为 day of month 对象。</entry>
</row>
<row>
- <entry><screen>"01" // January 1st</screen></entry>
+ <entry><screen>"01" // January 1st 1月1日</screen></entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>InItrT get(...,
year)</screen></entry>
- <entry>Gets a year object from the stream as a number. The
number of expected digits depends on the year format.</entry>
+ <entry>Gets a year object from the stream as a number. The
number of expected digits depends on the year format.<sbr/>
+ 从流中取出一个数字作为 year 对象。该数字的位数取决于年份格式。
</entry>
</row>
<row>
<entry><screen>ss/str("2005");
-ss >> y; // default format</screen></entry>
+ss >> y; // default format 缺省格式</screen></entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>InItrT get(...,
days)</screen></entry>
- <entry>Gets a days object from the stream as a number.</entry>
+ <entry>Gets a days object from the stream as a number.<sbr/>
+ 从流中取出一个数字作为 days 对象。</entry>
</row>
<row>
<entry><screen>ss.str("356");
-ss >> dys; // a full year</screen></entry>
+ss >> dys; // a full year 一整年</screen></entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>InItrT get(...,
date_period)</screen></entry>
- <entry>Gets a date_period from the stream. The format of the
dates will use the format set by <code>format(..)</code> or the default
date format. The type of period (open or closed range) and the delimiters
used are those used by the period_parser.</entry>
+ <entry>Gets a date_period from the stream. The format of the
dates will use the format set by <code>format(..)</code> or the default
date format. The type of period (open or closed range) and the delimiters
used are those used by the period_parser.<sbr/>
+ 从流中取出一个 date_period. dates 的格式使用由
<code>format(..)</code> 设置的格式或缺省的日期格式。
+ period 的类型(开或闭区间)以及使用的分隔符为 period_parser 所使
用的设置。</entry>
</row>
<row>
- <entry>see the <link
linkend="date_time.io_tutorial">tutorial</link> for a complete
example.</entry>
+ <entry>see the <link
linkend="date_time.io_tutorial">tutorial</link> for a complete
example.<sbr/>
+ 完整的例子请见 <link linkend="date_time.io_tutorial">指南
</link>。</entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>InItrT get(...,
partial_date)</screen></entry>
- <entry>Gets a partial_date date_generator object from the
stream. The month format used is set by <code>month_format(..)</code> or
the default. The day of month is represented as a two digit number.</entry>
+ <entry>Gets a partial_date date_generator object from the
stream. The month format used is set by <code>month_format(..)</code> or
the default. The day of month is represented as a two digit number.<sbr/>
+ 从流中取出一个 partial_date date_generator 对象。月份格式使用
由 <code>month_format(..)</code>
+ 设置的格式或缺省格式。day of month 以两位数字表示。</entry>
</row>
<row>
- <entry><screen>"01 Jan" // default formats
-"01 January" // long month format</screen></entry>
+ <entry><screen>"01 Jan" // default formats 缺省格式
+"01 January" // long month format 长月份名格式</screen></entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>InItrT get(...,
date_generator)
Date Generator Type:
nth_day_of_the_week_in_month</screen></entry>
- <entry>Gets a nth_day_of_the_week_in_month object from the
stream. The month format is set by <code>month_format(...)</code> or the
default. The weekday format is set by <code>weekday_format(...)</code> or
the default. The remaining phrase elements are set in the <link linkend
="io_objects.date_generators">date_generator_parser</link>.</entry>
+ <entry>Gets a nth_day_of_the_week_in_month object from the
stream. The month format is set by <code>month_format(...)</code> or the
default. The weekday format is set by <code>weekday_format(...)</code> or
the default. The remaining phrase elements are set in the <link linkend
="io_objects.date_generators">date_generator_parser</link>.<sbr/>
+ 从流中取出一个 nth_day_of_the_week_in_month 对象。月份格式使用
由 <code>month_format(...)</code>
+ 设置的格式或缺省格式。weekday 格式为由
<code>weekday_format(...)</code> 设置的格式或缺省格式。
+ 其它短语元素在 <link linkend
="io_objects.date_generators">date_generator_parser</link> 中设置。</entry>
</row>
<row>
- <entry><screen>"third Fri in May" // defaults</screen></entry>
+ <entry><screen>"third Fri in May" // defaults 缺省
</screen></entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>InItrT get(...,
date_generator)
Date Generator Type:
first_day_of_the_week_in_month</screen></entry>
- <entry>Gets a first_day_of_the_week_in_month object from the
stream. The month format is set by <code>month_format(...)</code> or the
default. The weekday format is set by <code>weekday_format(...)</code> or
the default. The remaining phrase elements are set in the <link linkend
="io_objects.date_generators">date_generator_parser</link>.</entry>
+ <entry>Gets a first_day_of_the_week_in_month object from the
stream. The month format is set by <code>month_format(...)</code> or the
default. The weekday format is set by <code>weekday_format(...)</code> or
the default. The remaining phrase elements are set in the <link linkend
="io_objects.date_generators">date_generator_parser</link>.<sbr/>
+ 从流中取出一个 first_day_of_the_week_in_month 对象。月份格式使
用由 <code>month_format(..)</code>
+ 设置的格式或缺省格式。weekday 格式为由
<code>weekday_format(...)</code> 设置的格式或缺省格式。
+ 其它短语元素在 <link linkend
="io_objects.date_generators">date_generator_parser</link> 中设置。</entry>
</row>
<row>
- <entry><screen>"first Wed of Jun" // defaults</screen></entry>
+ <entry><screen>"first Wed of Jun" // defaults 缺省
</screen></entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>InItrT get(...,
date_generator)
Date Generator Type:
last_day_of_the_week_in_month</screen></entry>
- <entry>Gets a last_day_of_the_week_in_month object from the
stream. The month format is set by <code>month_format(...)</code> or the
default. The weekday format is set by <code>weekday_format(...)</code> or
the default. The remaining phrase elements are set in the <link linkend
="io_objects.date_generators">date_generator_parser</link>.</entry>
+ <entry>Gets a last_day_of_the_week_in_month object from the
stream. The month format is set by <code>month_format(...)</code> or the
default. The weekday format is set by <code>weekday_format(...)</code> or
the default. The remaining phrase elements are set in the <link linkend
="io_objects.date_generators">date_generator_parser</link>.<sbr/>
+ 从流中取出一个 last_day_of_the_week_in_month 对象。月份格式使用
由 <code>month_format(..)</code>
+ 设置的格式或缺省格式。weekday 格式为由
<code>weekday_format(...)</code> 设置的格式或缺省格式。
+ 其它短语元素在 <link linkend
="io_objects.date_generators">date_generator_parser</link> 中设置。</entry>
</row>
<row>
- <entry><screen>"last Tue of Mar" // defaults</screen></entry>
+ <entry><screen>"last Tue of Mar" // defaults 缺省
</screen></entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>InItrT get(...,
date_generator)
Date Generator Type:
first_day_of_the_week_after</screen></entry>
- <entry>Gets a first_day_of_the_week_after object from the
stream. The weekday format is set by <code>weekday_format(...)</code> or
the default. The remaining phrase elements are set in the <link linkend
="io_objects.date_generators">date_generator_parser</link>.</entry>
+ <entry>Gets a first_day_of_the_week_after object from the
stream. The weekday format is set by <code>weekday_format(...)</code> or
the default. The remaining phrase elements are set in the <link linkend
="io_objects.date_generators">date_generator_parser</link>.<sbr/>
+ 从流中取出一个 first_day_of_the_week_after 对象。weekday 格式为
由 <code>weekday_format(...)</code>
+ 设置的格式或缺省格式。其它短语元素在 <link linkend
="io_objects.date_generators">date_generator_parser</link>
+ 中设置。</entry>
</row>
<row>
- <entry><screen>"first Sat after" // defaults</screen></entry>
+ <entry><screen>"first Sat after" // defaults 缺省
</screen></entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>InItrT get(...,
date_generator)
Date Generator Type:
first_day_of_the_week_before</screen></entry>
- <entry>Gets a first_day_of_the_week_before object from the
stream. The weekday format is set by <code>weekday_format(...)</code> or
the default. The remaining phrase elements are set in the <link linkend
="io_objects.date_generators">date_generator_parser</link>.</entry>
+ <entry>Gets a first_day_of_the_week_before object from the
stream. The weekday format is set by <code>weekday_format(...)</code> or
the default. The remaining phrase elements are set in the <link linkend
="io_objects.date_generators">date_generator_parser</link>.<sbr/>
+ 从流中取出一个 first_day_of_the_week_before 对象。weekday 格式
为由 <code>weekday_format(...)</code>
+ 设置的格式或缺省格式。其它短语元素在 <link linkend
="io_objects.date_generators">date_generator_parser</link>
+ 中设置。</entry>
</row>
<row>
- <entry><screen>"first Mon before" // defaults</screen></entry>
+ <entry><screen>"first Mon before" // defaults 缺省
</screen></entry>
</row>
</tbody>
=======================================
--- /trunk/libs/date_time/xmldoc/date_iterators.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/date_iterators.xml Wed Jan 6 17:26:22 2010
@@ -8,46 +8,52 @@
-->
<section id="date_time.gregorian.date_iterators">
- <title>Date Iterators</title>
-
- <link linkend="iterators_intro">Introduction</link> --
- <link linkend="iterators_header">Header</link> --
- <link linkend="iterators_overview">Overview</link>
+ <title>Date Iterators 日期迭代器</title>
+
+ <link linkend="iterators_intro">Introduction 简介</link> --
+ <link linkend="iterators_header">Header 头文件</link> --
+ <link linkend="iterators_overview">Overview 概要</link>
<anchor id="iterators_intro" />
- <bridgehead renderas="sect3">Introduction</bridgehead>
+ <bridgehead renderas="sect3">Introduction 简介</bridgehead>
<para>
- Date iterators provide a standard mechanism for iteration through
dates. Date iterators are a model of <ulink
url="http://www.sgi.com/tech/stl/BidirectionalIterator.html";>Bidirectional
Iterator</ulink> and can be used to populate collections with dates and
other date generation tasks. For example, the <link
linkend="date_time.examples.print_month">print month</link> example
iterates through all the days in a month and prints them.
+ Date iterators provide a standard mechanism for iteration through
dates. Date iterators are a model of <ulink
url="http://www.sgi.com/tech/stl/BidirectionalIterator.html";>Bidirectional
Iterator</ulink> and can be used to populate collections with dates and
other date generation tasks. For example, the <link
linkend="date_time.examples.print_month">print month</link> example
iterates through all the days in a month and prints them. <sbr/>
+ 日期迭代器为对日期进行迭代提供了一个标准机制。日期迭代器是一种
+ <ulink url="http://www.sgi.com/tech/stl/BidirectionalIterator.html";>双
向迭代器</ulink>
+ 并可用于大多日期集合以及其它日期生成任务。例如，<link
linkend="date_time.examples.print_month">打印月份</link>
+ 的例子对一个月中的所有日子进行迭代并打印出它们。
</para>
<para>
- All of the iterators here derive from boost::gregorian::date_iterator.
+ All of the iterators here derive from boost::gregorian::date_iterator.
<sbr/>
+ 这里的所有迭代器均派生自 boost::gregorian::date_iterator.
</para>
<anchor id="iterators_header" />
- <bridgehead renderas="sect3">Header</bridgehead>
+ <bridgehead renderas="sect3">Header 头文件</bridgehead>
<para>
- <programlisting>#include "boost/date_time/gregorian/gregorian.hpp"
//include all types plus i/o
+ <programlisting>#include "boost/date_time/gregorian/gregorian.hpp"
//include all types plus i/o 包含所有类型和i/o
or
-#include "boost/date_time/gregorian/gregorian_types.hpp" //no i/o just
types</programlisting>
+#include "boost/date_time/gregorian/gregorian_types.hpp" //no i/o just
types 只有类型没有i/o</programlisting>
</para>
<anchor id="iterators_overview" />
- <bridgehead renderas="sect3">Overview</bridgehead>
+ <bridgehead renderas="sect3">Overview 概要</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"
morerows="1"><screen>date_iterator</screen></entry>
- <entry>Common (abstract) base class for all day level
iterators.</entry>
+ <entry>Common (abstract) base class for all day level iterators.<sbr/>
+ 所有日期级迭代器的公共(抽象)基类。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -55,7 +61,8 @@
<row>
<entry valign="top" morerows="1"><screen>day_iterator(date start_date,
int day_count=1)</screen></entry>
- <entry>Iterate <code>day_count</code> days at a time. This
iterator does not provide postfix increment/decrement operators. Only
prefix operators are provided.</entry>
+ <entry>Iterate <code>day_count</code> days at a time. This
iterator does not provide postfix increment/decrement operators. Only
prefix operators are provided.<sbr/>
+ 每次迭代 <code>day_count</code> 个日子。该迭代器不提供后缀式的递
增/递减操作符。只提供前缀式的递增/递减操作符。</entry>
</row>
<row>
<entry><screen>day_iterator day_itr(date(2005,Jan,1));
@@ -69,7 +76,8 @@
Parameters:
date start_date
int week_offset (defaults to 1)</screen></entry>
- <entry>Iterate <code>week_offset</code> weeks at a time. This
iterator does not provide postfix increment/decrement operators. Only
prefix operators are provided.</entry>
+ <entry>Iterate <code>week_offset</code> weeks at a time. This
iterator does not provide postfix increment/decrement operators. Only
prefix operators are provided.<sbr/>
+ 每次迭代 <code>week_offset</code> 个星期。该迭代器不提供后缀式的
递增/递减操作符。只提供前缀式的递增/递减操作符。</entry>
</row>
<row>
<entry><screen>week_iterator wk_itr(date(2005,Jan,1));
@@ -83,7 +91,12 @@
Parameters:
date start_date
int month_offset (defaults to 1)</screen></entry>
-<entry>Iterate <code>month_offset</code> months. There are special rules
for handling the end of the month. These are: if start date is last day of
the month, always adjust to last day of the month. If date is beyond the
end of the month (e.g. Jan 31 + 1 month) adjust back to end of month (for
more details and examples of this, see <link
linkend="snap_to_details">Reversibility of Operations Pitfall</link>.
<emphasis role="strong">NOTE:</emphasis> the <code>month_iterator</code> is
not effected by this pitfall.) This iterator does not provide postfix
increment/decrement operators. Only prefix operators are provided.</entry>
+<entry>Iterate <code>month_offset</code> months. There are special rules
for handling the end of the month. These are: if start date is last day of
the month, always adjust to last day of the month. If date is beyond the
end of the month (e.g. Jan 31 + 1 month) adjust back to end of month (for
more details and examples of this, see <link
linkend="snap_to_details">Reversibility of Operations Pitfall</link>.
<emphasis role="strong">NOTE:</emphasis> the <code>month_iterator</code> is
not effected by this pitfall.) This iterator does not provide postfix
increment/decrement operators. Only prefix operators are provided.<sbr/>
+迭代 <code>month_offset</code> 个月份。在处理月末时有特殊规则。即：如果开始
的日期是某月的最后一天，
+则总是将结果调整为月末。如果结果日期超出月末(如 Jan 31 + 1 month)则往回调整
至月末(有关细节和例子，
+请参见 <link linkend="snap_to_details">操作可逆性的缺陷</link>。<emphasis
role="strong">注：</emphasis>
+<code>month_iterator</code> 不会产生这一缺陷)。该迭代器不提供后缀式的递增
/递减操作符。
+只提供前缀式的递增/递减操作符。</entry>
</row>
<row>
<entry><screen>month_iterator m_itr(date(2005,Jan,1));
@@ -97,7 +110,10 @@
Parameters:
date start_date
int year_offset (defaults to 1)</screen></entry>
- <entry>Iterate year_offset years. The year_iterator will always land on
the day of the date parameter except when date is Feb 28 in a non-leap
year. In this case the iterator will return Feb 29 for leap years (eg:
2003-Feb-28, 2004-Feb-29, 2005-Feb-28). This iterator does not provide
postfix increment/decrement operators. Only prefix operators are
provided.</entry>
+ <entry>Iterate year_offset years. The year_iterator will always land on
the day of the date parameter except when date is Feb 28 in a non-leap
year. In this case the iterator will return Feb 29 for leap years (eg:
2003-Feb-28, 2004-Feb-29, 2005-Feb-28). This iterator does not provide
postfix increment/decrement operators. Only prefix operators are
provided.<sbr/>
+ 迭代 year_offset 个年份。year_iterator 总是得到同一天的结果，除了当日
期为非闰年的 Feb 28 时。
+ 在这种情况下，迭代器将在结果为闰年时返回 Feb 29 (如：2003-Feb-28,
2004-Feb-29, 2005-Feb-28)。
+ 该迭代器不提供后缀式的递增/递减操作符。只提供前缀式的递增/递减操作
符。</entry>
</row>
<row>
<entry><screen>year_iterator y_itr(date(2005,Jan,1));
=======================================
--- /trunk/libs/date_time/xmldoc/date_period.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/date_period.xml Wed Jan 6 17:26:22 2010
@@ -8,53 +8,62 @@
-->
<section id="date_time.gregorian.date_period">
- <title>Date Period</title>
-
- <link linkend="period_intro">Introduction</link> --
- <link linkend="period_header">Header</link> --
- <link linkend="period_construction">Construction</link> --
- <link linkend="date_period_mutators">Mutators</link> --
- <link linkend="period_accessors">Accessors</link> --
- <link linkend="period_convert_to_string">Convert to String</link> --
- <link linkend="period_operators">Operators</link>
+ <title>Date Period 日期段</title>
+
+ <link linkend="period_intro">Introduction 简介</link> --
+ <link linkend="period_header">Header 头文件</link> --
+ <link linkend="period_construction">Construction 构造</link> --
+ <link linkend="date_period_mutators">Mutators 修改器</link> --
+ <link linkend="period_accessors">Accessors 访问器</link> --
+ <link linkend="period_convert_to_string">Convert to String 转换为字符串
</link> --
+ <link linkend="period_operators">Operators 操作符</link>
<anchor id="period_intro" />
- <bridgehead renderas="sect3">Introduction</bridgehead>
+ <bridgehead renderas="sect3">Introduction 简介</bridgehead>
<para>
- The class boost::gregorian::date_period provides direct representation
for ranges between two dates. Periods provide the ability to simplify some
types of calculations by simplifying the conditional logic of the program.
For example, testing if a date is within an irregular schedule such as a
weekend or holiday can be accomplished using collections of date periods.
This is facilitated by several methods that allow evaluation if a
date_period intersects with another date period, and to generate the period
resulting from the intersection. The <link
linkend="date_time.examples.date_period_calc">date period calculation
example</link> provides an example of this.
+ The class boost::gregorian::date_period provides direct representation
for ranges between two dates. Periods provide the ability to simplify some
types of calculations by simplifying the conditional logic of the program.
For example, testing if a date is within an irregular schedule such as a
weekend or holiday can be accomplished using collections of date periods.
This is facilitated by several methods that allow evaluation if a
date_period intersects with another date period, and to generate the period
resulting from the intersection. The <link
linkend="date_time.examples.date_period_calc">date period calculation
Example</link> provides an example of this.<sbr/>
+ 类 boost::gregorian::date_period 提供了对两个日期之间的范围的直接表示。
+ 日期段可以通过简化程序的条件判断逻辑来简化一些计算类型。
+ 例如，测试某个日期是否在某个没有规律的时间表如周末或假日中，就可以用一
组日期段来实现。
+ 有多种方法来判断一个 date_period 是否与另一个 date period 交叉，以及生
成重叠的日期段。
+ <link linkend="date_time.examples.date_period_calc">日期段计算例子
</link> 一节中提供了这个例子。
</para>
<para>
- A period that is created with beginning and end points being equal, or
with a duration of zero, is known as a zero length period. Zero length
periods are considered invalid (it is perfectly legal to construct an
invalid period). For these periods, the <code>last</code> point will always
be one unit less that the <code>begin</code> point.
+ A period that is created with beginning and end points being equal, or
with a duration of zero, is known as a zero length period. Zero length
periods are considered invalid (it is perfectly legal to construct an
invalid period). For these periods, the <code>last</code> point will always
be one unit less that the <code>begin</code> point.<sbr/>
+ 由相同的开始日期和结束日期所创建的日期段，称为零长度日期段。零长度日期
段被认为是无效的
+ (构造一个无效的日期段是完全合法的)。对于这些日期段，<code>last</code>
点总是比 <code>begin</code> 小一个单元。
</para>
<para>
- Date periods used in combination with infinity values have the ability
to represent complex concepts such as 'until further notice'.
+ Date periods used in combination with infinity values have the ability
to represent complex concepts such as 'until further notice'. <sbr/>
+ 日期段与无限值结合使用可以表示象 '直至另行通知为止' 这样的复杂概念。
</para>
<anchor id="period_header" />
- <bridgehead renderas="sect3">Header</bridgehead>
+ <bridgehead renderas="sect3">Header 头文件</bridgehead>
<para>
- <programlisting>#include "boost/date_time/gregorian/gregorian.hpp"
//include all types plus i/o
+ <programlisting>#include "boost/date_time/gregorian/gregorian.hpp"
//include all types plus i/o 包含所有类型和i/o
or
-#include "boost/date_time/gregorian/gregorian_types.hpp" //no i/o just
types</programlisting>
+#include "boost/date_time/gregorian/gregorian_types.hpp" //no i/o just
types 只有类型没有i/o</programlisting>
</para>
<anchor id="period_construction" />
- <bridgehead renderas="sect3">Construction</bridgehead>
+ <bridgehead renderas="sect3">Construction 构造</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>date_period(date,
date)</screen></entry>
- <entry>Create a period as [begin, end). If end is <= begin then the
period will be invalid.</entry>
+ <entry>Create a period as [begin, end). If end is <= begin then the
period will be invalid.<sbr/>
+ 创建一个 [begin, end) 日期段。如果 end <= begin 则日期段无效。
</entry>
</row>
<row>
<entry><screen>date_period dp(date(2002,Jan,10),
@@ -63,7 +72,8 @@
<row>
<entry valign="top" morerows="1"><screen>date_period(date,
days)</screen></entry>
- <entry>Create a period as [begin, begin+len) where end point would be
begin+len. If len is <= zero then the period will be defined as
invalid.</entry>
+ <entry>Create a period as [begin, begin+len) where end point would be
begin+len. If len is <= zero then the period will be defined as
invalid.<sbr/>
+ 创建一个 [begin, begin+len) 日期段，其中 end 点为 begin+len. 如果
len <= 0 则日期段定义为无效。</entry>
</row>
<row>
<entry><screen>date_period dp(date(2002,Jan,10),
@@ -72,7 +82,8 @@
<row>
<entry valign="top"
morerows="1"><screen>date_period(date_period)</screen></entry>
- <entry> Copy constructor</entry>
+ <entry> Copy constructor<sbr/>
+ 复制构造函数</entry>
</row>
<row>
<entry><screen>date_period dp1(dp);</screen></entry>
@@ -83,23 +94,24 @@
<anchor id="date_period_mutators" />
- <bridgehead renderas="sect3">Mutators</bridgehead>
+ <bridgehead renderas="sect3">Mutators 修改器</bridgehead>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>date_period
shift(days)</screen></entry>
- <entry>Add duration to both begin and end.</entry>
+ <entry>Add duration to both begin and end.<sbr/>
+ 同时为 begin 和 end 加上偏移量。</entry>
</row>
<row>
<entry>
@@ -113,7 +125,8 @@
<row>
<entry valign="top" morerows="1"><screen>date_period
expand(days)</screen></entry>
- <entry>Subtract duration from begin and add duration to end.</entry>
+ <entry>Subtract duration from begin and add duration to end.<sbr/>
+ 从 begin 减去日期长度而为 end 加上日期长度。</entry>
</row>
<row>
<entry>
@@ -132,22 +145,23 @@
<anchor id="period_accessors" />
- <bridgehead renderas="sect3">Accessors</bridgehead>
+ <bridgehead renderas="sect3">Accessors 访问器</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>date begin()</screen></entry>
- <entry> Return first day of period.</entry>
+ <entry> Return first day of period.<sbr/>
+ 返回日期段的第一天。</entry>
</row>
<row>
<entry><screen>date_period dp(date(2002,Jan,1),
@@ -158,7 +172,8 @@
<row>
<entry valign="top" morerows="1"><screen>date last()</screen></entry>
- <entry>Return last date in the period</entry>
+ <entry>Return last date in the period<sbr/>
+ 返回日期段的最后一天。</entry>
</row>
<row>
<entry><screen>date_period dp(date(2002,Jan,1),
@@ -169,7 +184,8 @@
<row>
<entry valign="top" morerows="1"><screen>date end()</screen></entry>
- <entry>Return one past the last in period</entry>
+ <entry>Return one past the last in period<sbr/>
+ 返回日期段最后一天后的一天。</entry>
</row>
<row>
<entry><screen>date_period dp(date(2002,Jan,1),
@@ -180,7 +196,8 @@
<row>
<entry valign="top" morerows="1"><screen>days
length()</screen></entry>
- <entry>Return the length of the date_period</entry>
+ <entry>Return the length of the date_period<sbr/>
+ 返回 date_period 的长度。</entry>
</row>
<row>
<entry><screen>date_period dp(date(2002,Jan,1),
@@ -191,7 +208,8 @@
<row>
<entry valign="top" morerows="1"><screen>bool
is_null()</screen></entry>
- <entry>True if period is not well formed. eg: end less than or equal to
begin.</entry>
+ <entry>True if period is not well formed. eg: end less than or equal to
begin.<sbr/>
+ 返回 True 如果日期段是无效的。如：end 小于或等于 begin.</entry>
</row>
<row>
<entry><screen>date_period dp(date(2002,Jan,10),
@@ -202,7 +220,8 @@
<row>
<entry valign="top" morerows="1"><screen>bool
contains(date)</screen></entry>
- <entry>True if date is within the period. Zero length periods cannot
contain any points</entry>
+ <entry>True if date is within the period. Zero length periods cannot
contain any points<sbr/>
+ 返回 True 如果 date 包含在日期段中。零长度日期段不包含任何日期。
</entry>
</row>
<row>
<entry><screen>date d(2002,Jan,1);
@@ -215,7 +234,8 @@
<row>
<entry valign="top" morerows="1"><screen>bool
contains(date_period)</screen></entry>
- <entry>True if date period is within the period</entry>
+ <entry>True if date period is within the period<sbr/>
+ 返回 True 如果 date period 包含在日期段中。</entry>
</row>
<row>
<entry><screen>date_period dp1(date(2002,Jan,1),
@@ -229,7 +249,8 @@
<row>
<entry valign="top" morerows="1"><screen>bool
intersects(date_period)</screen></entry>
- <entry>True if periods overlap</entry>
+ <entry>True if periods overlap<sbr/>
+ 返回 True 如果两个日期段交叉。</entry>
</row>
<row>
<entry><screen>date_period dp1(date(2002,Jan,1),
@@ -242,7 +263,8 @@
<row>
<entry valign="top" morerows="1"><screen>date_period
intersection(date_period)</screen></entry>
- <entry>Calculate the intersection of 2 periods. Null if no
intersection.</entry>
+ <entry>Calculate the intersection of 2 periods. Null if no
intersection.<sbr/>
+ 计算两个日期段的交集。返回 Null 如果没有交叉。</entry>
</row>
<row>
<entry><screen>date_period dp1(date(2002,Jan,1),
@@ -255,7 +277,8 @@
<row>
<entry valign="top" morerows="1"><screen>date_period
is_adjacent(date_period)</screen></entry>
- <entry>Check if two periods are adjacent, but not overlapping.</entry>
+ <entry>Check if two periods are adjacent, but not overlapping.<sbr/>
+ 检验两个日期段是否相邻且不交叉。</entry>
</row>
<row>
<entry><screen>date_period dp1(date(2002,Jan,1),
@@ -268,7 +291,8 @@
<row>
<entry valign="top" morerows="1"><screen>date_period
is_after(date)</screen></entry>
- <entry>Determine the period is after a given date.</entry>
+ <entry>Determine the period is after a given date.<sbr/>
+ 判断日期段是否在给定的 date 之后。</entry>
</row>
<row>
<entry><screen>date_period dp1(date(2002,Jan,10),
@@ -280,7 +304,8 @@
<row>
<entry valign="top" morerows="1"><screen>date_period
is_before(date)</screen></entry>
- <entry>Determine the period is before a given date.</entry>
+ <entry>Determine the period is before a given date.<sbr/>
+ 判断日期段是否在给定的 date 之前。</entry>
</row>
<row>
<entry><screen>date_period dp1(date(2002,Jan,1),
@@ -292,7 +317,8 @@
<row>
<entry valign="top" morerows="1"><screen>date_period
merge(date_period)</screen></entry>
- <entry>Returns union of two periods. Null if no intersection.</entry>
+ <entry>Returns union of two periods. Null if no intersection.<sbr/>
+ 返回两个日期段的并集。返回 Null 如果交叉。</entry>
</row>
<row>
<entry><screen>date_period dp1(date(2002,Jan,1),
@@ -306,7 +332,8 @@
<row>
<entry valign="top" morerows="1"><screen>date_period
span(date_period)</screen></entry>
- <entry>Combines two periods and any gap between them such that begin =
min(p1.begin, p2.begin) and end = max(p1.end , p2.end)</entry>
+ <entry>Combines two periods and any gap between them such that begin =
min(p1.begin, p2.begin) and end = max(p1.end , p2.end)<sbr/>
+ 合并两个日期段及它们之间的间隔，相当于 begin = min(p1.begin,
p2.begin) 且 end = max(p1.end , p2.end)</entry>
</row>
<row>
<entry><screen>
@@ -320,7 +347,8 @@
<row>
<entry valign="top" morerows="1"><screen>date_period
shift(days)</screen></entry>
- <entry>Add duration to both begin and end.</entry>
+ <entry>Add duration to both begin and end.<sbr/>
+ 同时为 begin 和 end 加上偏移量。</entry>
</row>
<row>
<entry><screen>date_period dp1(date(2002,Jan,1),
@@ -332,7 +360,8 @@
<row>
<entry valign="top" morerows="1"><screen>date_period
expand(days)</screen></entry>
- <entry>Subtract duration from begin and add duration to end.</entry>
+ <entry>Subtract duration from begin and add duration to end.<sbr/>
+ 从 begin 减去日期长度而为 end 加上日期长度。</entry>
</row>
<row>
<entry><screen>date_period dp1(date(2002,Jan,4),
@@ -347,22 +376,23 @@
<anchor id="period_convert_to_string" />
- <bridgehead renderas="sect3">Convert to String</bridgehead>
+ <bridgehead renderas="sect3">Convert to String 转换为字符串</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>std::string
to_simple_string(date_period dp)</screen></entry>
- <entry>To <code>[YYYY-mmm-DD/YYYY-mmm-DD]</code> string where
<code>mmm</code> is 3 char month name.</entry>
+ <entry>To <code>[YYYY-mmm-DD/YYYY-mmm-DD]</code> string where
<code>mmm</code> is 3 char month name.<sbr/>
+ 转换为 <code>[YYYY-mmm-DD/YYYY-mmm-DD]</code> 字符串，其中
<code>mmm</code> 为3字符的月份名。</entry>
</row>
<row>
<entry><screen>[2002-Jan-01/2002-Jan-31]</screen></entry>
@@ -373,22 +403,23 @@
<anchor id="period_operators" />
- <bridgehead renderas="sect3">Operators</bridgehead>
+ <bridgehead renderas="sect3">Operators 操作符</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"
morerows="1"><screen>operator<<</screen></entry>
- <entry>ostream operator for date_period. Uses facet to format time
points. Typical output: [2002-Jan-01/2002-Jan-31].</entry>
+ <entry>ostream operator for date_period. Uses facet to format time
points. Typical output: [2002-Jan-01/2002-Jan-31].<sbr/>
+ date_period 的流输出操作符。使用 facet 来格式化时间点。典型的输
出：[2002-Jan-01/2002-Jan-31].</entry>
</row>
<row>
<entry><screen>std::cout << dp <<
std::endl;</screen></entry>
@@ -396,7 +427,8 @@
<row>
<entry valign="top"
morerows="1"><screen>operator>></screen></entry>
- <entry>istream operator for date_period. Uses facet to parse time
points.</entry>
+ <entry>istream operator for date_period. Uses facet to parse time
points.<sbr/>
+ date_period 的流输入操作符。使用 facet 来分析时间点。</entry>
</row>
<row>
<entry><screen>"[2002-Jan-01/2002-Jan-31]"</screen></entry>
@@ -406,7 +438,8 @@
<entry valign="top" morerows="1"><screen>operator==, operator!=,
operator>, operator<</screen>
</entry>
- <entry>A full complement of comparison operators</entry>
+ <entry>A full complement of comparison operators<sbr/>
+ 完整的比较操作符。</entry>
</row>
<row>
<entry><screen>dp1 == dp2, etc</screen></entry>
@@ -414,7 +447,8 @@
<row>
<entry valign="top" morerows="1"><screen>operator<</screen></entry>
- <entry>True if dp1.end() less than dp2.begin()</entry>
+ <entry>True if dp1.end() less than dp2.begin()<sbr/>
+ 返回 True 如果 dp1.end() 小于 dp2.begin()</entry>
</row>
<row>
<entry><screen>dp1 < dp2, etc</screen></entry>
@@ -422,7 +456,8 @@
<row>
<entry valign="top" morerows="1"><screen>operator></screen></entry>
- <entry>True if dp1.begin() greater than dp2.end()</entry>
+ <entry>True if dp1.begin() greater than dp2.end()<sbr/>
+ 返回 True 如果 dp1.begin() 大于 dp2.end()</entry>
</row>
<row>
<entry><screen>dp1 > dp2, etc</screen></entry>
=======================================
--- /trunk/libs/date_time/xmldoc/date_time.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/date_time.xml Wed Jan 6 17:26:22 2010
@@ -33,21 +33,25 @@
<title>Boost.Date_Time</title>
<!-- <section id="date_time.intro"> -->
- <bridgehead renderas="sect2">Introduction</bridgehead>
+ <bridgehead renderas="sect2">Introduction 简介</bridgehead>
<para>
- A set of date-time libraries based on generic programming concepts.
+ A set of date-time libraries based on generic programming
concepts.<sbr/>
+ 一组基于泛型程序概念的日期时间库。
</para>
- <para>This documentation is also available in PDF format. It can be
found at:
+ <para>This documentation is also available in PDF format. It can be
found at:<sbr/>
+ 本文档还提供了 PDF 格式。可从以下地址获得：
<simplelist type="horiz" columns="1">
<member><ulink
url="http://www.crystalclearsoftware.com/libraries/date_time/date_time.pdf";
/></member>
</simplelist>
- In addition, a full doxygen reference can be found at:
+ In addition, a full doxygen reference can be found at:<sbr/>
+ 另外，还有完整的 doxygen 引用：
<simplelist type="horiz" columns="1">
<member><ulink
url="http://www.crystalclearsoftware.com/libraries/date_time/ref_guide/index.html";
/></member>
</simplelist>
- The most current version of the documentation can be found at:
+ The most current version of the documentation can be found at:<sbr/>
+ 最新版本的文档在：
<simplelist type="horiz" columns="1">
<member><ulink
url="http://www.crystalclearsoftware.com/libraries/date_time/index.html";
/></member>
</simplelist>
=======================================
--- /trunk/libs/date_time/xmldoc/date_time_io.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/date_time_io.xml Wed Jan 6 17:26:22 2010
@@ -9,34 +9,48 @@
<section id="date_time.date_time_io"
xmlns:xi="http://www.w3.org/2001/XInclude";>
- <title>Date Time Input/Output</title>
+ <title>Date Time Input/Output 日期时间的输入/输出</title>
<using-namespace name="boost"/>
<using-namespace name="boost::date_time"/>
- <bridgehead renderas="sect2">Date Time IO System</bridgehead>
+ <bridgehead renderas="sect2">Date Time IO System 日期时间 IO 系统
</bridgehead>
<para>
- <link linkend="streaming_exceptions">Exception Handling on
Streams</link>
+ <link linkend="streaming_exceptions">Exception Handling on Streams 流的
异常处理</link>
</para>
- <para>As of version 1.33, the date_time library utilizes a new IO
streaming system. This new system gives the user great control over how
dates and times can be represented. The customization options can be broken
down into two groups: format flags and string elements. Format flags
provide flexibility in the order of the date elements as well as the type.
Customizing the string elements allows the replacement of built in strings
from month names, weekday names, and other strings used in the IO.</para>
-
- <para>The output system is based on a date_facet (derived from
std::facet), while the input system is based on a date_input_facet (also
derived from std::facet). The time and local_time facets are derived from
these base types. The output system utilizes three formatter objects,
whereas the input system uses four parser objects. These formatter and
parser objetcs are also customizable.</para>
-
- <para>It is important to note, that while all the examples shown here
use narrow streams, there are wide stream facets available as well (see
<link linkend="io_objects_table">IO Objects</link> for a complete
list).</para>
-
- <para>It should be further noted that not all compilers are capable of
using this IO system. For those compilers the IO system used in previous
<code>date_time</code> versions is still available. The "legacy IO" is
automatically selected for these compilers, however, the legacy IO system
can be manually selected by defining
<code>USE_DATE_TIME_PRE_1_33_FACET_IO</code>. See the <link
linkend="date_time.buildinfo">Build-Compiler Information</link> for more
information.</para>
+ <para>As of version 1.33, the date_time library utilizes a new IO
streaming system. This new system gives the user great control over how
dates and times can be represented. The customization options can be broken
down into two groups: format flags and string elements. Format flags
provide flexibility in the order of the date elements as well as the type.
Customizing the string elements allows the replacement of built in strings
from month names, weekday names, and other strings used in the IO.<sbr/>
+ 和版本1.33一样，本 date_time 库使用了一个新的流IO系统。这个新系统可以让用
户控制如何表示日期和时间。
+ 定制化的选项可分为两组：格式化标志和字符串元素。格式化标志提供了日期各元
素顺序和类型的灵活性。
+ 而对字符串元素进行客户化可以在IO时替换内建的月份名、星期名和其它字符串。
</para>
+
+ <para>The output system is based on a date_facet (derived from
std::facet), while the input system is based on a date_input_facet (also
derived from std::facet). The time and local_time facets are derived from
these base types. The output system utilizes three formatter objects,
whereas the input system uses four parser objects. These formatter and
parser objetcs are also customizable.<sbr/>
+ 输出系统基于一个 date_facet (派生自 std::facet)，而输入系统则基于一个
date_input_facet (也是派生自 std::facet)。
+ 而时间和 local_time 的 facets 则派生自这两个类型。输出系统使用了三个格式
化器对象，而输入系统则使用四个分析器对象。
+ 这些格式化器和分析器对象都是可定制化的。</para>
+
+ <para>It is important to note, that while all the examples shown here
use narrow streams, there are wide stream facets available as well (see
<link linkend="io_objects_table">IO Objects</link> for a complete
list).<sbr/>
+ 有一点很重要，后面所提供的所有例子均使用了窄字符流，而系统同样提供了宽字
符流的 facets (完整的列表请见
+ <link linkend="io_objects_table">IO对象</link>)。</para>
+
+ <para>It should be further noted that not all compilers are capable of
using this IO system. For those compilers the IO system used in previous
<code>date_time</code> versions is still available. The "legacy IO" is
automatically selected for these compilers, however, the legacy IO system
can be manually selected by defining
<code>USE_DATE_TIME_PRE_1_33_FACET_IO</code>. See the <link
linkend="date_time.buildinfo">Build-Compiler Information</link> for more
information.<sbr/>
+ 还要注意的是，不是所有编译器都能够使用这个IO系统。对于那些编译器，以前的
<code>date_time</code> 版本所使用的IO系统依然可用。
+ 对于这些编译器，系统将自动选择"旧的IO系统"，不过也可以通过定义
<code>USE_DATE_TIME_PRE_1_33_FACET_IO</code>
+ 来人工选择使用旧IO系统。更多信息请见 <link
linkend="date_time.buildinfo">构建及编译器信息</link>。</para>
<anchor id="streaming_exceptions" />
- <bridgehead renderas="sect5">Exception Handling on Streams</bridgehead>
- <para>When an error occurs during the input streaming process, the
<code>std::ios_base::failbit</code> will (always) be set on the stream. It
is also possible to have exceptions thrown when an error occurs. To "turn
on" these exceptions, call the stream's <code>exceptions</code> function
with a parameter of <code>std::ios_base::failbit</code>.</para>
- <screen>// "Turning on" exceptions
+ <bridgehead renderas="sect5">Exception Handling on Streams 流的异常处理
</bridgehead>
+ <para>When an error occurs during the input streaming process, the
<code>std::ios_base::failbit</code> will (always) be set on the stream. It
is also possible to have exceptions thrown when an error occurs. To "turn
on" these exceptions, call the stream's <code>exceptions</code> function
with a parameter of <code>std::ios_base::failbit</code>.<sbr/>
+ 在进行流输入时，如果发生了错误，那么流中的
<code>std::ios_base::failbit</code> 将(总是)被置位。
+ 也可以在发生错误时抛出异常。要"开启"这些异常的抛出，请以
<code>std::ios_base::failbit</code> 作为参数调用流的
+ <code>exceptions</code> 函数。</para>
+ <screen>// "Turning on" exceptions "开启"异常
date d(not_a_date_time);
std::stringstream ss;
ss.exceptions(std::ios_base::failbit);
ss.str("204-Jan-01");
-ss >> d; // throws bad_year exception AND sets failbit on stream</screen>
-
- <bridgehead renderas="sect5">A simple example of this new
system:</bridgehead>
- <screen>//example to customize output to be "LongWeekday LongMonthname
day, year"
+ss >> d; // throws bad_year exception AND sets failbit on stream 抛出
bad_year 异常并设置流的 failbit</screen>
+
+ <bridgehead renderas="sect5">A simple example of this new system: 新系统
的一个简单例子：</bridgehead>
+ <screen>//example to customize output to be 例子：定制输出
为 "LongWeekday LongMonthname day, year"
// "%A %b %d, %Y"
date d(2005,Jun,25);
date_facet* facet(new date_facet("%A %B %d, %Y"));
@@ -46,17 +60,18 @@
<xi:include href="format_flags.xml" />
- <para>The following table lists the available facets.</para>
+ <para>The following table lists the available facets.<sbr/>
+ 下表列出了可用的 facets.</para>
<anchor id="io_objects_table" />
- <bridgehead renderas="sect3">IO Objects</bridgehead>
+ <bridgehead renderas="sect3">IO Objects IO对象</bridgehead>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry>Output</entry>
- <entry>Input</entry>
+ <entry>Output 输出</entry>
+ <entry>Input 输入</entry>
</row>
</thead>
<tbody>
@@ -87,18 +102,20 @@
</tbody>
</tgroup>
</informaltable>
- * These links lead to the <code>time_facet</code> and
<code>time_input_facet</code> reference sections. They are not actual
classes but typedefs.
+ * These links lead to the <code>time_facet</code> and
<code>time_input_facet</code> reference sections. They are not actual
classes but typedefs.<sbr/>
+ * 这些链接引向 <code>time_facet</code> 和
<code>time_input_facet</code> 参考一节。它们不是真正的类而是 typedefs.
</para>
- <bridgehead renderas="sect3">Formatter/Parser Objects</bridgehead>
- <para>To implement the new i/o facets the date-time library uses a
number of new parsers and formatters. These classes are available for users
that want to implement specialized input/output routines.</para>
+ <bridgehead renderas="sect3">Formatter/Parser Objects 格式化器/分析器对象
</bridgehead>
+ <para>To implement the new i/o facets the date-time library uses a
number of new parsers and formatters. These classes are available for users
that want to implement specialized input/output routines.<sbr/>
+ 为了实现新的 new i/o facets，date-time 库使用了多个新分析器和格式化器。这
些类可以让用户实现特定的输入/输出程序。</para>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry>Output</entry>
- <entry>Input</entry>
+ <entry>Output 输出</entry>
+ <entry>Input 输入</entry>
</row>
</thead>
<tbody>
=======================================
--- /trunk/libs/date_time/xmldoc/design_concepts.xml Mon Dec 28 23:05:14
2009
+++ /trunk/libs/date_time/xmldoc/design_concepts.xml Wed Jan 6 17:26:22
2010
@@ -8,15 +8,22 @@
-->
<section id="date_time.design_concepts">
- <title>Design Concepts</title>
+ <title>Design Concepts 设计概念</title>
<para>
- A large part of the genesis of this library has been the observation
that few date-time libraries are built in a fashion that allows
customization and extension. A typical example, the calendar logic is built
directly into the date class. Or the clock retrieval functions are built
directly into the time class. These design decisions usually make it
impossible to extend or change the library behavior. At a more fundamental
level, there are usually assumptions about the resolution of time
representation or the gregorian calendar.
+ A large part of the genesis of this library has been the observation
that few date-time libraries are built in a fashion that allows
customization and extension. A typical example, the calendar logic is built
directly into the date class. Or the clock retrieval functions are built
directly into the time class. These design decisions usually make it
impossible to extend or change the library behavior. At a more fundamental
level, there are usually assumptions about the resolution of time
representation or the gregorian calendar. <sbr/>
+ 设计该库的很大一个原因是因为看到很多有日期时间库是按照允许进行定制和扩
展的风格来建立的。
+ 一个典型的例子就是，日历逻辑直接创建在日期类中。又或者，时钟读取功能直
接构建在时间类中。
+ 这些设计通常使得我们不可能扩展或修改库的行为。在更为基础的层次上，通常
都假定了时间表示法的分辨率或是假定使用了格里历。
</para>
<para>
- Often times, the result is that a project must settle for a less than
complete library because of a requirement for high resolution time
representation or other assumptions that do not match the implementation of
the library. This is extremely unfortunate because development of a library
of this sort is far from a trivial task.
+ Often times, the result is that a project must settle for a less than
complete library because of a requirement for high resolution time
representation or other assumptions that do not match the implementation of
the library. This is extremely unfortunate because development of a library
of this sort is far from a trivial task. <sbr/>
+ 多数时候，结果是一个项目必须满足于无法得到一个完整的库，因为对时间表示
法的高分辨率要求或是其它假定无法与库的实现相匹配。
+ 这是非常不幸的，因为开始这样一个库远不是一件简单的工作。
</para>
<para>
- While the design is far from perfect the current design is far more
flexible than any date-time library the author is aware of. It is expected
that the various aspects of extensibility will be better documented in
future versions. Information about the design goals of the library is <link
linkend="date_time.design_goals">summarized here</link>.
+ While the design is far from perfect the current design is far more
flexible than any date-time library the author is aware of. It is expected
that the various aspects of extensibility will be better documented in
future versions. Information about the design goals of the library is <link
linkend="date_time.design_goals">summarized here</link>. <sbr/>
+ 由于没有好的设计，作者所知的任何一个日期时间库的设计都不够灵活。在未来
的版本中，我们期望可以有更多方面的扩展性。
+ 有关本库的设计目标的信息请参见 <link
linkend="date_time.design_goals">这里的总结</link>。
</para>
</section>
=======================================
--- /trunk/libs/date_time/xmldoc/design_goals.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/design_goals.xml Wed Jan 6 17:26:22 2010
@@ -8,115 +8,151 @@
-->
<section id="date_time.design_goals">
- <title>Design Goals</title>
+ <title>Design Goals 设计目标</title>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Category</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Category 分类</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Functions</entry>
+ <entry>Functions 功能</entry>
</row>
</thead>
<tbody>
<row>
- <entry valign="top" morerows="1">Interfaces</entry>
- <entry>Provide concrete classes for manipulation of dates and
times</entry>
+ <entry valign="top" morerows="1">Interfaces<sbr/>
+ 接口</entry>
+ <entry>Provide concrete classes for manipulation of dates and
times<sbr/>
+ 提供对日期和时间进行操作的具体类</entry>
</row>
<row>
<entry>
<itemizedlist mark="bullet">
<listitem>date, time, date_duration, time_duration, date_period,
time_period, etc</listitem>
- <listitem>support for infinity - positive infinity, negative
infinity</listitem>
- <listitem>iterators over time and date ranges</listitem>
- <listitem>allow date and time implementations to be separate as
much as possible</listitem>
+ <listitem>support for infinity - positive infinity, negative
infinity<sbr/>
+ 支持无限 - 正无限、负无限</listitem>
+ <listitem>iterators over time and date ranges<sbr/>
+ 时间和日期区间上的迭代器</listitem>
+ <listitem>allow date and time implementations to be separate as
much as possible<sbr/>
+ 允许日期和时间的实现尽可能分离</listitem>
</itemizedlist>
</entry>
</row>
<row>
- <entry valign="top" morerows="1">Calculation</entry>
- <entry>Provide a basis for performing efficient time calculations
</entry>
+ <entry valign="top" morerows="1">Calculation<sbr/>
+ 运算</entry>
+ <entry>Provide a basis for performing efficient time calculations
<sbr/>
+ 提供高效执行时间运算的基础 </entry>
</row>
<row>
<entry>
<itemizedlist mark="bullet">
- <listitem>days between dates </listitem>
- <listitem>durations of times </listitem>
- <listitem>durations of dates and times together </listitem>
+ <listitem>days between dates <sbr/>
+ 日期之间的天数 </listitem>
+ <listitem>durations of times <sbr/>
+ 时间长度 </listitem>
+ <listitem>durations of dates and times together <sbr/>
+ 日期和时间一起的长度</listitem>
</itemizedlist>
</entry>
</row>
<row>
- <entry valign="top" morerows="1">Representation Flexibility</entry>
- <entry>Provide the maximum possible reusability and
flexibility</entry>
+ <entry valign="top" morerows="1">Representation Flexibility<sbr/>
+ 表示的灵活性</entry>
+ <entry>Provide the maximum possible reusability and flexibility<sbr/>
+ 提供最大的可重用性和灵活性</entry>
</row>
<row>
<entry>
<itemizedlist mark="bullet">
- <listitem>traits based customization of internal representations
for size versus resolution control</listitem>
- <listitem>Allowing the use of different epochs and resolution (eg:
seconds versus microseconds, dates starting at the year 2000 versus dates
starting in 1700)</listitem>
- <listitem>Options for configuring unique calendar representations
(Gregorian + others)</listitem>
- <listitem>the use of Julian Day number and the conversion between
this and the Gregorian/Julian calendar date</listitem>
- <listitem>Allow for flexible adjustments including leap
seconds</listitem>
+ <listitem>traits based customization of internal representations
for size versus resolution control<sbr/>
+ 基于 traits 的内容表示法定制，用于控制对象大小和精度</listitem>
+ <listitem>Allowing the use of different epochs and resolution (eg:
seconds versus microseconds, dates starting at the year 2000 versus dates
starting in 1700)<sbr/>
+ 可以使用不同的纪元和精度(如：秒或微秒，从2000年开始或从1700年开始
)</listitem>
+ <listitem>Options for configuring unique calendar representations
(Gregorian + others)<sbr/>
+ 可选配置唯一的历法表示法(格里历或其它) </listitem>
+ <listitem>the use of Julian Day number and the conversion between
this and the Gregorian/Julian calendar date<sbr/>
+ 可使用儒略历天数，以及它与格里历/儒略历日期间的转换。</listitem>
+ <listitem>Allow for flexible adjustments including leap
seconds<sbr/>
+ 可以进行包括闰秒在内的灵活调整</listitem>
</itemizedlist>
</entry>
</row>
<row>
- <entry valign="top" morerows="1">Date Calculations</entry>
- <entry>Provide tools for date calculations</entry>
+ <entry valign="top" morerows="1">Date Calculations<sbr/>
+ 日期运算</entry>
+ <entry>Provide tools for date calculations<sbr/>
+ 提供日期运算的工具</entry>
</row>
<row>
<entry>
<itemizedlist mark="bullet">
- <listitem>provide basis for calculation of complex event specs like
holidays</listitem>
- <listitem>calendar to calendar conversions</listitem>
- <listitem>provide for ability to extend to new calendar
systems</listitem>
+ <listitem>provide basis for calculation of complex event specs like
holidays<sbr/>
+ 提供复杂事件如假日计算的基础</listitem>
+ <listitem>calendar to calendar conversions<sbr/>
+ 历法到历法间的转换</listitem>
+ <listitem>provide for ability to extend to new calendar
systems<sbr/>
+ 提供了扩展新历法系统的能力 </listitem>
</itemizedlist>
</entry>
</row>
<row>
- <entry valign="top" morerows="1">Time Calculations</entry>
- <entry>Provide concrete classes for manipulation of time</entry>
+ <entry valign="top" morerows="1">Time Calculations<sbr/>
+ 时间运算</entry>
+ <entry>Provide concrete classes for manipulation of time<sbr/>
+ 提供对时间进行操作的具体类</entry>
</row>
<row>
<entry>
<itemizedlist mark="bullet">
- <listitem>provide the ability to handle cross time-zone
issues</listitem>
- <listitem>provide adjustments for daylight savings time (summer
time)</listitem>
+ <listitem>provide the ability to handle cross time-zone
issues<sbr/>
+ 提供处理跨时区问题的能力</listitem>
+ <listitem>provide adjustments for daylight savings time (summer
time)<sbr/>
+ 提供夏令时调整的能力</listitem>
</itemizedlist>
</entry>
</row>
<row>
- <entry valign="top" morerows="1">Clock Interfaces</entry>
- <entry>Provide classes for retrieving time current time</entry>
+ <entry valign="top" morerows="1">Clock Interfaces<sbr/>
+ 时钟接口</entry>
+ <entry>Provide classes for retrieving time current time<sbr/>
+ 提供取出当前时间的类</entry>
</row>
<row>
<entry>
<itemizedlist mark="bullet">
- <listitem>access to a network / high resolution time sources
</listitem>
- <listitem>retrieving the current date time information to populate
classes </listitem>
+ <listitem>access to a network / high resolution time sources
<sbr/>
+ 访问网络时间源/高精度时间源</listitem>
+ <listitem>retrieving the current date time information to populate
classes <sbr/>
+ 将当前的日期时间设置到各个组装类中</listitem>
</itemizedlist>
</entry>
</row>
<row>
- <entry valign="top" morerows="1">I/O Interfaces</entry>
- <entry>Provide input and output for time including</entry>
+ <entry valign="top" morerows="1">I/O Interfaces<sbr/>
+ I/O 接口</entry>
+ <entry>Provide input and output for time including<sbr/>
+ 提供时间的输入输出，包括</entry>
</row>
<row>
<entry>
<itemizedlist mark="bullet">
- <listitem>multi-lingual support </listitem>
- <listitem>provide ISO8601 compliant time facet </listitem>
- <listitem>use I/O facets for different local behavior </listitem>
+ <listitem>multi-lingual support <sbr/>
+ 多语言支持</listitem>
+ <listitem>provide ISO8601 compliant time facet <sbr/>
+ 提供符合 ISO8601 的时间 facet
+</listitem>
+ <listitem>use I/O facets for different local behavior <sbr/>
+ 对不同的本地行为使用 I/O facets </listitem>
</itemizedlist>
</entry>
</row>
=======================================
--- /trunk/libs/date_time/xmldoc/details.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/details.xml Wed Jan 6 17:26:22 2010
@@ -8,7 +8,7 @@
-->
<section id="date_time.details" xmlns:xi="http://www.w3.org/2001/XInclude";>
- <title>Details</title>
+ <title>Details 具体细节</title>
<xi:include href="calculations.xml" />
<xi:include href="design_goals.xml" />
=======================================
--- /trunk/libs/date_time/xmldoc/domain_concepts.xml Mon Dec 28 23:05:14
2009
+++ /trunk/libs/date_time/xmldoc/domain_concepts.xml Wed Jan 6 17:26:22
2010
@@ -8,53 +8,70 @@
-->
<section id="date_time.domain_concepts">
- <title>Domain Concepts</title>
+ <title>Domain Concepts 领域概念</title>
<para>
The date time domain is rich in terminology and problems.
The following is a brief introduction to the concepts you
- will find reflected in the library.
+ will find reflected in the library. <sbr/>
+ 日期时间领域有大量术语和问题。以下对你将会在本库碰到的一些概念作一个简
要的介绍。
</para>
<para>
- The library supports 3 basic temporal types:
+ The library supports 3 basic temporal types:<sbr/>
+ 本库支持3种基本的时间类型：
<itemizedlist mark="bullet">
<listitem>
<emphasis role="strong">Time Point</emphasis> -- Specifier
- for a location in the time continuum.
+ for a location in the time continuum.<sbr/>
+ <emphasis role="strong">时间点</emphasis> -- 在时间连续统中的一个特定位
置。
</listitem>
<listitem>
<emphasis role="strong">Time Duration</emphasis> -- A
- length of time unattached to any point on the time continuum.
+ length of time unattached to any point on the time continuum.<sbr/>
+ <emphasis role="strong">时间长度</emphasis> -- 独立于时间连续统上任意点
的一段时间长度。
</listitem>
<listitem>
<emphasis role="strong">Time Interval</emphasis> -- A duration
of time attached to a specific point in the time continuum.
- Also known as a time period.
+ Also known as a time period. <sbr/>
+ <emphasis role="strong">时间间隔</emphasis> -- 关联于时间连续统上某个特
定点的一段时间长度。也称为时间段。
</listitem>
</itemizedlist>
</para>
<para>
- Each of these temporal types has a <emphasis
role="strong">Resolution</emphasis> which is defined by the smallest
representable duration. A <emphasis role="strong">Time system</emphasis>
provides all these categories of temporal types as well as the rules for
labeling and calculating with time points. <emphasis role="strong">Calendar
Systems</emphasis> are simply time systems with a maximum resolution of one
day. The <emphasis role="strong">Gregorian</emphasis> system is the most
widely used calendar system today (the ISO system is basically a derivative
of this). However, there are many other calendar systems as well. <emphasis
role="strong">UTC (Coordinated Universal Time)</emphasis> is a widely used
civil time system. UTC is adjusted for earth rotation at longitude 0 by the
use of leap seconds (This is not predictable, only as necessary). Most
<emphasis role="strong">local time</emphasis> systems are based on UTC but
are also adjusted for earth rotation so that daylight hours are similar
everywhere. In addition, some local times include <emphasis
role="strong">daylight savings time (DST)</emphasis> adjustments to shift
the daylight hours during the summer.
+ Each of these temporal types has a <emphasis
role="strong">Resolution</emphasis> which is defined by the smallest
representable duration. A <emphasis role="strong">Time system</emphasis>
provides all these categories of temporal types as well as the rules for
labeling and calculating with time points. <emphasis role="strong">Calendar
Systems</emphasis> are simply time systems with a maximum resolution of one
day. The <emphasis role="strong">Gregorian</emphasis> system is the most
widely used calendar system today (the ISO system is basically a derivative
of this). However, there are many other calendar systems as well. <emphasis
role="strong">UTC (Coordinated Universal Time)</emphasis> is a widely used
civil time system. UTC is adjusted for earth rotation at longitude 0 by the
use of leap seconds (This is not predictable, only as necessary). Most
<emphasis role="strong">local time</emphasis> systems are based on UTC but
are also adjusted for earth rotation so that daylight hours are similar
everywhere. In addition, some local times include <emphasis
role="strong">daylight savings time (DST)</emphasis> adjustments to shift
the daylight hours during the summer.<sbr/>
+ 这些时间类型中的每一个都有一个<emphasis role="strong">分辨率
</emphasis>，它由可表示的最小时间长度定义。
+ 一个<emphasis role="strong">时间系统</emphasis>除了提供所有这些时间类型
之外，还应提供对时间点进行标注和计算的规则。
+ <emphasis role="strong">日历系统</emphasis>是最简单的时间系统，它的分辨
率最大，为一天。
+ <emphasis role="strong">格里历</emphasis>系统是当今使用最广的日历系统
(ISO系统基本上就是衍生自它)。
+ 不过，还有很多其它的日历系统。<emphasis role="strong">UTC (Coordinated
Universal Time)</emphasis>
+ 是一个广泛使用的民用时间系统。因为地球的自转，UTC要通过闰秒来进行调整
(这不是可预测的，只是按需要进行调整)。
+ 多数<emphasis role="strong">本地时间</emphasis>系统都基于UTC，但还要根
据地球自转来进行调整，以使得各处白天的时间相似。
+ 另外，有些本地时间还包括了<emphasis role="strong">夏时制
(DST)</emphasis>的调整，在夏天的时候对白天的时间进行平移。
</para>
<para>
- A <emphasis role="strong">Clock Device</emphasis> is software
component (tied to some hardware) that provides the current date or time
with respect to a time system. A clock can measure the current time to a
known resolution which may be higher or lower than a particular time
representation.
+ A <emphasis role="strong">Clock Device</emphasis> is software
component (tied to some hardware) that provides the current date or time
with respect to a time system. A clock can measure the current time to a
known resolution which may be higher or lower than a particular time
representation. <sbr/>
+ <emphasis role="strong">时钟设备</emphasis>是一种软件组件(绑定于某个硬
件)，它提供基于某个时间系统的当前日期或时间。
+ 时钟可以按已知的分辨率测量时间，该分辨率可能高于或低于特定的时间表示
法。
</para>
<para>
- The library provides support for calculating with dates and times.
However, time calculations are not quite the same as calculating with
integers. If you are serious about the accuracy of your time calculations
need to read about <link linkend="date_time.tradeoffs">Stability,
Predictability, and Approximations</link>.
+ The library provides support for calculating with dates and times.
However, time calculations are not quite the same as calculating with
integers. If you are serious about the accuracy of your time calculations
need to read about <link linkend="date_time.tradeoffs">Stability,
Predictability, and Approximations</link>. <sbr/>
+ 本库提供了对日期和时间进行计算的支持。但是，时间的计算与整数的计算有点
不同。如果你对于时间计算的精确性非常关注，
+ 那么你需要阅读 <link linkend="date_time.tradeoffs">稳定性、可预言和近似
值</link> 一节。
</para>
<para>
<itemizedlist mark="bullet">
<listitem>
- <link linkend="date_time.terminology">Basic Terminology</link>
+ <link linkend="date_time.terminology">Basic Terminology 基本术语</link>
</listitem>
<listitem>
- <link linkend="date_time.calculations">Calculations</link>
+ <link linkend="date_time.calculations">Calculations 计算</link>
</listitem>
<listitem>
- <link linkend="date_time.tradeoffs">Stability, Predictability, and
Approximations</link>
+ <link linkend="date_time.tradeoffs">Stability, Predictability, and
Approximations 稳定性、可预言和近似值</link>
</listitem>
<listitem>
- <link linkend="date_time.references">References</link>
+ <link linkend="date_time.references">References 参考</link>
</listitem>
</itemizedlist>
</para>
=======================================
--- /trunk/libs/date_time/xmldoc/doxy.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/doxy.xml Wed Jan 6 17:26:22 2010
@@ -8,10 +8,12 @@
-->
<section id="date_time.doxy" xmlns:xi="http://www.w3.org/2001/XInclude";>
- <title>Library Reference</title>
+ <title>Library Reference 本库的参考手册</title>
<para>
- The following is a detailed reference of the date_time library. A
click on any of the reference links will take you to a list of the header
files found in that section. Following one of those links will take you to
a list of the items declared in that header file. Further sublinks take you
to detailed descriptions of each individual item.
+ The following is a detailed reference of the date_time library. A
click on any of the reference links will take you to a list of the header
files found in that section. Following one of those links will take you to
a list of the items declared in that header file. Further sublinks take you
to detailed descriptions of each individual item.<sbr/>
+ 以下是 date_time 库的详细参考。点击任一个参考的链接会把你带到一个头文件
列表中。
+ 随着其中的链接会把你带到头文件中声明的项目列表中。更进一步的子链接会把
你带到每个单独项目的详细描述。
</para>
<xi:include href="date_time_autodoc.xml"/>
=======================================
--- /trunk/libs/date_time/xmldoc/ex_calc_rules.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/ex_calc_rules.xml Wed Jan 6 17:26:22 2010
@@ -8,14 +8,16 @@
-->
<section id="date_time.examples.calc_rules">
- <title>Daylight Savings Calc Rules</title>
+ <title>Daylight Savings Calc Rules 夏时制计算规则</title>
<para>
- Example of creating various Daylight Savings Calc Rule objects.
+ Example of creating various Daylight Savings Calc Rule objects.<sbr/>
+ 创建多个夏时制计算规则对象的例子。
</para>
<programlisting>
<![CDATA[
/* A simple example for creating various dst_calc_rule instances
+ * 一个简单例子，创建多个 dst_calc_rule 实例
*/
#include "boost/date_time/gregorian/gregorian.hpp"
@@ -30,13 +32,14 @@
using namespace gregorian;
/***** create the necessary date_generator objects *****/
- // starting generators
+ /***** 创建所需的 date_generator 对象 *****/
+ // starting generators 开始日期生成器
first_day_of_the_week_in_month fd_start(Sunday, May);
last_day_of_the_week_in_month ld_start(Sunday, May);
nth_day_of_the_week_in_month
nkd_start(nth_day_of_the_week_in_month::third,
Sunday, May);
partial_date pd_start(1, May);
- // ending generators
+ // ending generators 结束日期生成器
first_day_of_the_week_in_month fd_end(Sunday, Oct);
last_day_of_the_week_in_month ld_end(Sunday, Oct);
nth_day_of_the_week_in_month
nkd_end(nth_day_of_the_week_in_month::third,
@@ -44,6 +47,7 @@
partial_date pd_end(31, Oct);
/***** create the various dst_calc_rule objects *****/
+ /***** 创建多个 dst_calc_rule 对象 *****/
dst_calc_rule_ptr pdr(new partial_date_dst_rule(pd_start, pd_end));
dst_calc_rule_ptr flr(new first_last_dst_rule(fd_start, ld_end));
dst_calc_rule_ptr llr(new last_last_dst_rule(ld_start, ld_end));
=======================================
--- /trunk/libs/date_time/xmldoc/ex_date_period_calc.xml Mon Dec 28
23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/ex_date_period_calc.xml Wed Jan 6
17:26:22 2010
@@ -8,24 +8,30 @@
-->
<section id="date_time.examples.date_period_calc">
- <title>Date Period Calculations</title>
+ <title>Date Period Calculations 日期段计算</title>
<para>
- Calculates if a date is in an 'irregular' collection of periods using
period calculation functions.
+ Calculates if a date is in an 'irregular' collection of periods using
period calculation functions.<sbr/>
+ 用时间段计算函数计算某个日期是否位于一个‘无规则’的时间段集合中。
</para>
<programlisting>
<![CDATA[
/*
This example demonstrates a simple use of periods for the calculation
of date information.
+ 本例示范了使用时间段来计算日期信息。
The example calculates if a given date is a weekend or holiday
given an exclusion set. That is, each weekend or holiday is
entered into the set as a time interval. Then if a given date
is contained within any of the intervals it is considered to
be within the exclusion set and hence is a offtime.
+ 本例计算一个给定的日期是否在一个给定的周末或假日集合中。即，
+ 每个周末或假日 作为一个时间间隔放入一个集合中。如果给定的日期
+ 被某一个间隔所包含则认为它是在这个排除集合之中，是一个休息日。
Output:
+ 输出：
Number Excluded Periods: 5
20020202/20020203
20020209/20020210
@@ -45,6 +51,7 @@
typedef std::set<boost::gregorian::date_period> date_period_set;
//Simple population of the exclusion set
+ //生成排除集合
date_period_set
generateExclusion()
{
@@ -60,6 +67,7 @@
date_period_set ps;
//insert the periods in the set
+ //将时间段插入到集合中
std::insert_iterator<date_period_set> itr(ps, ps.begin());
std::copy(periods_array, periods_array+num_periods, itr );
return ps;
@@ -77,9 +85,11 @@
date d(2002,Feb,16);
date_period_set::const_iterator i = ps.begin();
//print the periods, check for containment
+ //打印时间段，并检查包含性
for (;i != ps.end(); i++) {
std::cout << to_iso_string(*i) << std::endl;
//if date is in exclusion period then print it
+ //如果 date 位于于排除时间段中则打印它
if (i->contains(d)) {
std::cout << "In Exclusion Period: "
<< to_iso_string(d) << " --> " << to_iso_string(*i)
=======================================
--- /trunk/libs/date_time/xmldoc/ex_dates_as_strings.xml Mon Dec 28
23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/ex_dates_as_strings.xml Wed Jan 6
17:26:22 2010
@@ -8,22 +8,24 @@
-->
<section id="date_time.examples.dates_as_strings">
- <title>Dates as Strings</title>
+ <title>Dates as Strings 字符串表示的日期</title>
<para>
- Various parsing and output of strings.
+ Various parsing and output of strings.<sbr/>
+ 多个字符串的分析和输出。
</para>
<programlisting>
<![CDATA[
/* The following is a simple example that shows conversion of dates
* to and from a std::string.
- *
- * Expected output:
+ * 以下例子示范了 date 和 std::string 之间的转换。
+ *
+ * Expected output: 正常输出：
* 2001-Oct-09
* 2001-10-09
* Tuesday October 9, 2001
- * An expected exception is next:
+ * An expected exception is next: 有一个异常：
* Exception: Month number is out of range 1..12
*/
@@ -39,16 +41,19 @@
try {
// The following date is in ISO 8601 extended format (CCYY-MM-DD)
+ // 以下日期以 ISO 8601 扩展格式表示 (CCYY-MM-DD)
std::string s("2001-10-9"); //2001-October-09
date d(from_simple_string(s));
std::cout << to_simple_string(d) << std::endl;
//Read ISO Standard(CCYYMMDD) and output ISO Extended
+ // 读入 ISO 标准格式(CCYYMMDD) 并输出 ISO 扩展格式
std::string ud("20011009"); //2001-Oct-09
date d1(from_undelimited_string(ud));
std::cout << to_iso_extended_string(d1) << std::endl;
//Output the parts of the date - Tuesday October 9, 2001
+ // 输出 date 的各个部分 - Tuesday October 9, 2001
date::ymd_type ymd = d1.year_month_day();
greg_weekday wd = d1.day_of_week();
std::cout << wd.as_long_string() << " "
@@ -57,10 +62,12 @@
<< std::endl;
//Let's send in month 25 by accident and create an exception
+ // 我们传入月份 25 以创造一个异常
std::string bad_date("20012509"); //2001-??-09
std::cout << "An expected exception is next: " << std::endl;
date wont_construct(from_undelimited_string(bad_date));
//use wont_construct so compiler doesn't complain, but you wont get
here!
+ // 使用 wont_construct 令编译器不告警，但你到不了这里!
std::cout << "oh oh, you shouldn't reach this line: "
<< to_iso_string(wont_construct) << std::endl;
}
=======================================
--- /trunk/libs/date_time/xmldoc/ex_days_alive.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/ex_days_alive.xml Wed Jan 6 17:26:22 2010
@@ -8,16 +8,18 @@
-->
<section id="date_time.examples.days_alive">
- <title>Days Alive</title>
+ <title>Days Alive 已生活的日子</title>
<para>
- Calculate the number of days you have been living using durations and
dates.
+ Calculate the number of days you have been living using durations and
dates.<sbr/>
+ 使用时间长度和日期来计算你已经活过的天数。
</para>
<programlisting>
<literal>
<phrase role="comment">/* Short example that calculates the number of days
since user was born.
* Demonstrates comparisons of durations, use of the day_clock,
* and parsing a date from a string.
+ * 以下短例计算你出生后的天数。示范了时间长度的比较，使用 day_clock, 以及从
字符串分析 date.
*/</phrase><phrase role="preprocessor">
#include</phrase><phrase role="string">
"boost/date_time/gregorian/gregorian.hpp"</phrase><phrase
role="preprocessor">
=======================================
--- /trunk/libs/date_time/xmldoc/ex_days_between_new_years.xml Mon Dec 28
23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/ex_days_between_new_years.xml Wed Jan 6
17:26:22 2010
@@ -8,19 +8,23 @@
-->
<section id="date_time.examples.days_between_new_year">
- <title>Days Between New Years</title>
+ <title>Days Between New Years 距离新年的日子</title>
<para>
- Calculate the number of days till new years
+ Calculate the number of days till new years<sbr/>
+ 计算到新年的天数。
</para>
<programlisting>
<![CDATA[
/* Provides a simple example of using a date_generator, and simple
* mathematical operatorations, to calculate the days since
* New Years day of this year, and days until next New Years day.
+ * 以下例子使用一个 date_generator, 以及简单的数学操作，
+ * 来计算距离今年新年的天数，以及到下一个新年的天数。
*
* Expected results:
* Adding together both durations will produce 366 (365 in a leap year).
+ * 正常结果：两个天数相加为 365 (闰年则为 366)。
*/
#include <iostream>
#include "boost/date_time/gregorian/gregorian.hpp"
@@ -34,6 +38,7 @@
date today = day_clock::local_day();
partial_date new_years_day(1,Jan);
//Subtract two dates to get a duration
+ // 将两个日期相减，获得一个时间长度
days days_since_year_start = today -
new_years_day.get_date(today.year());
std::cout << "Days since Jan 1: " << days_since_year_start.days()
<< std::endl;
=======================================
--- /trunk/libs/date_time/xmldoc/ex_find_last_day_of_months.xml Mon Dec 28
23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/ex_find_last_day_of_months.xml Wed Jan 6
17:26:22 2010
@@ -8,15 +8,17 @@
-->
<section id="date_time.examples.end_of_month_day">
- <title>Last Day of the Months</title>
+ <title>Last Day of the Months 每个月的最后一天</title>
<para>
- Example that gets a month and a year from the user and finds the last
day of each remaining month of that year.
+ Example that gets a month and a year from the user and finds the last
day of each remaining month of that year.<sbr/>
+ 以下例子让用户输入一个月份和年份，找出该年所剩每个月的最后一天。
</para>
<programlisting>
<![CDATA[
/* Simple program that finds the last day of the given month,
* then displays the last day of every month left in the given year.
+ * 该例找出给定月份的最后一天，然后显示给定年份所剩各月的最后一天。
*/
#include "boost/date_time/gregorian/gregorian.hpp"
@@ -31,6 +33,7 @@
greg_month month(1);
// get a month and a year from the user
+ // 用户给定一个月份和年份
try {
int y, m;
std::cout << " Enter Year(ex: 2002): ";
@@ -53,6 +56,7 @@
date d(year, month, 1);
// add another month to d until we enter the next year.
+ // 将一个月增加到 d 直到下一年。
while (d < start_of_next_year){
std::cout << to_simple_string(d.end_of_month()) << std::endl;
d += months(1);
=======================================
--- /trunk/libs/date_time/xmldoc/ex_flight.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/ex_flight.xml Wed Jan 6 17:26:22 2010
@@ -8,9 +8,11 @@
-->
<section id="date_time.examples.flight">
- <title>Flight Time Example</title>
-
- <para>This example shows a program that calculates the arrival time of a
plane that flys from Phoenix to New York. During the flight New York
shifts into daylight savings time (Phoenix doesn't because Arizona doesn't
use dst).</para>
+ <title>Flight Time Example 飞行时间例子</title>
+
+ <para>This example shows a program that calculates the arrival time of a
plane that flys from Phoenix to New York. During the flight New York
shifts into daylight savings time (Phoenix doesn't because Arizona doesn't
use dst).<sbr/>
+ 本例示范了如何计算飞机从凤凰城飞到纽约的到达时间。在飞行中，纽约恰好转入
了夏时制
+ (因为亚利桑那州不使用夏时制，所以凤凰城也不使用)。</para>
<programlisting>
<literal>
@@ -21,6 +23,8 @@
* that flys from Phoenix to New York. During the flight New York shifts
* into daylight savings time (Phoenix doesn't because Arizona doesn't use
* dst).
+ * 本例示范了如何计算飞机从凤凰城飞到纽约的到达时间。在飞行中，纽约刚好转入
夏时制
+ * (因为亚利桑那州不使用夏时制，所以凤凰也不使用)。
*
*
*/</phrase><phrase role="keyword">
@@ -34,6 +38,8 @@
//setup some timezones for creating and adjusting local times
//This user editable file can be found in libs/date_time/data.
+ //设置一些时区，以创建和调整本地时间
+ //从 libs/date_time/data 查找可由用户编辑的文件
</phrase><phrase role="identifier"> tz_database</phrase><phrase
role="identifier"> tz_db</phrase><phrase role="special">;</phrase><phrase
role="identifier">
tz_db</phrase><phrase role="special">.</phrase><phrase
role="identifier">load_from_file</phrase><phrase
role="special">(</phrase><phrase
role="string">"date_time_zonespec.csv"</phrase><phrase
role="special">);</phrase><phrase role="identifier">
time_zone_ptr</phrase><phrase role="identifier"> nyc_tz</phrase><phrase
role="special"> =</phrase><phrase role="identifier"> tz_db</phrase><phrase
role="special">.</phrase><phrase
role="identifier">time_zone_from_region</phrase><phrase
role="special">(</phrase><phrase
role="string">"America/New_York"</phrase><phrase
role="special">);</phrase><phrase role="comment">
@@ -42,6 +48,8 @@
//local departure time in phoenix is 11 pm on april 2 2005
// (ny changes to dst on apr 3 at 2 am)
+ //使用凤凰城的本地时间作为出发时间 11 pm on april 2 2005
+ // (纽约将在 apr 3 的 2 am 转入夏时制)
</phrase><phrase role="identifier"> local_date_time</phrase><phrase
role="identifier"> phx_departure</phrase><phrase
role="special">(</phrase><phrase role="identifier">date</phrase><phrase
role="special">(</phrase><phrase role="number">2005</phrase><phrase
role="special">,</phrase><phrase role="identifier"> Apr</phrase><phrase
role="special">,</phrase><phrase role="number"> 2</phrase><phrase
role="special">),</phrase><phrase role="identifier"> hours</phrase><phrase
role="special">(</phrase><phrase role="number">23</phrase><phrase
role="special">),</phrase><phrase role="identifier">
phx_tz</phrase><phrase
role="special">,</phrase><phrase role="identifier">
local_date_time</phrase><phrase
role="special">::</phrase><phrase
role="identifier">NOT_DATE_TIME_ON_ERROR</phrase><phrase
role="special">);</phrase><phrase role="identifier">
=======================================
--- /trunk/libs/date_time/xmldoc/ex_local_utc_conversion.xml Mon Dec 28
23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/ex_local_utc_conversion.xml Wed Jan 6
17:26:22 2010
@@ -8,16 +8,18 @@
-->
<section id="date_time.examples.local_utc_conversion">
- <title>Local to UTC Conversion</title>
+ <title>Local to UTC Conversion 本地时间到 UTC 的转换</title>
<para>
- Demonstrate utc to local and local to utc calculations including dst.
+ Demonstrate utc to local and local to utc calculations including
dst.<sbr/>
+ 示范 utc 到本地时间以及本地时间到 utc 的转换，包括 dst.
</para>
<programlisting>
<![CDATA[
/* Demonstrate conversions between a local time and utc
* Output:
+ * 示范在本地时间和 utc 之间的转换，输出：
*
* UTC <--> New York while DST is NOT active (5 hours)
* 2001-Dec-31 19:00:00 in New York is 2002-Jan-01 00:00:00 UTC time
@@ -43,6 +45,7 @@
using namespace boost::gregorian;
//This local adjustor depends on the machine TZ settings-- highly
dangerous!
+ //本地时间调整器取决于机器的 TZ 设置 -- 高度危险！
typedef boost::date_time::c_local_adjustor<ptime> local_adj;
ptime t10(date(2002,Jan,1), hours(7));
ptime t11 = local_adj::utc_to_local(t10);
@@ -56,9 +59,10 @@
//eastern timezone is utc-5
+ //东部时区为 utc-5
typedef boost::date_time::local_adjustor<ptime, -5, us_dst> us_eastern;
- ptime t1(date(2001,Dec,31), hours(19)); //5 hours b/f midnight NY time
+ ptime t1(date(2001,Dec,31), hours(19)); //5 hours b/f midnight NY time
纽约时间的午夜前5个小时
std::cout << "\nUTC <--> New York while DST is NOT active (5 hours)"
<< std::endl;
@@ -67,25 +71,26 @@
<< to_simple_string(t2) << " UTC time "
<< std::endl;
- ptime t3 = us_eastern::utc_to_local(t2);//back should be the same
+ ptime t3 = us_eastern::utc_to_local(t2);//back should be the same 转换
回去，应该相同
std::cout << to_simple_string(t2) << " UTC is "
<< to_simple_string(t3) << " New York time "
<< "\n\n";
- ptime t4(date(2002,May,31), hours(20)); //4 hours b/f midnight NY time
+ ptime t4(date(2002,May,31), hours(20)); //4 hours b/f midnight NY time
纽约时间的午夜前4个小时
std::cout << "UTC <--> New York while DST is active (4 hours)" <<
std::endl;
ptime t5 = us_eastern::local_to_utc(t4);
std::cout << to_simple_string(t4) << " in New York is "
<< to_simple_string(t5) << " UTC time "
<< std::endl;
- ptime t6 = us_eastern::utc_to_local(t5);//back should be the same
+ ptime t6 = us_eastern::utc_to_local(t5);//back should be the same 转换
回去，应该相同
std::cout << to_simple_string(t5) << " UTC is "
<< to_simple_string(t6) << " New York time "
<< "\n" << std::endl;
//Arizona timezone is utc-7 with no dst
+ //亚利桑那时区为 utc-7 无 dst
typedef boost::date_time::local_adjustor<ptime, -7, no_dst> us_arizona;
ptime t7(date(2002,May,31), hours(17));
=======================================
--- /trunk/libs/date_time/xmldoc/ex_localization.xml Mon Dec 28 23:05:14
2009
+++ /trunk/libs/date_time/xmldoc/ex_localization.xml Wed Jan 6 17:26:22
2010
@@ -8,10 +8,11 @@
-->
<section id="date_time.examples.localization">
- <title>Localization Demonstration</title>
+ <title>Localization Demonstration 本地化示例</title>
<para>
- The boost::date_time library provides the ability to create customized
locale facets. Date ordering, language, seperators, and abbreviations can
be customized.
+ The boost::date_time library provides the ability to create customized
locale facets. Date ordering, language, seperators, and abbreviations can
be customized.<sbr/>
+ boost::date_time 库提供了创建定制 locale facets 的能力。日期的顺序、语
言、分隔符和缩写均可定制。
</para>
<!-- <para>
This example uses the new (as of 1.33) date_time IO code. An example
using the old code is also provided to demonstrate how much easier
customized output is (see <link
linkend="date_time.examples.legacy_localization">legacy_localization
example</link>).
@@ -21,6 +22,8 @@
/* The following shows the creation of a facet for the output of
* dates in German (please forgive me for any errors in my German --
* I'm not a native speaker).
+ * 下面示范了创建一个以德语输出日期的 facet (请原谅我的德语中的错误 --
+ * 我的母语不是德语)。
*/
#include "boost/date_time/gregorian/gregorian.hpp"
@@ -29,7 +32,10 @@
/* Define a series of char arrays for short and long name strings
* to be associated with German date output (US names will be
- * retrieved from the locale). */
+ * retrieved from the locale).
+ * 定义一系列字符数据，分别为与德语日期输出相关的缩写和全名字符串
+ * (从该 locale 中取出的将是 US 名)。
+ */
const char* const de_short_month_names[] =
{
"Jan", "Feb", "Mar", "Apr", "Mai", "Jun",
@@ -57,15 +63,18 @@
using namespace boost::gregorian;
// create some gregorian objects to output
+ // 创建一些输出用的格里历对象
date d1(2002, Oct, 1);
greg_month m = d1.month();
greg_weekday wd = d1.day_of_week();
// create a facet and a locale for German dates
+ // 为德语日期创建一个 facet 和一个 locale
date_facet* german_facet = new date_facet();
std::cout.imbue(std::locale(std::locale::classic(), german_facet));
// create the German name collections
+ // 创建德语名字集合
date_facet::input_collection_type short_months, long_months,
short_weekdays, long_weekdays;
std::copy(&de_short_month_names[0], &de_short_month_names[11],
@@ -80,12 +89,15 @@
// replace the default names with ours
// NOTE: date_generators and special_values were not replaced as
// they are not used in this example
+ // 替换我们的缺省名字
+ // 注：date_generators 和 special_values 未被替换，因为本例中未使用
german_facet->short_month_names(short_months);
german_facet->long_month_names(long_months);
german_facet->short_weekday_names(short_weekdays);
german_facet->long_weekday_names(long_weekdays);
// output the date in German using short month names
+ // 以德语的月份缩写输出日期
german_facet->format("%d.%m.%Y");
std::cout << d1 << std::endl; //01.10.2002
@@ -97,6 +109,7 @@
// Output the same gregorian objects using US names
+ // 以 US 名输出相同的格里历对象
date_facet* us_facet = new date_facet();
std::cout.imbue(std::locale(std::locale::classic(), us_facet));
@@ -104,6 +117,7 @@
std::cout << d1 << std::endl; // 10/01/2002
// English names, iso order (year-month-day), '-' separator
+ // 英文名，iso 顺序(年-月-日)，'-' 分隔符
us_facet->format("%Y-%b-%d");
std::cout << d1 << std::endl; // 2002-Oct-01
=======================================
--- /trunk/libs/date_time/xmldoc/ex_month_add.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/ex_month_add.xml Wed Jan 6 17:26:22 2010
@@ -8,17 +8,20 @@
-->
<section id="date_time.examples.month_add">
- <title>Month Adding</title>
+ <title>Month Adding 月份加法</title>
<para>
- Adding a month to a day without the use of iterators.
+ Adding a month to a day without the use of iterators.<sbr/>
+ 不使用迭代器，将一个月加到某天上。
</para>
<programlisting>
<![CDATA[
/* Simple program that uses the gregorian calendar to progress by exactly
* one month, irregardless of how many days are in that month.
+ * 本程序使用格里历来步进刚好一个月，无论这个月有多少天。
*
* This method can be used as an alternative to iterators
+ * 本方法可作为迭代器之外的另一个选择
*/
#include "boost/date_time/gregorian/gregorian.hpp"
=======================================
--- /trunk/libs/date_time/xmldoc/ex_print_holidays.xml Mon Dec 28 23:05:14
2009
+++ /trunk/libs/date_time/xmldoc/ex_print_holidays.xml Wed Jan 6 17:26:22
2010
@@ -8,16 +8,18 @@
-->
<section id="date_time.examples.print_holidays">
- <title>Print Holidays</title>
+ <title>Print Holidays 打印假日</title>
<para>
- This is an example of using functors to define a holiday schedule
+ This is an example of using functors to define a holiday schedule<sbr/>
+ 这是一个用函数对象来定义假日时间表的例子。
</para>
<programlisting>
<![CDATA[
/* Generate a set of dates using a collection of date generators
* Output looks like:
+ * 使用一组日期生成器来生成一组日期，输出如下：
* Enter Year: 2002
* 2002-Jan-01 [Tue]
* 2002-Jan-21 [Mon]
@@ -58,22 +60,24 @@
using namespace boost::gregorian;
//define a collection of holidays fixed by month and day
+ //定义一组固定月份和日期的假日
std::vector<year_based_generator*> holidays;
- holidays.push_back(new partial_date(1,Jan)); //Western New Year
- holidays.push_back(new partial_date(4,Jul)); //US Independence Day
- holidays.push_back(new partial_date(25, Dec));//Christmas day
+ holidays.push_back(new partial_date(1,Jan)); //Western New Year 西方新
年
+ holidays.push_back(new partial_date(4,Jul)); //US Independence Day 美国
独立日
+ holidays.push_back(new partial_date(25, Dec));//Christmas day 圣诞节
//define a shorthand for the nth_day_of_the_week_in_month function
object
+ //为 nth_day_of_the_week_in_month 函数对象定义一个缩写
typedef nth_day_of_the_week_in_month nth_dow;
- //US labor day
+ //US labor day 美国劳动节
holidays.push_back(new nth_dow(nth_dow::first, Monday, Sep));
//MLK Day
holidays.push_back(new nth_dow(nth_dow::third, Monday, Jan));
//Pres day
holidays.push_back(new nth_dow(nth_dow::second, Tuesday, Feb));
- //Thanksgiving
+ //Thanksgiving 感恩节
holidays.push_back(new nth_dow(nth_dow::fourth, Thursday, Nov));
typedef std::set<date> date_set;
@@ -86,6 +90,7 @@
}
//print the holidays to the screen
+ //将假日打印到屏幕
std::for_each(all_holidays.begin(), all_holidays.end(), print_date);
std::cout << "Number Holidays: " << all_holidays.size() << std::endl;
=======================================
--- /trunk/libs/date_time/xmldoc/ex_print_hours.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/ex_print_hours.xml Wed Jan 6 17:26:22 2010
@@ -8,10 +8,11 @@
-->
<section id="date_time.examples.print_hours">
- <title>Print Hours</title>
+ <title>Print Hours 打印小时</title>
<para>
- Demonstrate time iteration, clock retrieval, and simple calculation.
+ Demonstrate time iteration, clock retrieval, and simple calculation.
<sbr/>
+ 示范时间迭代器，时钟取回，以及简单的运算。
</para>
<programlisting>
<![CDATA[
@@ -19,8 +20,11 @@
* Uses the clock to get the local time
* Use an iterator to iterate over the remaining hours
* Retrieve the date part from a time
+ * 打印一天中剩余的小时，使用时钟取出本地时间
+ * 使用一个迭代器来遍历剩余的小时，从时间中取出日期部分
*
* Expected Output something like:
+ * 期望的输出如下：
*
* 2002-Mar-08 16:30:59
* 2002-Mar-08 17:30:59
@@ -43,13 +47,16 @@
using namespace boost::gregorian;
//get the current time from the clock -- one second resolution
+ //从时钟取出当前时间 -- 秒解析度
ptime now = second_clock::local_time();
//Get the date part out of the time
+ //取出时间的日期部分
date today = now.date();
date tommorrow = today + days(1);
ptime tommorrow_start(tommorrow); //midnight
//iterator adds by one hour
+ //迭代器，每次加一个小时
time_iterator titr(now,hours(1));
for (; titr < tommorrow_start; ++titr) {
std::cout << to_simple_string(*titr) << std::endl;
=======================================
--- /trunk/libs/date_time/xmldoc/ex_print_month.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/ex_print_month.xml Wed Jan 6 17:26:22 2010
@@ -8,17 +8,20 @@
-->
<section id="date_time.examples.print_month">
- <title>Print Month</title>
+ <title>Print Month 打印月份</title>
<para>
- Simple utility to print out days of the month with the days of a
month. Demontstrates date iteration (date_time::date_itr).
+ Simple utility to print out days of the month with the days of a
month. Demontstrates date iteration (date_time::date_itr).<sbr/>
+ 一个简单的工具，打印一个月的所有日期。示范了日期迭代器
(date_time::date_itr).
</para>
<programlisting>
<![CDATA[
/* This example prints all the dates in a month. It demonstrates
* the use of iterators as well as functions of the gregorian_calendar
+ * 本例打印一个月的所有日期。它示范了迭代器和 gregorian_calendar 函数的使
用
*
* Output:
+ * 输出：
* Enter Year: 2002
* Enter Month(1..12): 2
* 2002-Feb-01 [Fri]
@@ -45,12 +48,15 @@
using namespace boost::gregorian;
try {
//Use the calendar to get the last day of the month
+ //使用 calendar 取得该月的最后一天
int eom_day = gregorian_calendar::end_of_month_day(year,month);
date endOfMonth(year,month,eom_day);
//construct an iterator starting with firt day of the month
+ //构造一个迭代器，从该月的第一天开始
day_iterator ditr(date(year,month,1));
//loop thru the days and print each one
+ //按日子循环并打印每一天
for (; ditr <= endOfMonth; ++ditr) {
#if defined(BOOST_DATE_TIME_NO_LOCALE)
std::cout << to_simple_string(*ditr) << " ["
=======================================
--- /trunk/libs/date_time/xmldoc/ex_seconds_since_epoch.xml Mon Dec 28
23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/ex_seconds_since_epoch.xml Wed Jan 6
17:26:22 2010
@@ -8,10 +8,11 @@
-->
<section id="date_time.examples.seconds_since_epoch">
- <title>Seconds Since Epoch</title>
+ <title>Seconds Since Epoch 从纪元起计的秒数</title>
<para>
- Example of calculating seconds elapsed since epoch (1970-Jan-1) using
local_date_time.
+ Example of calculating seconds elapsed since epoch (1970-Jan-1) using
local_date_time.<sbr/>
+ 这个例子使用 local_date_time 计算从纪元(1970-Jan-1)以来的秒数。
</para>
<programlisting>
<![CDATA[
@@ -20,12 +21,20 @@
* time_t epoch 1970-01-01 00:00:00. Note that the selected timezone
* could be any timezone supported in the time zone database file which
* can be modified and updated as needed by the user.
+ * 本例示范了使用时区数据库和本地时间来计算从 UTC
+ * time_t 纪元 1970-01-01 00:00:00 起计的秒数。注意选用的时区
+ * 可以是时区数据库文件中支持的任意时区，该数据库文件可由用户修改和更新。
*
* To solve this problem the following steps are required:
* 1) Get a timezone from the tz database for the local time
* 2) Construct a local time using the timezone
* 3) Construct a posix_time::ptime for the time_t epoch time
* 4) Convert the local_time to utc and subtract the epoch time
+ * 为解决这个问题，需要以下步骤：
+ * 1) 从 tz 数据库中取出本地时间的时区
+ * 2) 使用该时区构造一个本地时间
+ * 3) 为 time_t 纪元时间构造一个 posix_time::ptime
+ * 4) 将 local_time 转换为 utc 并减去纪元时间
*
*/
@@ -54,6 +63,8 @@
time_duration td(12,14,32);
// construct with local time value
// create not-a-date-time if invalid (eg: in dst transition)
+ // 构造本地时间值
+ // 如果无效则创建 not-a-date-time (如：在夏时制转换中)
local_date_time nyc_time(in_date,
td,
nyc_tz,
@@ -66,9 +77,11 @@
// first convert nyc_time to utc via the utc_time()
// call and subtract the ptime.
+ // 通过 utc_time() 将 nyc_time 转换为 utc 并减去 ptime.
time_duration diff = nyc_time.utc_time() - time_t_epoch;
//Expected 1096906472
+ //正确结果 1096906472
std::cout << "Seconds diff: " << diff.total_seconds() << std::endl;
}
=======================================
--- /trunk/libs/date_time/xmldoc/ex_simple_time_zone.xml Mon Dec 28
23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/ex_simple_time_zone.xml Wed Jan 6
17:26:22 2010
@@ -8,14 +8,16 @@
-->
<section id="date_time.examples.simple_time_zone">
- <title>Simple Time Zones</title>
+ <title>Simple Time Zones 简单的时区</title>
<para>
- Example usage of custom_time_zone as well as posix_time_zone.
+ Example usage of custom_time_zone as well as posix_time_zone.<sbr/>
+ 使用 custom_time_zone 和 posix_time_zone 的例子。
</para>
<programlisting>
<![CDATA[
/* A simple example for using a custom_time_zone and a posix_time_zone.
+ * 使用 custom_time_zone 和 posix_time_zone 的简单例子。
*/
#include "boost/date_time/local_time/local_time.hpp"
@@ -32,6 +34,7 @@
/***** custom_time_zone *****/
// create the dependent objects for a custom_time_zone
+ // 为 custom_time_zone 创建相关的对象
time_zone_names tzn("Eastern Standard Time", "EST",
"Eastern Daylight Time", "EDT");
time_duration utc_offset(-5,0,0);
@@ -42,21 +45,28 @@
// start on first Sunday of April at 2 am
// end on last Sunday of October at 2 am
// so we use a first_last_dst_rule
+ // 本时区的夏时制规则是：
+ // 从四月第一个星期天的 2 am 开始
+ // 到十月最后一个星期天的 2 am 结束
+ // 所以我们使用 first_last_dst_rule
first_day_of_the_week_in_month start_rule(Sunday, Apr);
last_day_of_the_week_in_month end_rule(Sunday, Oct);
shared_ptr<dst_calc_rule> nyc_rules(new first_last_dst_rule(start_rule,
end_rule));
// create more dependent objects for a non-dst custom_time_zone
+ // 为无夏时制的 custom_time_zone 创建更多的相关对象
time_zone_names tzn2("Mountain Standard Time", "MST",
- "", ""); // no dst means empty dst strings
+ "", ""); // no dst means empty dst strings 无
dst 使用空的 dst 字符串
time_duration utc_offset2(-7,0,0);
dst_adjustment_offsets adj_offsets2(time_duration(0,0,0),
time_duration(0,0,0),
time_duration(0,0,0));
// no dst means we need a null pointer to the rules
+ // 无 dst 意味着我们需要空指针来表示规则
shared_ptr<dst_calc_rule> phx_rules;
- // create the custom_time_zones
+ // create the custom_time_zones
+ // 创建 custom_time_zones
time_zone_ptr nyc_1(new custom_time_zone(tzn, utc_offset,
adj_offsets, nyc_rules));
time_zone_ptr phx_1(new custom_time_zone(tzn2, utc_offset2,
@@ -67,15 +77,17 @@
// create posix_time_zones that are the duplicates of the
// custom_time_zones created above. See posix_time_zone documentation
// for details on full zone names.
+ // 创建以上 custom_time_zones 的复制品 posix_time_zones.
+ // 有关时区名的更多细节请见 posix_time_zone 文档。
std::string nyc_string, phx_string;
nyc_string
= "EST-05:00:00EDT+01:00:00,M4.1.0/02:00:00,M10.5.0/02:00:00";
- // nyc_string = "EST-05EDT,M4.1.0,M10.5.0"; // shorter when defaults
used
+ // nyc_string = "EST-05EDT,M4.1.0,M10.5.0"; // shorter when defaults
used 使用缺省值时更短
phx_string = "MST-07"; // no-dst
time_zone_ptr nyc_2(new posix_time_zone(nyc_string));
time_zone_ptr phx_2(new posix_time_zone(phx_string));
- /***** show the sets are equal *****/
+ /***** show the sets are equal 显示两个设置相等 *****/
std::cout << "The first zone is in daylight savings from:\n "
<< nyc_1->dst_local_start_time(2004) << " through "
=======================================
--- /trunk/libs/date_time/xmldoc/ex_time_math.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/ex_time_math.xml Wed Jan 6 17:26:22 2010
@@ -8,15 +8,17 @@
-->
<section id="date_time.examples.time_math">
- <title>Time Math</title>
+ <title>Time Math 时间的算术</title>
<para>
- Various types of calculations with times and time durations.
+ Various types of calculations with times and time durations. <sbr/>
+ 时间和时长的多种运算。
</para>
<programlisting>
<![CDATA[
/* Some simple examples of constructing and calculating with times
* Output:
+ * 有关时间的构造和运算的一些简单例子，输出：
* 2002-Feb-01 00:00:00 - 2002-Feb-01 05:04:02.001000000 =
-5:04:02.001000000
*/
@@ -29,12 +31,15 @@
using namespace boost::posix_time;
using namespace boost::gregorian;
- date d(2002,Feb,1); //an arbitrary date
+ date d(2002,Feb,1); //an arbitrary date 任意一个日期
//construct a time by adding up some durations durations
+ //通过加上一个时长来构造一个时间
ptime t1(d, hours(5)+minutes(4)+seconds(2)+millisec(1));
//construct a new time by subtracting some times
+ //通过减去一个时间来构造新的时间
ptime t2 = t1 - hours(5)- minutes(4)- seconds(2)- millisec(1);
//construct a duration by taking the difference between times
+ //构造一个表示两个时间的差距的时长
time_duration td = t2 - t1;
std::cout << to_simple_string(t2) << " - "
=======================================
--- /trunk/libs/date_time/xmldoc/ex_time_periods.xml Mon Dec 28 23:05:14
2009
+++ /trunk/libs/date_time/xmldoc/ex_time_periods.xml Wed Jan 6 17:26:22
2010
@@ -8,16 +8,18 @@
-->
<section id="date_time.examples.time_periods">
- <title>Time Periods</title>
+ <title>Time Periods 时间段</title>
<para>
- Demonstrate some simple uses of time periods.
+ Demonstrate some simple uses of time periods. <sbr/>
+ 示范有关时间段的一些简单使用。
</para>
<programlisting>
<![CDATA[
/* Some simple examples of constructing and calculating with times
* Returns:
+ * 有关构造和计算时间的一些简单例子，返回：
* [2002-Feb-01 00:00:00/2002-Feb-01 23:59:59.999999999]
* contains 2002-Feb-01 03:00:05
* [2002-Feb-01 00:00:00/2002-Feb-01 23:59:59.999999999]
@@ -34,10 +36,11 @@
using namespace boost::gregorian;
//Create a simple period class to contain all the times in a day
+ //创建一个简单的 period 类，包括一天中的所有时间
class day_period : public time_period
{
public:
- day_period(date d) : time_period(ptime(d),//midnight
+ day_period(date d) : time_period(ptime(d),//midnight 午夜
ptime(d,hours(24)))
{}
@@ -47,17 +50,19 @@
main()
{
- date d(2002,Feb,1); //an arbitrary date
- //a period that represents a day
+ date d(2002,Feb,1); //an arbitrary date 任意一天
+ //a period that represents a day 表示一天的时间段
day_period dp(d);
- ptime t(d, hours(3)+seconds(5)); //an arbitray time on that day
+ ptime t(d, hours(3)+seconds(5)); //an arbitray time on that day 那天的
任意一个时间
if (dp.contains(t)) {
std::cout << to_simple_string(dp) << " contains "
<< to_simple_string(t) << std::endl;
}
//a period that represents part of the day
+ //表示一天的一部分的时间段
time_period part_of_day(ptime(d, hours(0)), t);
//intersect the 2 periods and print the results
+ //计算两个时间的段的交集并打印结果
if (part_of_day.intersects(dp)) {
time_period result = part_of_day.intersection(dp);
std::cout << to_simple_string(dp) << " intersected with\n"
=======================================
--- /trunk/libs/date_time/xmldoc/examples.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/examples.xml Wed Jan 6 17:26:22 2010
@@ -8,7 +8,7 @@
-->
<section id="date_time.examples"
xmlns:xi="http://www.w3.org/2001/XInclude";>
- <title>Examples</title>
+ <title>Examples 例子</title>
<!-- gregorian examples -->
<xi:include href="ex_dates_as_strings.xml"/>
=======================================
--- /trunk/libs/date_time/xmldoc/format_flags.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/format_flags.xml Wed Jan 6 17:26:22 2010
@@ -8,31 +8,37 @@
-->
<section id="date_time.format_flags">
- <title>Format Flags</title>
-
- <para>Many of the format flags this new system uses for output are those
used by <code>strftime(...)</code>, but not all. Some new flags have been
added, and others overridden. The input system supports only specific
flags, therefore, not all flags that work for output will work with input
(we are currently working to correct this situation).</para>
-
- <para>The following tables list the all the flags available for both
date_time IO as well as strftime. Format flags marked with a single
asterisk (*) have a behavior unique to date_time. Those flags marked with
an exclamation point (!) are not usable for input (at this time). The first
table is for dates, and the second table is for times.
+ <title>Format Flags 格式化标志</title>
+
+ <para>Many of the format flags this new system uses for output are those
used by <code>strftime(...)</code>, but not all. Some new flags have been
added, and others overridden. The input system supports only specific
flags, therefore, not all flags that work for output will work with input
(we are currently working to correct this situation).<sbr/>
+ 这个新的IO系统用于输出的格式化标志中，多数都是由
<code>strftime(...)</code> 使用的，但不是全部。
+ 增加了一些新的标志，还覆盖了一些。输入系统只支持一些特定的标志，因此，不
是所有用于输出的标志都可用于输入
+ (我们正在为改善这一情况而努力)。</para>
+
+ <para>The following tables list the all the flags available for both
date_time IO as well as strftime. Format flags marked with a single
asterisk (*) have a behavior unique to date_time. Those flags marked with
an exclamation point (!) are not usable for input (at this time). The first
table is for dates, and the second table is for times.<sbr/>
+ 下面两个表列出了 date_time IO 和 strftime 可用的所有标志。标有星号(*)的格
式化标志只用于 date_time.
+ 标有感叹号(!)的标志不可用于输入(目前)。第一个表是用于日期的IO，第二个表则
用于时间的IO。
</para>
<para>
<anchor id="date_time_io.date_format_flags" />
- Date Facet Format Flags
+ Date Facet Format Flags 日期Facet格式化标志
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Format Specifier</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Format Specifier 格式化符
</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>%a</screen></entry>
- <entry>Abbreviated weekday name</entry>
+ <entry>Abbreviated weekday name<sbr/>
+ 缩写的星期名</entry>
</row>
<row>
<entry><screen>"Mon" => Monday</screen></entry>
@@ -40,7 +46,8 @@
<row>
<entry valign="top" morerows="1"><screen>%A</screen></entry>
- <entry>Long weekday name</entry>
+ <entry>Long weekday name<sbr/>
+ 长星期名</entry>
</row>
<row>
<entry><screen>"Monday"</screen></entry>
@@ -48,7 +55,8 @@
<row>
<entry valign="top" morerows="1"><screen>%b</screen></entry>
- <entry>Abbreviated month name</entry>
+ <entry>Abbreviated month name<sbr/>
+ 缩写的月份名</entry>
</row>
<row>
<entry><screen>"Feb" => February</screen></entry>
@@ -56,7 +64,8 @@
<row>
<entry valign="top" morerows="1"><screen>%B</screen></entry>
- <entry>Full month name</entry>
+ <entry>Full month name<sbr/>
+ 长月份名</entry>
</row>
<row>
<entry><screen>"February"</screen></entry>
@@ -64,7 +73,8 @@
<row>
<entry valign="top" morerows="1"><screen>%c !</screen></entry>
- <entry>The preferred date and time representation for
the current locale.</entry>
+ <entry>The preferred date and time representation for
the current locale.<sbr/>
+ 当前 locale 的首选日期时间表示法。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -72,7 +82,8 @@
<row>
<entry valign="top" morerows="1"><screen>%C !</screen></entry>
- <entry>The century number (year/100) as a 2-digit
integer.</entry>
+ <entry>The century number (year/100) as a 2-digit
integer.<sbr/>
+ 世纪数(year/100)为2位数字的整数。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -80,7 +91,8 @@
<row>
<entry valign="top" morerows="1"><screen>%d</screen></entry>
- <entry>Day of the month as decimal 01 to 31</entry>
+ <entry>Day of the month as decimal 01 to 31<sbr/>
+ 月份中的天数为十进制的 01 到 31</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -88,7 +100,8 @@
<row>
<entry valign="top" morerows="1"><screen>%D !</screen></entry>
- <entry>Equivalent to %m/%d/%y</entry>
+ <entry>Equivalent to %m/%d/%y<sbr/>
+ 等价于 %m/%d/%y</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -96,7 +109,8 @@
<row>
<entry valign="top" morerows="1"><screen>%e</screen></entry>
- <entry>Like %d, the day of the month as a decimal number, but
a leading zero is replaced by a space</entry>
+ <entry>Like %d, the day of the month as a decimal number, but
a leading zero is replaced by a space<sbr/>
+ 类似于 %d, 月份中的天数为十进制数，但前导的0换为空格。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -104,7 +118,8 @@
<row>
<entry valign="top" morerows="1"><screen>%G !</screen></entry>
- <entry>This has the same format and value as %y, except that
if the ISO week number belongs to the previous or next year, that year is
used instead.</entry>
+ <entry>This has the same format and value as %y, except that
if the ISO week number belongs to the previous or next year, that year is
used instead.<sbr/>
+ 与 %y 具有相同的格式和值，除了当ISO星期数属于前一个或后一个年份
时，替换相应年份。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -112,7 +127,8 @@
<row>
<entry valign="top" morerows="1"><screen>%g !</screen></entry>
- <entry>Like %G, but without century.</entry>
+ <entry>Like %G, but without century.<sbr/>
+ 类似于 %G, 但不带世纪数。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -120,7 +136,8 @@
<row>
<entry valign="top" morerows="1"><screen>%h !</screen></entry>
- <entry> Equivalent to %b</entry>
+ <entry> Equivalent to %b<sbr/>
+ 等价于 %b</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -128,7 +145,8 @@
<row>
<entry valign="top" morerows="1"><screen>%j</screen></entry>
- <entry>Day of year as decimal from 001 to 366 for leap years,
001 - 365 for non-leap years.</entry>
+ <entry>Day of year as decimal from 001 to 366 for leap years,
001 - 365 for non-leap years.<sbr/>
+ 在年份中的天数为十进制数，闰年时为 001 到 366，非闰年时为 001
- 365。</entry>
</row>
<row>
<entry><screen>"060" => Feb-29</screen></entry>
@@ -136,7 +154,8 @@
<row>
<entry valign="top" morerows="1"><screen>%m</screen></entry>
- <entry>Month name as a decimal 01 to 12</entry>
+ <entry>Month name as a decimal 01 to 12<sbr/>
+ 月份名为十进制数，从 01 到 12</entry>
</row>
<row>
<entry><screen>"01" => January</screen></entry>
@@ -144,7 +163,8 @@
<row>
<entry valign="top" morerows="1"><screen>%u !</screen></entry>
- <entry>The day of the week as a decimal, range 1 to 7, Monday
being 1.</entry>
+ <entry>The day of the week as a decimal, range 1 to 7, Monday
being 1.<sbr/>
+ 在星期中的天数为十进制数，范围为 1 到 7，星期一为1。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -152,19 +172,23 @@
<row>
<entry valign="top" morerows="1"><screen>%U</screen></entry>
- <entry>The week number of the current year as a decimal
number, range 00 to 53, starting with the first Sunday as the first day of
week 01. In 2005, Jan 1st falls on a Saturday, so therefore it falls within
week 00 of 2005 (week 00 spans 2004-Dec-26 to 2005-Jan-01. This also
happens to be week 53 of 2004).</entry>
+ <entry>The week number of the current year as a decimal
number, range 00 to 53, starting with the first Sunday as the first day of
week 01. In 2005, Jan 1st falls on a Saturday, so therefore it falls within
week 00 of 2005 (week 00 spans 2004-Dec-26 to 2005-Jan-01. This also
happens to be week 53 of 2004).<sbr/>
+ 在当前年份中的周数，以十进制表示，范围从 00 到 53，第一个星期天
作为第01周的第一天。如2005年1月1日为星期六，
+ 则这一天属于2005年的第00周(第00周为 2004-Dec-26 到
2005-Jan-01. 同时这也是2004年的第53周)。</entry>
</row>
<row>
- <entry><screen>date d(2005, Jan, 1); // Saturday
- // with format %U
+ <entry><screen>date d(2005, Jan, 1); // Saturday 星期六
+ // with format %U 格式化为%U
ss << d; // "00"
- d += day(1); // Sunday
- ss << d; // "01" beginning of week 1</screen></entry>
+ d += day(1); // Sunday 星期天
+ ss << d; // "01" beginning of week 1 第1周的开始</screen></entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>%V !</screen></entry>
- <entry>The ISO 8601:1988 week number of the current year as
a decimal number, range 01 to 53, where week 1 is the first week that has
at least 4 days in the current year, and with Monday as the first day
of the week.</entry>
+ <entry>The ISO 8601:1988 week number of the current year as
a decimal number, range 01 to 53, where week 1 is the first week that has
at least 4 days in the current year, and with Monday as the first day
of the week.<sbr/>
+ 在当前年份中的 ISO 8601:1988 周数，以十进制表示，范围从 01 到
53，
+ 其中第1周为至少有4天在本年内的第一周，以星期一作为一周的第一
天。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -172,27 +196,30 @@
<row>
<entry valign="top" morerows="1"><screen>%w</screen></entry>
- <entry>Weekday as decimal number 0 to 6</entry>
+ <entry>Weekday as decimal number 0 to 6<sbr/>
+ 在一周中的天数，为十进制的 0 到 6</entry>
</row>
<row>
- <entry><screen>"0" => Sunday</screen></entry>
+ <entry><screen>"0" => Sunday 星期天</screen></entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>%W</screen></entry>
- <entry>Week number 00 to 53 where Monday is first day of week
1</entry>
+ <entry>Week number 00 to 53 where Monday is first day of week
1<sbr/>
+ 周数，从 00 到 53，其中星期一为一周的第一天。</entry>
</row>
<row>
- <entry><screen>date d(2005, Jan, 2); // Sunday
- // with format %W
+ <entry><screen>date d(2005, Jan, 2); // Sunday 星期天
+ // with format %W 格式化为%W
ss << d; // "00"
- d += day(1); // Monday
- ss << d; // "01" beginning of week 1</screen></entry>
+ d += day(1); // Monday 星期一
+ ss << d; // "01" beginning of week 1 第1周的开始</screen></entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>%x</screen></entry>
- <entry>Implementation defined date format from the
locale.</entry>
+ <entry>Implementation defined date format from the
locale.<sbr/>
+ 由实现的 locale 所定义的数据格式。</entry>
</row>
<row>
<entry><screen>date d(2005,Oct,31);
@@ -209,7 +236,8 @@
<row>
<entry valign="top" morerows="1"><screen>%y</screen></entry>
- <entry>Two digit year</entry>
+ <entry>Two digit year<sbr/>
+ 两位数的年份</entry>
</row>
<row>
<entry><screen>"05" => 2005</screen></entry>
@@ -217,7 +245,8 @@
<row>
<entry valign="top" morerows="1"><screen>%Y</screen></entry>
- <entry>Four digit year</entry>
+ <entry>Four digit year<sbr/>
+ 四位数的年份</entry>
</row>
<row>
<entry><screen>"2005"</screen></entry>
@@ -225,7 +254,8 @@
<row>
<entry valign="top"
morerows="1"><screen>%Y-%b-%d</screen></entry>
- <entry>Default date format</entry>
+ <entry>Default date format<sbr/>
+ 缺省日期格式</entry>
</row>
<row>
<entry><screen>"2005-Apr-01"</screen></entry>
@@ -233,7 +263,8 @@
<row>
<entry valign="top"
morerows="1"><screen>%Y%m%d</screen></entry>
- <entry>ISO format</entry>
+ <entry>ISO format<sbr/>
+ ISO 格式</entry>
</row>
<row>
<entry><screen>"20050401"</screen></entry>
@@ -241,7 +272,8 @@
<row>
<entry valign="top"
morerows="1"><screen>%Y-%m-%d</screen></entry>
- <entry>ISO extended format</entry>
+ <entry>ISO extended format<sbr/>
+ ISO 扩展格式</entry>
</row>
<row>
<entry><screen>"2005-04-01"</screen></entry>
@@ -253,22 +285,23 @@
<anchor id="date_time_io.time_format_flags" />
- Time Facet Format Flags
+ Time Facet Format Flags 时间Facet格式化标志
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Format Specifier</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Format Specifier 格式化符
</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>%- *!</screen></entry>
- <entry>Placeholder for the sign of a duration. Only displays
when the duration is negative.</entry>
+ <entry>Placeholder for the sign of a duration. Only displays
when the duration is negative.<sbr/>
+ 占位符，表示时间长度的符号。只在时间长度为负时显示。</entry>
</row>
<row>
<entry><screen>"-13:15:16"</screen></entry>
@@ -276,7 +309,8 @@
<row>
<entry valign="top" morerows="1"><screen>%+ *!</screen></entry>
- <entry>Placeholder for the sign of a duration. Always displays
for both positive and negative.</entry>
+ <entry>Placeholder for the sign of a duration. Always displays
for both positive and negative.<sbr/>
+ 占位符，表示时间长度的符号。不论正负都会显示。</entry>
</row>
<row>
<entry><screen>"+13:15:16"</screen></entry>
@@ -284,7 +318,8 @@
<row>
<entry valign="top" morerows="1"><screen>%f</screen></entry>
- <entry>Fractional seconds are always used, even when their
value is zero</entry>
+ <entry>Fractional seconds are always used, even when their
value is zero<sbr/>
+ 总是显示秒数的小数部分，即使小数部分为零。</entry>
</row>
<row>
<entry><screen>"13:15:16.000000"</screen></entry>
@@ -292,7 +327,8 @@
<row>
<entry valign="top" morerows="1"><screen>%F *</screen></entry>
- <entry>Fractional seconds are used only when their value is
not zero.</entry>
+ <entry>Fractional seconds are used only when their value is
not zero.<sbr/>
+ 仅在小数部分不为零时显示秒数的小数部分。</entry>
</row>
<row>
<entry><screen>"13:15:16"
@@ -302,7 +338,8 @@
<row>
<entry valign="top" morerows="1"><screen>%O</screen></entry>
- <entry>The number of hours in a time duration as a decimal
number (range 0 to max. representable duration); single digits are preceded
by a zero.</entry>
+ <entry>The number of hours in a time duration as a decimal
number (range 0 to max. representable duration); single digits are preceded
by a zero.<sbr/>
+ 时间长度中的小时数，以十进制数字表示(范围从 0 至可表示的最大时
间长度)；单个数字会被加上前导的零。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -310,7 +347,8 @@
<row>
<entry valign="top" morerows="1"><screen>%I !</screen></entry>
- <entry>The hour as a decimal number using a 12-hour
clock</entry>
+ <entry>The hour as a decimal number using a 12-hour clock<sbr/>
+ 小时数为十进制数，使用12小时的时钟。</entry>
</row>
<row>
<entry></entry>
@@ -318,7 +356,8 @@
<row>
<entry valign="top" morerows="1"><screen>%k !</screen></entry>
- <entry>The hour (24-hour clock) as a decimal number (range 0
to 23); single digits are preceded by a blank.</entry>
+ <entry>The hour (24-hour clock) as a decimal number (range 0
to 23); single digits are preceded by a blank.<sbr/>
+ 小时数(24小时时钟)以十进制数表示(从0到23)；单位数字前加空格。
</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -326,7 +365,8 @@
<row>
<entry valign="top" morerows="1"><screen>%l !</screen></entry>
- <entry>The hour (12-hour clock) as a decimal number (range 1
to 12); single digits are preceded by a blank.</entry>
+ <entry>The hour (12-hour clock) as a decimal number (range 1
to 12); single digits are preceded by a blank.<sbr/>
+ 小时数(12小时时钟)以十进制数表示(从1到12)；单位数字前加空格。
</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -334,7 +374,8 @@
<row>
<entry valign="top" morerows="1"><screen>%p !</screen></entry>
- <entry>Either `AM' or `PM' according to the given time value,
or the corresponding strings for the current locale.</entry>
+ <entry>Either `AM' or `PM' according to the given time value,
or the corresponding strings for the current locale.<sbr/>
+ 根据给定的时间值显示 `AM' 或 `PM'，或当前 locale 的相应字符串。
</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -342,7 +383,8 @@
<row>
<entry valign="top" morerows="1"><screen>%P !</screen></entry>
- <entry>Like %p but in lowercase: `am' or `pm' or a
corresponding string for the current locale.</entry>
+ <entry>Like %p but in lowercase: `am' or `pm' or a
corresponding string for the current locale.<sbr/>
+ 类似于 %p，但输出小写的 `am' 或 `pm' 或当前 locale 的相应字符
串。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -350,7 +392,8 @@
<row>
<entry valign="top" morerows="1"><screen>%r !</screen></entry>
- <entry>The time in a.m. or p.m. notation. In the POSIX locale
this is equivalent to `%I:%M:%S %p'</entry>
+ <entry>The time in a.m. or p.m. notation. In the POSIX locale
this is equivalent to `%I:%M:%S %p'<sbr/>
+ 时间带 a.m. 或 p.m. 符号。在 POSIX locale 中相当于
`%I:%M:%S %p'</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -358,7 +401,8 @@
<row>
<entry valign="top" morerows="1"><screen>%R !</screen></entry>
- <entry>The time in 24-hour notation (%H:%M)</entry>
+ <entry>The time in 24-hour notation (%H:%M)<sbr/>
+ 时间为24-小时格式(%H:%M)</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -366,7 +410,8 @@
<row>
<entry valign="top" morerows="1"><screen>%s *</screen></entry>
- <entry>Seconds with fractional seconds.</entry>
+ <entry>Seconds with fractional seconds.<sbr/>
+ 秒数带小数部分。</entry>
</row>
<row>
<entry><screen>"59.000000"</screen></entry>
@@ -374,7 +419,8 @@
<row>
<entry valign="top" morerows="1"><screen>%S</screen></entry>
- <entry>Seconds only</entry>
+ <entry>Seconds only<sbr/>
+ 只输出秒数</entry>
</row>
<row>
<entry><screen>"59"</screen></entry>
@@ -382,7 +428,8 @@
<row>
<entry valign="top" morerows="1"><screen>%T !</screen></entry>
- <entry>The time in 24-hour notation (%H:%M:%S)</entry>
+ <entry>The time in 24-hour notation (%H:%M:%S)<sbr/>
+ 时间为24-小时格式(%H:%M:%S)</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -390,39 +437,45 @@
<row>
<entry valign="top" morerows="1"><screen>%q</screen></entry>
- <entry>ISO time zone (output only). This flag is ignored when
using the time_facet with a ptime.</entry>
+ <entry>ISO time zone (output only). This flag is ignored when
using the time_facet with a ptime.<sbr/>
+ ISO 时区(仅用于输出)。在对 ptime 使用 time_facet 时忽略该标志。
</entry>
</row>
<row>
- <entry><screen>"-0700" // Mountain Standard
Time</screen></entry>
+ <entry><screen>"-0700" // Mountain Standard Time 山地标准时间
</screen></entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>%Q</screen></entry>
- <entry>ISO extended time zone (output only). This flag is
ignored when using the time_facet with a ptime.</entry>
+ <entry>ISO extended time zone (output only). This flag is
ignored when using the time_facet with a ptime.<sbr/>
+ ISO 扩展时区(仅用于输出)。在对 ptime 使用 time_facet 时忽略该标
志。</entry>
</row>
<row>
- <entry><screen>"-05:00" // Eastern Standard
Time</screen></entry>
+ <entry><screen>"-05:00" // Eastern Standard Time 东部标准时间
</screen></entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>%z *!</screen></entry>
- <entry>Abbreviated time zone (output only). This flag is
ignored when using the time_facet with a ptime.</entry>
+ <entry>Abbreviated time zone (output only). This flag is
ignored when using the time_facet with a ptime.<sbr/>
+ 时区缩写(仅用于输出)。在对 ptime 使用 time_facet 时忽略该标志。
</entry>
</row>
<row>
- <entry><screen>"MST" // Mountain Standard Time</screen></entry>
+ <entry><screen>"MST" // Mountain Standard Time 山地标准时间
</screen></entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>%Z *!</screen></entry>
- <entry>Full time zone name (output only). This flag is ignored
when using the time_facet with a ptime.</entry>
+ <entry>Full time zone name (output only). This flag is ignored
when using the time_facet with a ptime.<sbr/>
+ 时区全名(仅用于输出)。在对 ptime 使用 time_facet 时忽略该标志。
</entry>
</row>
<row>
- <entry><screen>"EDT" // Eastern Daylight Time</screen></entry>
+ <entry><screen>"EDT" // Eastern Daylight Time 东部标准时间
</screen></entry>
</row>
<row>
<entry valign="top" morerows="1"><screen>%ZP *</screen></entry>
- <entry>Posix time zone string (available to both input and
output). This flag is ignored when using the time_facet with a ptime. For
complete details on posix time zone strings, see <link
linkend="date_time.local_time.posix_time_zone">posix_time_zone
class</link>.</entry>
+ <entry>Posix time zone string (available to both input and
output). This flag is ignored when using the time_facet with a ptime. For
complete details on posix time zone strings, see <link
linkend="date_time.local_time.posix_time_zone">posix_time_zone
class</link>.<sbr/>
+ Posix 时区字符串(可用于输入和输出)。在对 ptime 使用 time_facet
时忽略该标志。有关 posix 时区字符串的完整细节，
+ 请见 <link
linkend="date_time.local_time.posix_time_zone">posix_time_zone 类</link>。
</entry>
</row>
<row>
<entry><screen>"EST-05EDT+01,M4.1.0/02:00,M10.5.0/02:00"</screen></entry>
@@ -430,7 +483,8 @@
<row>
<entry valign="top" morerows="1"><screen>%x %X</screen></entry>
- <entry>Implementation defined date/time format from the
locale.</entry>
+ <entry>Implementation defined date/time format from the
locale.<sbr/>
+ 取自于 locale 的实现定义的日期/时间格式。</entry>
</row>
<row>
<entry><screen>date d(2005,Oct,31);
@@ -448,7 +502,8 @@
<row>
<entry valign="top"
morerows="1"><screen>%Y%m%dT%H%M%S%F%q</screen></entry>
- <entry>ISO format</entry>
+ <entry>ISO format<sbr/>
+ ISO 格式。</entry>
</row>
<row>
<entry><screen>"20051015T131211-0700"
@@ -458,7 +513,8 @@
<row>
<entry valign="top"
morerows="1"><screen>%Y-%m-%d %H:%M:%S%F%Q</screen></entry>
- <entry>Extended ISO format</entry>
+ <entry>Extended ISO format<sbr/>
+ 扩展 ISO 格式。</entry>
</row>
<row>
<entry><screen>"2005-10-15 13:12:11-07:00"</screen></entry>
@@ -466,7 +522,8 @@
<row>
<entry valign="top"
morerows="1"><screen>%Y-%b-%d %H:%M:%S%F %z</screen></entry>
- <entry>Default format used when outputting ptime and
local_date_time.</entry>
+ <entry>Default format used when outputting ptime and
local_date_time.<sbr/>
+ 输出 ptime 和 local_date_time 时使用的缺省格式。</entry>
</row>
<row>
<entry><screen>"2005-Oct-15 13:12:11 MST"</screen></entry>
@@ -474,7 +531,8 @@
<row>
<entry valign="top"
morerows="1"><screen>%Y-%b-%d %H:%M:%S%F %ZP</screen></entry>
- <entry>Default format used when inputting ptime and
local_date_time.</entry>
+ <entry>Default format used when inputting ptime and
local_date_time.<sbr/>
+ 输入 ptime 和 local_date_time 时使用的缺省格式。</entry>
</row>
<row>
<entry><screen>"2005-Oct-15 13:12:11 MST-07"</screen></entry>
@@ -482,7 +540,8 @@
<row>
<entry valign="top"
morerows="1"><screen>%-%H:%M:%S%F !</screen></entry>
- <entry>Default time_duration format for output. Sign will only
be displayed for negative durations.</entry>
+ <entry>Default time_duration format for output. Sign will only
be displayed for negative durations.<sbr/>
+ 用于输出的缺省 time_duration 格式。仅当时间长度为负时显示符号。
</entry>
</row>
<row>
<entry><screen>"-13:14:15.003400"</screen></entry>
@@ -490,7 +549,8 @@
<row>
<entry valign="top"
morerows="1"><screen>%H:%M:%S%F</screen></entry>
- <entry>Default time_duration format for input.</entry>
+ <entry>Default time_duration format for input.<sbr/>
+ 用于输入的缺省 time_duration 格式。</entry>
</row>
<row>
<entry><screen>"13:14:15.003400"</screen></entry>
@@ -500,6 +560,8 @@
</tgroup>
</informaltable>
</para>
- <para>* Signifies flags that have a behavior unique to
<code>date_time</code>.</para>
- <para>! Signifies flags that currently do not work for input.</para>
+ <para>* Signifies flags that have a behavior unique to
<code>date_time</code>.<sbr/>
+ * 表示该标志只用于 date_time.</para>
+ <para>! Signifies flags that currently do not work for input.<sbr/>
+ ! 表示该标志不可用于输入。</para>
</section>
=======================================
--- /trunk/libs/date_time/xmldoc/gregorian.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/gregorian.xml Wed Jan 6 17:26:22 2010
@@ -9,57 +9,78 @@
<section id="date_time.gregorian"
xmlns:xi="http://www.w3.org/2001/XInclude";>
- <title>Gregorian</title>
- <bridgehead renderas="sect2">Gregorian Date System</bridgehead>
+ <title>Gregorian 格里历</title>
+ <bridgehead renderas="sect2">Gregorian Date System 格里历日期系统
</bridgehead>
<para>
- <link linkend="greg_intro">Introduction</link> --
- <link linkend="greg_ex">Usage Examples</link>
+ <link linkend="greg_intro">Introduction 简介</link> --
+ <link linkend="greg_ex">Usage Examples 用例</link>
</para>
<anchor id="greg_intro" />
- <bridgehead renderas="sect3">Introduction</bridgehead>
- <para>The gregorian date system provides a date programming system based
the Gregorian Calendar. The first introduction of the Gregorian calendar
was in 1582 to fix an error in the Julian Calendar. However, many local
jurisdictions did not adopt this change until much later. Thus there is
potential confusion with historical dates.
+ <bridgehead renderas="sect3">Introduction 简介</bridgehead>
+ <para>The gregorian date system provides a date programming system based
the Gregorian Calendar. The first introduction of the Gregorian calendar
was in 1582 to fix an error in the Julian Calendar. However, many local
jurisdictions did not adopt this change until much later. Thus there is
potential confusion with historical dates. <sbr/>
+ 格里历日期系统提供了基于格里历的日期编程系统。格里历的第一次引入是在
1582年，它修正了罗马儒略历的一个错误。
+ 不过，许多地区直到很后才采用这种修正。所以在历史日期上可能存在一些混乱。
</para>
- <para>The implemented calendar is a "proleptic Gregorian calendar" which
extends dates back prior to the Gregorian Calendar's first adoption in
1582. The current implementation supports dates in the range 1400-Jan-01 to
9999-Dec-31. Many references will represent dates prior to 1582 using the
Julian Calendar, so caution is in order if accurate calculations are
required on historic dates. See <ulink
url="http://emr.cs.iit.edu/home/reingold/calendar-book/second-edition";>Calendrical
Calculations</ulink> by Reingold & Dershowitz for more details. Date
information from Calendrical Calculations has been used to cross-test the
correctness of the Gregorian calendar implementation.
+ <para>The implemented calendar is a "proleptic Gregorian calendar" which
extends dates back prior to the Gregorian Calendar's first adoption in
1582. The current implementation supports dates in the range 1400-Jan-01 to
9999-Dec-31. Many references will represent dates prior to 1582 using the
Julian Calendar, so caution is in order if accurate calculations are
required on historic dates. See <ulink
url="http://emr.cs.iit.edu/home/reingold/calendar-book/second-edition";>Calendrical
Calculations</ulink> by Reingold & Dershowitz for more details. Date
information from Calendrical Calculations has been used to cross-test the
correctness of the Gregorian calendar implementation. <sbr/>
+ 我们实现的日历是一种"预想的格里历"，即将格里历推广至1582年首次采用格里历
之前的时间。
+ 当前的实现支持从 1400-Jan-01 到 9999-Dec-31 的日期。有很多被引用的1582年
以前的日期是采用罗马儒略历的，
+ 所以如果要求对历史日期进行准确的计算，就必须要小心。更多细节请参见
Reingold & Dershowitz 所写的
+ <ulink
url="http://emr.cs.iit.edu/home/reingold/calendar-book/second-edition";>日历
计算</ulink> 一书。
+ 这本书中的日期信息常被用于对格里历实现的正确性进行交叉测试。
</para>
- <para>All types for the gregorian system are found in namespace
boost::gregorian. The library supports a convenience header
boost/date_time/gregorian/gregorian_types.hpp that will include all the
classes of the library with no input/output dependency. Another header
boost/date_time/gregorian/gregorian.hpp will include the types and the
input/output code.
+ <para>All types for the gregorian system are found in namespace
boost::gregorian. The library supports a convenience header
boost/date_time/gregorian/gregorian_types.hpp that will include all the
classes of the library with no input/output dependency. Another header
boost/date_time/gregorian/gregorian.hpp will include the types and the
input/output code. <sbr/>
+ 格里历系统的所有类型位于名字空间 boost::gregorian. 本库提供一个方便的头文
件 boost/date_time/gregorian/gregorian_types.hpp，
+ 它包含了本库所有类，但不带输入/输出。另一个头文件
boost/date_time/gregorian/gregorian.hpp 则包含所有类型以及输入/输出代码。
</para>
- <para>The class <link
linkend="date_time.gregorian.date_class">boost::gregorian::date</link> is
the primary temporal type for users. If you are interested in learning
about writing programs that do specialized date calculations such as
finding the "first sunday in april" see the date <link
linkend="date_time.gregorian.date_algorithms">generators and algorithms
page</link>.
+ <para>The class <link
linkend="date_time.gregorian.date_class">boost::gregorian::date</link> is
the primary temporal type for users. If you are interested in learning
about writing programs that do specialized date calculations such as
finding the "first sunday in april" see the date <link
linkend="date_time.gregorian.date_algorithms">generators and algorithms
page</link>. <sbr/>
+ 类 <link
linkend="date_time.gregorian.date_class">boost::gregorian::date</link> 是用
户使用的主要时间类型。
+ 如果你想学习编写一个进行特定日期计算的程序，如查找"四月第一个星期天"，请
参见
+ <link linkend="date_time.gregorian.date_algorithms">日期生成器与算法
</link>。
</para>
<anchor id="greg_ex" />
- <bridgehead renderas="sect3">Usage Examples</bridgehead>
+ <bridgehead renderas="sect3">Usage Examples 用例</bridgehead>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry>Example</entry>
- <entry>Description</entry>
+ <entry>Example 例子</entry>
+ <entry>Description 说明</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"><literallayout>
-<link linkend="date_time.examples.days_alive">Days Alive</link>
-<link linkend="date_time.examples.days_between_new_year">Days Between New
Years</link></literallayout></entry>
- <entry>Simple date arithmetic. Retrieve current day from
clock.</entry>
+<link linkend="date_time.examples.days_alive">Days Alive 已生活的日子
</link>
+<link linkend="date_time.examples.days_between_new_year">Days Between New
Years 距离新年的日子</link></literallayout></entry>
+ <entry>Simple date arithmetic. Retrieve current day from
clock.<sbr/>
+ 简单的日期算术。从时钟取出当天日期。</entry>
</row>
<row>
- <entry valign="top"><literallayout><link
linkend="date_time.examples.dates_as_strings">Dates as
strings</link></literallayout></entry>
- <entry>Simple parsing and formatting of dates from/to
strings</entry>
+ <entry valign="top"><literallayout><link
linkend="date_time.examples.dates_as_strings">Dates as strings<sbr/>
+ 字符串表示的日期</link></literallayout></entry>
+ <entry>Simple parsing and formatting of dates from/to strings<sbr/>
+ 对日期字符串进行简单分析，以及将日期格式化为字符串</entry>
</row>
<row>
- <entry valign="top"><literallayout><link
linkend="date_time.examples.date_period_calc">Date Period
Calculations</link></literallayout></entry>
- <entry>See if a date is in a set of date periods (eg: is it a
holiday/weekend)</entry>
+ <entry valign="top"><literallayout><link
linkend="date_time.examples.date_period_calc">Date Period Calculations<sbr/>
+ 日期段计算</link></literallayout></entry>
+ <entry>See if a date is in a set of date periods (eg: is it a
holiday/weekend)<sbr/>
+ 检查某个日期是否在一组日期段中(如：某天是否假日/周末)</entry>
</row>
<row>
- <entry valign="top"><literallayout><link
linkend="date_time.examples.print_month">Print a
month</link></literallayout></entry>
- <entry>Small utility program which prints out all the days in a month
from command line. Need to know if 1999-Jan-1 was a Friday or a Saturday?
This program shows how to do it.</entry>
+ <entry valign="top"><literallayout><link
linkend="date_time.examples.print_month">Print a month<sbr/>
+ 打印月份</link></literallayout></entry>
+ <entry>Small utility program which prints out all the days in a month
from command line. Need to know if 1999-Jan-1 was a Friday or a Saturday?
This program shows how to do it.<sbr/>
+ 一个小工具程序，从命令行打印出某月的所有天。想知道 1999-Jan-1 是星
期五还是星期六？这个程序可以示范怎么做。</entry>
</row>
<row>
- <entry valign="top"><literallayout><link
linkend="date_time.examples.print_holidays">Print
Holidays</link></literallayout></entry>
- <entry>Uses date generators to convert abstract specification into
concrete set of dates.</entry>
+ <entry valign="top"><literallayout><link
linkend="date_time.examples.print_holidays">Print Holidays<sbr/>
+ 打印假日</link></literallayout></entry>
+ <entry>Uses date generators to convert abstract specification into
concrete set of dates.<sbr/>
+ 使用日期生成器将抽象描述转换为具体的日期集。</entry>
</row>
</tbody>
</tgroup>
=======================================
--- /trunk/libs/date_time/xmldoc/gregorian_calendar.xml Mon Dec 28 23:05:14
2009
+++ /trunk/libs/date_time/xmldoc/gregorian_calendar.xml Wed Jan 6 17:26:22
2010
@@ -8,49 +8,55 @@
-->
<section id="date_time.gregorian.gregorian_calendar">
- <title>Gregorian Calendar</title>
-
- <link linkend="gregcal_intro">Introduction</link> --
- <link linkend="gregcal_header">Header</link> --
- <link linkend="gregcal_functions">Functions</link>
+ <title>Gregorian Calendar 格里历</title>
+
+ <link linkend="gregcal_intro">Introduction 简介</link> --
+ <link linkend="gregcal_header">Header 头文件</link> --
+ <link linkend="gregcal_functions">Functions 函数</link>
<anchor id="gregcal_intro" />
- <bridgehead renderas="sect3">Introduction</bridgehead>
+ <bridgehead renderas="sect3">Introduction 简介</bridgehead>
<para>
- The class boost::gregorian::gregorian_calendar implements the
functions necessary to create the gregorian date system. It converts to the
year-month-day form of a date to a day number representation and back.
+ The class boost::gregorian::gregorian_calendar implements the
functions necessary to create the gregorian date system. It converts to the
year-month-day form of a date to a day number representation and back.
<sbr/>
+ 类 boost::gregorian::gregorian_calendar 实现了创建格里历日期系统所需的
函数。
+ 包括将日期的年-月-日格式转换为天数表示法以及相反的转换。
</para>
<para>
- For most purposes this class is simply accessed by <link
linkend="date_time.gregorian.date_class">gregorian::date</link> and is not
used directly by the user. However, there are useful functions that might
be of use such as the end_of_month_day function.
+ For most purposes this class is simply accessed by <link
linkend="date_time.gregorian.date_class">gregorian::date</link> and is not
used directly by the user. However, there are useful functions that might
be of use such as the end_of_month_day function. <sbr/>
+ 对于多数用途，这个类只是被 <link
linkend="date_time.gregorian.date_class">gregorian::date</link>
+ 访问而不是由用户直接使用。不过，也有一些有用的函数可能被象
end_of_month_day 这样的函数使用。
</para>
<para>
- The <link linkend="date_time.examples.print_month">print month</link>
example demonstrates this.
+ The <link linkend="date_time.examples.print_month">print month</link>
example demonstrates this. <sbr/>
+ 例子 <link linkend="date_time.examples.print_month">打印月份</link> 示
范了以上功能。
</para>
<anchor id="gregcal_header" />
- <bridgehead renderas="sect3">Header</bridgehead>
+ <bridgehead renderas="sect3">Header 头文件</bridgehead>
<para>
- <programlisting>#include "boost/date_time/gregorian/gregorian.hpp"
//include all types plus i/o
+ <programlisting>#include "boost/date_time/gregorian/gregorian.hpp"
//include all types plus i/o 包含所有类型和i/o
or
-#include "boost/date_time/gregorian/gregorian_types.hpp" //no i/o just
types</programlisting>
+#include "boost/date_time/gregorian/gregorian_types.hpp" //no i/o just
types 只有类型没有i/o</programlisting>
</para>
<anchor id="gregcal_functions" />
- <bridgehead renderas="sect3">Functions</bridgehead>
+ <bridgehead renderas="sect3">Functions 函数</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>static short
day_of_week(ymd_type)</screen></entry>
- <entry>Return the day of the week (0==Sunday, 1==Monday, etc)</entry>
+ <entry>Return the day of the week (0==Sunday, 1==Monday, etc)<sbr/>
+ 返回星期几(0==星期天，1==星期一，等等)</entry>
</row>
<row>
<entry>See also <link
linkend="date_time.gregorian.date_class">gregorian::date</link>
day_of_week</entry>
@@ -58,7 +64,8 @@
<row>
<entry valign="top" morerows="1"><screen>static date_int_type
day_number(ymd_type)</screen></entry>
- <entry> Convert a ymd_type into a day number. The day number is an
absolute number of days since the epoch start.</entry>
+ <entry> Convert a ymd_type into a day number. The day number is an
absolute number of days since the epoch start.<sbr/>
+ 将 ymd_type 转换为天数。该天数是一个从 epoch 起计的绝对数字。</entry>
</row>
<row>
<entry></entry>
@@ -67,7 +74,8 @@
<row>
<entry valign="top" morerows="1"><screen>static short
end_of_month_day(year_type,
month_type)</screen></entry>
- <entry>Given a year and month determine the last day of the
month.</entry>
+ <entry>Given a year and month determine the last day of the
month.<sbr/>
+ 给定年份和月份，确定该月最后一天。</entry>
</row>
<row>
<entry></entry>
@@ -75,7 +83,8 @@
<row>
<entry valign="top" morerows="1"><screen>static ymd_type
from_day_number(date_int_type)</screen></entry>
- <entry> Convert a day number to a ymd struct.</entry>
+ <entry> Convert a day number to a ymd struct.<sbr/>
+ 将天数转换为 ymd 结构。</entry>
</row>
<row>
<entry></entry>
@@ -83,7 +92,8 @@
<row>
<entry valign="top" morerows="1"><screen>static bool
is_leap_year(year_type)</screen></entry>
- <entry>Returns true if specified year is a leap year.</entry>
+ <entry>Returns true if specified year is a leap year.<sbr/>
+ 返回 true 如果指定年份是闰年。</entry>
</row>
<row>
<entry><screen>gregorian_calendar::is_leap_year(2000)
=======================================
--- /trunk/libs/date_time/xmldoc/io_objects.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/io_objects.xml Wed Jan 6 17:26:22 2010
@@ -9,48 +9,61 @@
<section id="date_time.io_objects"
xmlns:xi="http://www.w3.org/2001/XInclude";>
- <title>Date Time Formatter/Parser Objects</title>
+ <title>Date Time Formatter/Parser Objects 日期时间格式化器/分析器对象
</title>
<!-- <using-namespace name="boost"/> -->
<using-namespace name="boost::date_time"/>
- <bridgehead renderas="sect2">Date Time Formatter/Parser
Objects</bridgehead>
-
- <link linkend="io_objects.periods">Periods</link> |
- <link linkend="io_objects.date_generators">Date Generators</link> |
- <link linkend="io_objects.special_values">Special Values</link> |
- <link linkend="io_objects.format_date_parser">Format Date Parser</link>
+ <bridgehead renderas="sect2">Date Time Formatter/Parser Objects 日期时间
格式化器/分析器对象</bridgehead>
+
+ <link linkend="io_objects.periods">Periods 时间段</link> |
+ <link linkend="io_objects.date_generators">Date Generators 日期生成器
</link> |
+ <link linkend="io_objects.special_values">Special Values 特殊值</link> |
+ <link linkend="io_objects.format_date_parser">Format Date Parser 格式化日
期分析器 </link>
<anchor id="io_objects.periods" />
- <bridgehead renderas="sect3">Periods</bridgehead>
- <para>The period_formatter and period_parser provide a uniform interface
for the input and output of date_periods, time_periods, and in a future
release, local_date_time_periods. The user has control over the delimiters,
formats of the date/time components, and the form the period takes. The
format of the date/time components is controlled via the date_time input
and output facets.</para>
-
- <bridgehead renderas="sect4">Period Form</bridgehead>
- <para>Periods are constructed with open ranged parameters. The first
value is the starting point, and is included in the period. The end value
is not included but immediately follows the last value: [begin/end).
However, a period can be streamed as either an open range or a closed
range.</para>
- <screen>[2003-Jan-01/2003-Dec-31] <-- period holding 365 days
-[2003-Jan-01/2004-Jan-01) <-- period holding 365 days</screen>
-
- <bridgehead renderas="sect4">Delimiters</bridgehead>
- <para>There are four delimiters. The default values are<simplelist
type="vert" columns="1">
- <member>"\" - separator</member>
- <member>"[" - start delimiter</member>
- <member>")" - open range end delimiter</member>
- <member>"]" - closed range end delimiter</member>
- </simplelist>A user can provide a custom set of delimiters. Custom
delimiters may contain spaces.</para>
-
- <bridgehead renderas="sect4">Customization</bridgehead>
- <para>The period form and delimiters can be set as construction
parameters or by means of accessor functions. A custom period
parser/formatter can then be used as a construction parameter to a new
facet, or can be set in an existing facet via an accessor function.</para>
+ <bridgehead renderas="sect3">Periods 时间段</bridgehead>
+ <para>The period_formatter and period_parser provide a uniform interface
for the input and output of date_periods, time_periods, and in a future
release, local_date_time_periods. The user has control over the delimiters,
formats of the date/time components, and the form the period takes. The
format of the date/time components is controlled via the date_time input
and output facets.<sbr/>
+ period_formatter 和 period_parser 为 date_periods, time_periods, 以及未来
版本中的 local_date_time_periods
+ 的输入和输出提供了统一的接口。用户可以控制所用的定界符、日期/时间组件的格
式，以及时间段的表示形式。
+ 日期/时间组件的格式通过 date_time 的输入输出 facets 来控制。
+
+</para>
+
+ <bridgehead renderas="sect4">Period Form 时间段的表示形式</bridgehead>
+ <para>Periods are constructed with open ranged parameters. The first
value is the starting point, and is included in the period. The end value
is not included but immediately follows the last value: [begin/end).
However, a period can be streamed as either an open range or a closed
range.<sbr/>
+ 时间段是以开区间参数来构造的。first 值为开始的时间点，并且包含在时间段
中。end 值则不包含在时间段中，
+ 它紧随在 last 值之后：[begin/end). 不过，时间段既可以作为开区间也可以作为
闭区间的方式来进行流操作。</para>
+ <screen>[2003-Jan-01/2003-Dec-31] <-- period holding 365 days 包含
365天的时间段
+[2003-Jan-01/2004-Jan-01) <-- period holding 365 days 包含365天的时间段
</screen>
+
+ <bridgehead renderas="sect4">Delimiters 定界符</bridgehead>
+ <para>There are four delimiters. The default values are<sbr/>
+ 共有四个定界符。它们的缺省值是：<simplelist type="vert" columns="1">
+ <member>"\" - separator 分隔符</member>
+ <member>"[" - start delimiter 开始定界符</member>
+ <member>")" - open range end delimiter 开区间的结束定界符</member>
+ <member>"]" - closed range end delimiter 闭区间的结束定界符</member>
+ </simplelist>A user can provide a custom set of delimiters. Custom
delimiters may contain spaces.<sbr/>
+ 用户可以提供定制的定界符。用户定制的定界符可以包含空格。</para>
+
+ <bridgehead renderas="sect4">Customization 定制</bridgehead>
+ <para>The period form and delimiters can be set as construction
parameters or by means of accessor functions. A custom period
parser/formatter can then be used as a construction parameter to a new
facet, or can be set in an existing facet via an accessor function.<sbr/>
+ 时间段的形式和定界符可以通过构造参数或访问器函数来设置。而定制的时间段分
析器/格式化器则可以作为构造参数来构造新的 facet,
+ 或者通过访问器函数设置到已有的 facet 中。</para>
- <bridgehead renderas="sect4">Period Formatter/Parser
Reference</bridgehead>
- The complete class reference can be found here: <classname
alt="boost::date_time::period_formatter">Period Formatter Doxygen
Reference</classname> and here: <classname
alt="boost::date_time::period_parser">Period Parser Doxygen
Reference</classname>
+ <bridgehead renderas="sect4">Period Formatter/Parser Reference 时间段格式
化器/分析器的参考</bridgehead>
+ The complete class reference can be found here: <classname
alt="boost::date_time::period_formatter">Period Formatter Doxygen
Reference</classname> and here: <classname
alt="boost::date_time::period_parser">Period Parser Doxygen
Reference</classname><sbr/>
+ 完整的类参考请见：<classname alt="boost::date_time::period_formatter">时
间段格式化器Doxygen参考</classname> 和
+ <classname alt="boost::date_time::period_parser">时间段分析器Doxygen参考
</classname>
<para>
- <bridgehead renderas="sect4">Period Formatter Construction</bridgehead>
+ <bridgehead renderas="sect4">Period Formatter Construction 时间段格式化
器构造</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
</thead>
<tbody>
@@ -62,27 +75,33 @@
char_type*
char_type*
char_type*</screen></entry>
- <entry>NOTE: All five construction parameters have default
values so this constructor also doubles as the default constructor. The
<code>range_display_options</code> is a public type enum of the
<code>period_formatter</code> class. The possible choices are AS_OPEN_RANGE
or AS_CLOSED_RANGE. The closed range is the default. A period has three
significant points: the begining, the last, and the end. A closed range
period takes the form [begin,end), where an open range period takes the
form [begin,last]. The four char_type* parameters are: the period
separator, the start delimiter, the open range end delimiter, and the
closed range end delimiter.</entry>
+ <entry>NOTE: All five construction parameters have default
values so this constructor also doubles as the default constructor. The
<code>range_display_options</code> is a public type enum of the
<code>period_formatter</code> class. The possible choices are AS_OPEN_RANGE
or AS_CLOSED_RANGE. The closed range is the default. A period has three
significant points: the begining, the last, and the end. A closed range
period takes the form [begin,end), where an open range period takes the
form [begin,last]. The four char_type* parameters are: the period
separator, the start delimiter, the open range end delimiter, and the
closed range end delimiter.<sbr/>
+ 注：所有五个构造函数都具有缺省值，所以这个构造函数也可用为缺省
构造函数。<code>range_display_options</code> 是
+ <code>period_formatter</code> 类的一个公有枚举类型。可能的选择
为 AS_OPEN_RANGE 或 AS_CLOSED_RANGE.
+ 缺省值是闭区间。时间段有三个主要的时间点：begining, last, 和
end. 闭区间时间段格式为 [begin,end),
+ 而开区间时间格式为 [begin,last]. 四个 char_type* 参数分别是：时
间段分隔符，开始定界符，
+ 开区间结束定界符，和闭区间结束定界符。</entry>
</row>
</tbody>
</tgroup>
</informaltable>
- <bridgehead renderas="sect4">Period Formatter Accessors</bridgehead>
+ <bridgehead renderas="sect4">Period Formatter Accessors 时间段格式化器
访问器</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>range_display_options
range_option()</screen></entry>
- <entry>Returns the current setting for the range display
(either AS_OPEN_RANGE or AS_CLOSED_RANGE).</entry>
+ <entry>Returns the current setting for the range display
(either AS_OPEN_RANGE or AS_CLOSED_RANGE).<sbr/>
+ 返回区间显示的当前设置(AS_OPEN_RANGE 或
AS_CLOSED_RANGE).</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -92,7 +111,8 @@
<entry valign="top" morerows="1"><screen>void range_option(...)
Parameter:
range_display_options</screen></entry>
- <entry>Sets the option for range display (either AS_OPEN_RANGE
or AS_CLOSED_RANGE).</entry>
+ <entry>Sets the option for range display (either AS_OPEN_RANGE
or AS_CLOSED_RANGE).<sbr/>
+ 设置区间显示选项(AS_OPEN_RANGE 或 AS_CLOSED_RANGE).</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -105,7 +125,8 @@
string_type
string_type
string_type</screen></entry>
- <entry>Set new delimiter strings in the formatter.</entry>
+ <entry>Set new delimiter strings in the formatter.<sbr/>
+ 设置格式化器中的定界符字符串。</entry>
</row>
<row>
<entry><screen>string beg("->| ");
@@ -122,7 +143,8 @@
OutItrT
Parameter:
OutItrT</screen></entry>
- <entry>Puts the start delimiter into the stream at position
pointed to by OutItrT parameter.</entry>
+ <entry>Puts the start delimiter into the stream at position
pointed to by OutItrT parameter.<sbr/>
+ 将开始定界符放入到流中由 OutItrT 参数所指的位置。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -134,7 +156,8 @@
OutItrT
Parameter:
OutItrT</screen></entry>
- <entry>Puts the separator into the stream at position pointed
to by OutItrT parameter.</entry>
+ <entry>Puts the separator into the stream at position pointed
to by OutItrT parameter.<sbr/>
+ 将分隔符放入到流中由 OutItrT 参数所指的位置。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -146,7 +169,8 @@
OutItrT
Parameter:
OutItrT</screen></entry>
- <entry>Puts the end delimiter into the stream at position
pointed to by OutItrT parameter.</entry>
+ <entry>Puts the end delimiter into the stream at position
pointed to by OutItrT parameter.<sbr/>
+ 将结束定界符放入到流中由 OutItrT 参数所指的位置。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -160,7 +184,8 @@
char_type
period_type
facet_type</screen></entry>
- <entry>Puts a period into the stream using the set values for
delimiters, separator, and range display. The facet parameter is used to
put the date (or time) objects of the period.</entry>
+ <entry>Puts a period into the stream using the set values for
delimiters, separator, and range display. The facet parameter is used to
put the date (or time) objects of the period.<sbr/>
+ 将一个时间段放入流中，使用设置的定界符，分隔符和区间表示法。参
数 facet 用于输出时间段中的日期(或时间)。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -171,13 +196,13 @@
</informaltable>
</para>
<para>
- <bridgehead renderas="sect4">Period Parser Construction</bridgehead>
+ <bridgehead renderas="sect4">Period Parser Construction 时间段分析器构
造</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
</thead>
<tbody>
@@ -189,31 +214,38 @@
char_type*
char_type*
char_type*</screen></entry>
- <entry>NOTE: All five construction parameters have default
values so this constructor also doubles as the default constructor. The
<code>period_range_option</code> is a public type enum of the
<code>period_parser</code> class. The possible choices are AS_OPEN_RANGE or
AS_CLOSED_RANGE. The closed range is the default. A period has three
significant points: the begining, the last, and the end. A closed range
period takes the form [begin,end), where an open range period takes the
form [begin,last]. The four char_type* parameters are: the period
separator, the start delimiter, the open range end delimiter, and the
closed range end delimiter.</entry>
+ <entry>NOTE: All five construction parameters have default
values so this constructor also doubles as the default constructor. The
<code>period_range_option</code> is a public type enum of the
<code>period_parser</code> class. The possible choices are AS_OPEN_RANGE or
AS_CLOSED_RANGE. The closed range is the default. A period has three
significant points: the begining, the last, and the end. A closed range
period takes the form [begin,end), where an open range period takes the
form [begin,last]. The four char_type* parameters are: the period
separator, the start delimiter, the open range end delimiter, and the
closed range end delimiter.<sbr/>
+ 注：所有五个构造函数都具有缺省值，所以这个构造函数也可用为缺省
构造函数。<code>period_range_option</code> 是
+ <code>period_parser</code> 类的一个公有枚举类型。可能的选择为
AS_OPEN_RANGE 或 AS_CLOSED_RANGE.
+ 缺省值是闭区间。时间段有三个主要的时间点：begining, last, 和
end. 闭区间时间段格式为 [begin,end),
+ 而开区间时间格式为 [begin,last]. 四个 char_type* 参数分别是：时
间段分隔符，开始定界符，
+ 开区间结束定界符，和闭区间结束定界符。</entry>
</row>
<row>
<entry
valign="top"><screen>period_parser(period_parser)</screen></entry>
- <entry>Copy constructor</entry>
+ <entry>Copy constructor<sbr/>
+ 复制构造函数</entry>
</row>
</tbody>
</tgroup>
</informaltable>
- <bridgehead renderas="sect4">Period Parser Accessors</bridgehead>
+ <bridgehead renderas="sect4">Period Parser Accessors 时间段分析器访问器
</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>period_range_option
range_option()</screen></entry>
- <entry>Returns the current setting for the period range
(either AS_OPEN_RANGE or AS_CLOSED_RANGE).</entry>
+ <entry>Returns the current setting for the period range
(either AS_OPEN_RANGE or AS_CLOSED_RANGE).<sbr/>
+ 返回时间段区间表示的当前设置(AS_OPEN_RANGE 或
AS_CLOSED_RANGE).</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -223,7 +255,8 @@
<entry valign="top" morerows="1"><screen>void range_option(...)
Parameter:
period_range_option </screen></entry>
- <entry>Sets the option for period range (either AS_OPEN_RANGE
or AS_CLOSED_RANGE).</entry>
+ <entry>Sets the option for period range (either AS_OPEN_RANGE
or AS_CLOSED_RANGE).<sbr/>
+ 设置时间段区间的表示选项(AS_OPEN_RANGE 或
AS_CLOSED_RANGE).</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -236,7 +269,8 @@
string_type
string_type
string_type</screen></entry>
- <entry>Set new delimiter strings in the parser.</entry>
+ <entry>Set new delimiter strings in the parser.<sbr/>
+ 为分析器设置新的定界符字符串。</entry>
</row>
<row>
<entry><screen>string beg("->| ");
@@ -249,7 +283,8 @@
<row>
<entry valign="top" morerows="1"><screen>collection_type
delimiter_strings()</screen></entry>
- <entry>Returns the set of delimiter strings currently held in
the parser.</entry>
+ <entry>Returns the set of delimiter strings currently held in
the parser.<sbr/>
+ 返回分析器中当前的定界符字符串。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -264,7 +299,9 @@
period_type
duration_type
facet_type</screen></entry>
-<entry>Parses a period from the stream. The iterator parameters point to
the begining and end of the stream. The duration_type is relevant to the
period type, for example: A <code>date_period</code> would use
<code>days</code> as a duration_type. The period will be parsed according
to the formats and strings found in the facet parameter.</entry>
+<entry>Parses a period from the stream. The iterator parameters point to
the begining and end of the stream. The duration_type is relevant to the
period type, for example: A <code>date_period</code> would use
<code>days</code> as a duration_type. The period will be parsed according
to the formats and strings found in the facet parameter.<sbr/>
+从流中分析出一个时间段。两个迭代器参数分别指向流的开始位置和结束位置。
duration_type 与 period 的类型相关，例如：
+<code>date_period</code> 以 <code>days</code> 作为 duration_type. 根据
facet 参数中的格式和字符串来分析得取时间段。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -278,11 +315,16 @@
<para>_____________________________________________________</para>
<anchor id="io_objects.date_generators" />
- <bridgehead renderas="sect3">Date Generators</bridgehead>
- <para>The date_generator formatter and parser provide flexibility by
allowing the user to use custom "phrase elements". These phrase elements
are the "in-between" words in the date_generators. For example, in the
date_generator "Second Monday of March", "Second" and "of" are the phrase
elements, where "Monday" and "March" are the date elements. Customization
of the date elements is done with the facet. The order of the date and
phrase elements cannot be changed. When parsing, all elements of the
date_generator phrase must parse correctly or an ios_base::failure
exception will be thrown.</para>
-
- <bridgehead renderas="sect4">Customization</bridgehead>
- <para>The default "phrase_strings" are:
+ <bridgehead renderas="sect3">Date Generators 日期生成器</bridgehead>
+ <para>The date_generator formatter and parser provide flexibility by
allowing the user to use custom "phrase elements". These phrase elements
are the "in-between" words in the date_generators. For example, in the
date_generator "Second Monday of March", "Second" and "of" are the phrase
elements, where "Monday" and "March" are the date elements. Customization
of the date elements is done with the facet. The order of the date and
phrase elements cannot be changed. When parsing, all elements of the
date_generator phrase must parse correctly or an ios_base::failure
exception will be thrown.<sbr/>
+ date_generator 格式化器和分析器提供了灵活性，允许用户使用定制的"短语元
素"。这些短语元素是 date_generators 中的"分隔"单词。
+ 例如，在 date_generator "Second Monday of March" 中，"Second" 和 "of" 都
是短语元素，而 "Monday" 和 "March" 就是日期元素。
+ 日期元素的定制由 facet 负责。日期元素和短语元素的顺序是不能改变的。在进行
分析时，date_generator 的所有元素必须都能正确分析，
+ 否则将抛出一个 ios_base::failure 异常。</para>
+
+ <bridgehead renderas="sect4">Customization 定制</bridgehead>
+ <para>The default "phrase_strings" are:<sbr/>
+ 缺省的 "phrase_strings" 为：
<simplelist type="horiz" columns="9">
<member>"first"</member>
<member>"second"</member>
@@ -294,29 +336,39 @@
<member>"after"</member>
<member>"of"</member>
</simplelist>
- A custom set of phrase_strings must maintain this order of occurance
(Ex: "1st", "2nd", "3rd", "4th", "5th", "last", "prior", "past", "in").</para>
- <para> Examples using default phrase_strings and default facet formats
for weekday & month: <screen>"first Tue of Mar"</screen>And using
custom phrase_strings: <screen>"1st Tue in Mar"</screen>
+ A custom set of phrase_strings must maintain this order of occurance
(Ex: "1st", "2nd", "3rd", "4th", "5th", "last", "prior", "past", "in").<sbr/>
+ 一组定制的 phrase_strings 必须保持以下顺序
(如："1st", "2nd", "3rd", "4th", "5th", "last", "prior", "past", "in")。
</para>
+ <para> Examples using default phrase_strings and default facet formats
for weekday & month: <sbr/>
+ 例如，使用缺省的 phrase_strings 以及缺省 facet 格式的 weekday &
month: <screen>"first Tue of Mar"</screen>And using custom phrase_strings:
<sbr/>
+ 而使用定制的 phrase_strings: <screen>"1st Tue in Mar"</screen>
</para>
- <para>The custom set of phrase elements can be set as construction
parameters or through an accessor function.A custom date_generator
parser/formatter can then be used as a construction parameter to a new
facet, or can be set in an existing facet via an accessor function.</para>
- <para>IMPORTANT NOTE: Prior to 1.33, partial_date was output as "1 Jan"
with a single *or* double digit number for the day. The new behavior is to
*always* place a double digit number for the day - "01 Jan".</para>
-
- <bridgehead renderas="sect4">Date Generator Reference</bridgehead>
- The complete class references can be found here: <classname
alt="boost::date_time::date_generator_formatter">Date Generator Formatter
Doxygen Reference</classname> and here: <classname
alt="boost::date_time::date_generator_parser">Date Generator Parser Doxygen
Reference</classname>
+ <para>The custom set of phrase elements can be set as construction
parameters or through an accessor function.A custom date_generator
parser/formatter can then be used as a construction parameter to a new
facet, or can be set in an existing facet via an accessor function.<sbr/>
+ 短语元素的定制可以在构造参数中设置，也可以通过访问器函数来设置。一个定制
的 date_generator 分析器/格式化器可以用作一个新的
+ facet 的构造参数，或者通过访问器函数设置到已有的 facet 中。</para>
+ <para>IMPORTANT NOTE: Prior to 1.33, partial_date was output as "1 Jan"
with a single *or* double digit number for the day. The new behavior is to
*always* place a double digit number for the day - "01 Jan".<sbr/>
+ 重要说明：在版本1.33以前，partial_date 的输出形如 "1 Jan"，其中日期是用一
位或两位数字来表示的。
+ 而新的版本中则总是以两位数字表示日期 - "01 Jan"。</para>
+
+ <bridgehead renderas="sect4">Date Generator Reference 日期生成器参考
</bridgehead>
+ The complete class references can be found here: <classname
alt="boost::date_time::date_generator_formatter">Date Generator Formatter
Doxygen Reference</classname> and here: <classname
alt="boost::date_time::date_generator_parser">Date Generator Parser Doxygen
Reference</classname><sbr/>
+ 完整的类参考请见：<classname
alt="boost::date_time::date_generator_formatter">日期生成器格式化器Doxygen参
考</classname>
+ 和 <classname alt="boost::date_time::date_generator_parser">日期生成器分
析器Doxygen参考</classname>
<para>
- <bridgehead renderas="sect4">Date Generator Formatter
Construction</bridgehead>
+ <bridgehead renderas="sect4">Date Generator Formatter Construction 日期
生成器的格式化器构造</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
</thead>
<tbody>
<row>
<entry
valign="top"><screen>date_generator_formatter()</screen></entry>
- <entry>Uses the default date generator elements.</entry>
+ <entry>Uses the default date generator elements.<sbr/>
+ 使用缺省的日期生成器元素。</entry>
</row>
<row>
<entry valign="top"><screen>date_generator_formatter(...)
@@ -330,22 +382,23 @@
string_type before_element
string_type after_element
string_type of_element</screen></entry>
- <entry>Constructs a date_generator_formatter using the given
element strings.</entry>
+ <entry>Constructs a date_generator_formatter using the given
element strings.<sbr/>
+ 使用给定的元素字符串构造一个 date_generator_formatter.</entry>
</row>
</tbody>
</tgroup>
</informaltable>
- <bridgehead renderas="sect4">Date Generator Formatter
Accessors</bridgehead>
+ <bridgehead renderas="sect4">Date Generator Formatter Accessors 日期生
成器的格式化器访问器</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
@@ -354,16 +407,17 @@
Parameters:
collection_type
phrase_elements</screen></entry>
- <entry>Replace the current phrase elements with a collection
of new ones. The <code>phrase_elements</code> parameter is an enum that
indicates what the first element in the new collection is (defaults to
first).</entry>
+ <entry>Replace the current phrase elements with a collection
of new ones. The <code>phrase_elements</code> parameter is an enum that
indicates what the first element in the new collection is (defaults to
first).<sbr/>
+ 替换当前的短语元素。参数 <code>phrase_elements</code> 为枚举
值，表示新的短语集中的第一个元素(缺省为 first)。</entry>
</row>
<row>
- <entry><screen>// col is a collection holding
+ <entry><screen>// col is a collection holding col中存有
// "final", "prior", "following",
// and "in"
typedef date_generator_formatter dgf;
dgf formatter();
formatter.elements(col, dgf::last);
-// complete elements in dgf are now:
+// complete elements in dgf are now: 现在 dgf 的完整元素为：
"first", "second", "third",
"fourth", "fifth", "final",
"prior", "following", and "in"</screen></entry>
@@ -379,7 +433,8 @@
char_type fill
partial_date
facet_type</screen></entry>
- <entry>A put function for partial_date. This is a templated
function that takes a facet_type as a parameter.</entry>
+ <entry>A put function for partial_date. This is a templated
function that takes a facet_type as a parameter.<sbr/>
+ 用于 partial_date 的 put 函数。这是一个以 facet_type 为参数的模
板函数。</entry>
</row>
<row>
<entry>Put a partial_date => "dd Month".</entry>
@@ -395,7 +450,8 @@
char_type fill
nth_kday_type
facet_type</screen></entry>
- <entry>A put function for nth_kday_type. This is a templated
function that takes a facet_type as a parameter.</entry>
+ <entry>A put function for nth_kday_type. This is a templated
function that takes a facet_type as a parameter.<sbr/>
+ 用于 nth_kday_type 的 put 函数。这是一个以 facet_type 为参数的
模板函数。</entry>
</row>
<row>
<entry>Put an nth_day_of_the_week_in_month => "nth weekday of
month".</entry>
@@ -411,7 +467,8 @@
char_type fill
first_kday_type
facet_type</screen></entry>
- <entry>A put function for first_kday_type. This is a templated
function that takes a facet_type as a parameter.</entry>
+ <entry>A put function for first_kday_type. This is a templated
function that takes a facet_type as a parameter.<sbr/>
+ 用于 first_kday_type 的 put 函数。这是一个以 facet_type 为参数
的模板函数。</entry>
</row>
<row>
<entry>Put a first_day_of_the_week_in_month => "first weekday
of month".</entry>
@@ -427,7 +484,8 @@
char_type fill
last_kday_type
facet_type</screen></entry>
- <entry>A put function for last_kday_type. This is a templated
function that takes a facet_type as a parameter.</entry>
+ <entry>A put function for last_kday_type. This is a templated
function that takes a facet_type as a parameter.<sbr/>
+ 用于 last_kday_type 的 put 函数。这是一个以 facet_type 为参数的
模板函数。</entry>
</row>
<row>
<entry>Put a last_day_of_the_week_in_month => "last weekday of
month".</entry>
@@ -443,7 +501,8 @@
char_type fill
kday_before_type
facet_type</screen></entry>
- <entry>A put function for kday_before_type. This is a
templated function that takes a facet_type as a parameter.</entry>
+ <entry>A put function for kday_before_type. This is a
templated function that takes a facet_type as a parameter.<sbr/>
+ 用于 kday_before_type 的 put 函数。这是一个以 facet_type 为参数
的模板函数。</entry>
</row>
<row>
<entry>Put a first_day_of_the_week_before => "weekday
before"</entry>
@@ -459,7 +518,8 @@
char_type fill
kday_after_type
facet_type</screen></entry>
- <entry>A put function for kday_after_type. This is a templated
function that takes a facet_type as a parameter.</entry>
+ <entry>A put function for kday_after_type. This is a templated
function that takes a facet_type as a parameter.<sbr/>
+ 用于 kday_after_type 的 put 函数。这是一个以 facet_type 为参数
的模板函数。</entry>
</row>
<row>
<entry>Put a first_day_of_the_week_after => "weekday
after".</entry>
@@ -470,25 +530,27 @@
</informaltable>
</para>
<para>
- <bridgehead renderas="sect4">Date Generator Parser
Construction</bridgehead>
+ <bridgehead renderas="sect4">Date Generator Parser Construction 日期生
成器的分析器构造</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
</thead>
<tbody>
<row>
<entry
valign="top"><screen>date_generator_parser()</screen></entry>
- <entry>Uses the default date generator elements.</entry>
+ <entry>Uses the default date generator elements.<sbr/>
+ 使用缺省的日期生成器元素。</entry>
</row>
<row>
<entry valign="top"><screen>date_generator_parser(...)
Parameter:
date_generator_parser</screen></entry>
- <entry>Copy Constructor</entry>
+ <entry>Copy Constructor<sbr/>
+ 复制构造函数。</entry>
</row>
<row>
<entry valign="top"><screen>date_generator_parser(...)
@@ -502,22 +564,23 @@
string_type before_element
string_type after_element
string_type of_element</screen></entry>
- <entry>Constructs a date_generator_parser using the given
element strings.</entry>
+ <entry>Constructs a date_generator_parser using the given
element strings.<sbr/>
+ 使用给定的元素字符串构造一个 date_generator_parser.</entry>
</row>
</tbody>
</tgroup>
</informaltable>
- <bridgehead renderas="sect4">Date Generator Parser
Accessors</bridgehead>
+ <bridgehead renderas="sect4">Date Generator Parser Accessors 日期生成器
的分析器访问器</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
@@ -525,7 +588,8 @@
<entry valign="top" morerows="1"><screen>void
element_strings(...)
Parameter:
collection_type</screen></entry>
- <entry>Replace the set of date generator element string with a
new set.</entry>
+ <entry>Replace the set of date generator element string with a
new set.<sbr/>
+ 为日期生成器替换一组新的元素字符串。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -543,7 +607,8 @@
string_type before
string_type after
string_type of</screen></entry>
- <entry>Replace the set of date generator elements with new
values.</entry>
+ <entry>Replace the set of date generator elements with new
values.<sbr/>
+ 为日期生成器元素替换一组新值。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -558,10 +623,12 @@
stream_itr_type str_end
ios_base
facet_type</screen></entry>
- <entry>A templated function that parses a date_generator from
the stream.</entry>
+ <entry>A templated function that parses a date_generator from
the stream.<sbr/>
+ 模板函数，从流中分析出一个 date_generator.</entry>
</row>
<row>
- <entry>Parses a partial_date => "dd Month".</entry>
+ <entry>Parses a partial_date => "dd Month".<sbr/>
+ 分析一个 partial_date => "dd Month".</entry>
</row>
<row>
@@ -573,10 +640,12 @@
stream_itr_type str_end
ios_base
facet_type</screen></entry>
- <entry>A templated function that parses a date_generator from
the stream.</entry>
+ <entry>A templated function that parses a date_generator from
the stream.<sbr/>
+ 模板函数，从流中分析出一个 date_generator.</entry>
</row>
<row>
- <entry>Parses an nth_day_of_the_week_in_month => "nth weekday
of month".</entry>
+ <entry>Parses an nth_day_of_the_week_in_month => "nth weekday
of month".<sbr/>
+ 分析一个 nth_day_of_the_week_in_month => "nth weekday of
month".</entry>
</row>
<row>
@@ -588,10 +657,12 @@
stream_itr_type str_end
ios_base
facet_type</screen></entry>
- <entry>A templated function that parses a date_generator from
the stream.</entry>
+ <entry>A templated function that parses a date_generator from
the stream.<sbr/>
+ 模板函数，从流中分析出一个 date_generator.</entry>
</row>
<row>
- <entry>Parses a first_day_of_the_week_in_month => "first
weekday of month".</entry>
+ <entry>Parses a first_day_of_the_week_in_month => "first
weekday of month".<sbr/>
+ 分析一个 first_day_of_the_week_in_month => "first weekday of
month".</entry>
</row>
<row>
@@ -603,10 +674,12 @@
stream_itr_type str_end
ios_base
facet_type</screen></entry>
- <entry>A templated function that parses a date_generator from
the stream.</entry>
+ <entry>A templated function that parses a date_generator from
the stream.<sbr/>
+ 模板函数，从流中分析出一个 date_generator.</entry>
</row>
<row>
- <entry>Parses a last_day_of_the_week_in_month => "last weekday
of month".</entry>
+ <entry>Parses a last_day_of_the_week_in_month => "last weekday
of month".<sbr/>
+ 分析一个 last_day_of_the_week_in_month => "last weekday of
month".</entry>
</row>
<row>
@@ -618,10 +691,12 @@
stream_itr_type str_end
ios_base
facet_type</screen></entry>
- <entry>A templated function that parses a date_generator from
the stream.</entry>
+ <entry>A templated function that parses a date_generator from
the stream.<sbr/>
+ 模板函数，从流中分析出一个 date_generator.</entry>
</row>
<row>
- <entry>Parses a first_day_of_the_week_before => "weekday
before"</entry>
+ <entry>Parses a first_day_of_the_week_before => "weekday
before"<sbr/>
+ 分析一个 first_day_of_the_week_before => "weekday
before"</entry>
</row>
<row>
@@ -633,10 +708,12 @@
stream_itr_type str_end
ios_base
facet_type</screen></entry>
- <entry>A templated function that parses a date_generator from
the stream.</entry>
+ <entry>A templated function that parses a date_generator from
the stream.<sbr/>
+ 模板函数，从流中分析出一个 date_generator.</entry>
</row>
<row>
- <entry>Parses a first_day_of_the_week_after => "weekday
after".</entry>
+ <entry>Parses a first_day_of_the_week_after => "weekday
after".<sbr/>
+ 分析一个 first_day_of_the_week_after => "weekday
after".</entry>
</row>
</tbody>
@@ -647,8 +724,9 @@
<para>_____________________________________________________</para>
<anchor id="io_objects.special_values" />
- <bridgehead renderas="sect3">Special Values</bridgehead>
- <para>The date_time library uses five special_values. They are:
+ <bridgehead renderas="sect3">Special Values 特殊值</bridgehead>
+ <para>The date_time library uses five special_values. They are:<sbr/>
+ date_time 库中使用了五个 special_values. 它们是：
<simplelist type="horiz" columns="5">
<member>not_a_date_time</member>
<member>neg_infin</member>
@@ -657,42 +735,52 @@
<member>max_date_time</member>
</simplelist>
</para>
- <para>The default set of strings used to represent these types
are: "not-a-date-time", "-infinity", "+infinity", "minimum-date-time", "maximum-date-time".
When output, the min_date-time and max_date_time appear as normal date/time
representations: "1400-Jan-01" and "9999-Dec-31" repectively.</para>
-
- <bridgehead renderas="sect4">Customization</bridgehead>
- <para>The special values parser/formatter allows the user to set custom
strings for these special values. These strings can be set as construction
parameters to a new facet, or can be set in an existing facet via an
accessor function.</para>
-
- <bridgehead renderas="sect4">Special Values Formatter/Parser
Reference</bridgehead>
- The complete class references can be found here: <classname
alt="boost::date_time::special_values_formatter">Special Values Formatter
Doxygen Reference</classname> and here: <classname
alt="boost::date_time::special_values_parser">Special Values Parser Doxygen
Reference</classname>
+ <para>The default set of strings used to represent these types
are: "not-a-date-time", "-infinity", "+infinity", "minimum-date-time", "maximum-date-time".
When output, the min_date-time and max_date_time appear as normal date/time
representations: "1400-Jan-01" and "9999-Dec-31" repectively.<sbr/>
+ 用于表示这些类型的缺省字符串
是："not-a-date-time", "-infinity", "+infinity", "minimum-date-time", "maximum-date-time".
+ 在输出时，min_date-time 和 max_date_time以普通的日期/时间表示来显示，分别
为："1400-Jan-01" 和 "9999-Dec-31".</para>
+
+ <bridgehead renderas="sect4">Customization 定制</bridgehead>
+ <para>The special values parser/formatter allows the user to set custom
strings for these special values. These strings can be set as construction
parameters to a new facet, or can be set in an existing facet via an
accessor function.<sbr/>
+ 特殊值分析器/格式化器允许用户为这些特殊值设置定制的字符串。这些字符串可以
用为构造参数设置给一个新的 facet,
+ 或者可以通过访问器函数设置给一个已有的 facet.</para>
+
+ <bridgehead renderas="sect4">Special Values Formatter/Parser Reference 特
殊值的分析器/格式化器参考</bridgehead>
+ The complete class references can be found here: <classname
alt="boost::date_time::special_values_formatter">Special Values Formatter
Doxygen Reference</classname> and here: <classname
alt="boost::date_time::special_values_parser">Special Values Parser Doxygen
Reference</classname><sbr/>
+ 完整的类参考请见：<classname
alt="boost::date_time::special_values_formatter">特殊值格式化器Doxygen参考
</classname> 和
+ <classname alt="boost::date_time::special_values_parser">特殊值分析器
Doxygen参考</classname>
<para>
- <bridgehead renderas="sect4">Special Values Formatter
Constructor</bridgehead>
+ <bridgehead renderas="sect4">Special Values Formatter Constructor 特殊
值的格式化器构造函数</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
</thead>
<tbody>
<row>
<entry
valign="top"><screen>special_values_formatter()</screen></entry>
- <entry>Constructor uses defaults for special value
strings.</entry>
+ <entry>Constructor uses defaults for special value
strings.<sbr/>
+ 使用缺省的特殊值字符串的构造函数。</entry>
</row>
<row>
<entry valign="top"><screen>special_values_formatter(...)
Parameters:
collection_type::iterator
collection_type::iterator</screen></entry>
- <entry>Constructs using values in collection. NOTE: Only the
first three strings of the collection will be used. Strings for
minimum_date_time and maximum_date_time are ignored as those special values
are output as normal dates/times.</entry>
+ <entry>Constructs using values in collection. NOTE: Only the
first three strings of the collection will be used. Strings for
minimum_date_time and maximum_date_time are ignored as those special values
are output as normal dates/times.<sbr/>
+ 使用 collection 中的值进行构造。注：只使用 collection 中的前三
个字符串。minimum_date_time 和 maximum_date_time
+ 的字符串被忽略，因为这两个特殊值以普通的日期/时间来输出。
</entry>
</row>
<row>
<entry valign="top"><screen>special_values_formatter(...)
Parameters:
char_type*
char_type*</screen></entry>
- <entry>Constructs special values formatter from an array of
strings.</entry>
+ <entry>Constructs special values formatter from an array of
strings.<sbr/>
+ 从一个字符串数组构造特殊值格式化器。</entry>
</row>
</tbody>
@@ -701,16 +789,16 @@
</para>
<para>
- <bridgehead renderas="sect4">Special Values Formatter
Accessors</bridgehead>
+ <bridgehead renderas="sect4">Special Values Formatter Accessors 特殊值
格式化器的访问器</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
@@ -719,7 +807,8 @@
Parameters:
OutItrT next
special_values value</screen></entry>
- <entry>Puts the given special value into the stream.</entry>
+ <entry>Puts the given special value into the stream.<sbr/>
+ 将给定的特殊值放入到流中。</entry>
</row>
<row>
<entry><screen>date d1(not_a_date_time);
@@ -737,13 +826,13 @@
</para>
<para>
- <bridgehead renderas="sect4">Special Values Parser
Constructor</bridgehead>
+ <bridgehead renderas="sect4">Special Values Parser Constructor 特殊值分
析器的构造函数</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
</thead>
<tbody>
@@ -757,14 +846,16 @@
Parameters:
collection_type::iterator
collection_type::iterator</screen></entry>
- <entry>Constructs a special values parser using the strings in
the collection.</entry>
+ <entry>Constructs a special values parser using the strings in
the collection.<sbr/>
+ 使用 collection 中的字符串构造一个特殊值分析器。</entry>
</row>
<row>
<entry valign="top"><screen>special_values_parser(...)
Parameter:
scpecial_values_parser</screen></entry>
- <entry>Copy constructor.</entry>
+ <entry>Copy constructor.<sbr/>
+ 复制构造函数。</entry>
</row>
<row>
@@ -775,7 +866,8 @@
string_type pos_inf_str
string_type min_dt_str
string_type max_dt_str</screen></entry>
- <entry>Constructs a special values parser using the supplied
strings.</entry>
+ <entry>Constructs a special values parser using the supplied
strings.<sbr/>
+ 使用给定的字符串构造一个特殊值分析器。</entry>
</row>
</tbody>
@@ -784,16 +876,16 @@
</para>
<para>
- <bridgehead renderas="sect4">Special Values Parser
Accessors</bridgehead>
+ <bridgehead renderas="sect4">Special Values Parser Accessors 特殊值分析
器的访问器</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
@@ -805,7 +897,8 @@
string_type pos_inf_str
string_type min_dt_str
string_type max_dt_str</screen></entry>
- <entry>Replace the set of special value strings with the given
ones.</entry>
+ <entry>Replace the set of special value strings with the given
ones.<sbr/>
+ 以给定的字符串替换特殊值字符串。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -817,10 +910,11 @@
stream_itr_type beg
stream_itr_type end
match_results</screen></entry>
- <entry>Returns true if parse was successful. Upon a successful
parse, <code>mr.current_match</code> will be set an int values
corresponding to the equivalent special_value.</entry>
+ <entry>Returns true if parse was successful. Upon a successful
parse, <code>mr.current_match</code> will be set an int values
corresponding to the equivalent special_value.<sbr/>
+ 返回 true 如果分析成功。对于一次成功的分析，mr.current_match 被
设置为一个 int 值，对应于等价的 special_value.</entry>
</row>
<row>
- <entry><screen>// stream holds "maximum_date_time"
+ <entry><screen>// stream holds 流中有 "maximum_date_time"
typedef special_values_parser svp;
svp parser;
svp::match_results mr;
@@ -828,7 +922,7 @@
d = date(static_cast<special_values>(
mr.match_results))
} else {
- // error, failed parse
+ // error, failed parse 错误，分析失败
}
// d == "9999-Dec-31"</screen></entry>
</row>
@@ -841,20 +935,23 @@
<para>_____________________________________________________</para>
<anchor id="io_objects.format_date_parser" />
- <bridgehead renderas="sect3">Format Date Parser</bridgehead>
- <para>The format date parser is the object that holds the strings for
months and weekday names, as well as their abbreviations. Custom sets of
strings can be set at construction time, or, the strings in an existing
format_date_parser can be replaced through accessor functions. Both the
constructor and the accessor functions take a vector of strings as their
arguments.</para>
-
- <bridgehead renderas="sect4">Format Date Parser Reference</bridgehead>
- The complete class reference can be found here: <classname
alt="boost::date_time::format_date_parser">Doxygen Reference</classname>
+ <bridgehead renderas="sect3">Format Date Parser 格式化日期分析器
</bridgehead>
+ <para>The format date parser is the object that holds the strings for
months and weekday names, as well as their abbreviations. Custom sets of
strings can be set at construction time, or, the strings in an existing
format_date_parser can be replaced through accessor functions. Both the
constructor and the accessor functions take a vector of strings as their
arguments.<sbr/>
+ 格式化日期分析器是一个保存有月份名和周日的全名及其缩写名的字符串的对象。
可以在构造时对字符串进行定制，
+ 或者通过访问器函数替换已有 format_date_parser 中的字符串。构造函数以及访
问器函数均以一个字符串 vector 作为其参数。</para>
+
+ <bridgehead renderas="sect4">Format Date Parser Reference 格式化日期分析
器的参考</bridgehead>
+ The complete class reference can be found here: <classname
alt="boost::date_time::format_date_parser">Doxygen
Reference</classname><sbr/>
+ 完整的类参考请见：<classname
alt="boost::date_time::format_date_parser">Doxygen参考</classname>
<para>
- <bridgehead renderas="sect4">Format Date Parser
Constructor</bridgehead>
+ <bridgehead renderas="sect4">Format Date Parser Constructor 格式化日期
分析器的构造函数</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
</thead>
<tbody>
@@ -863,7 +960,9 @@
Parameters:
string_type format
std::locale</screen></entry>
- <entry>Creates a parser that uses the given format for parsing
dates (in those functions where there is no format parameter). The names
and abbreviations used are extracted from the given locale.</entry>
+ <entry>Creates a parser that uses the given format for parsing
dates (in those functions where there is no format parameter). The names
and abbreviations used are extracted from the given locale.<sbr/>
+ 创建一个分析器，以给定的格式来分析日期(在那些函数中没有格式化参
数)。
+ 所使用的名字及缩写从给定的 locale 中取出。</entry>
</row>
<row>
@@ -874,14 +973,17 @@
input_collection_type
input_collection_type
input_collection_type</screen></entry>
- <entry>Creates a parser from using the given components. The
input_collection_type parameters are for: short month names, long month
names, short weekday names, and long weekday names (in that order). These
collections must contain values for every month and every weekday (begining
with January and Sunday).</entry>
+ <entry>Creates a parser from using the given components. The
input_collection_type parameters are for: short month names, long month
names, short weekday names, and long weekday names (in that order). These
collections must contain values for every month and every weekday (begining
with January and Sunday).<sbr/>
+ 创建一个分析器，使用给定的组件。参数 input_collection_type
为：短月份名，长月份名，短周日名，长周日名(按顺序)。
+ 这些 collections 必须包含每个月份和每个周日(从一月和星期天开始
)的值。</entry>
</row>
<row>
<entry valign="top"><screen>format_date_parser(...)
Parameters:
format_date_parser</screen></entry>
- <entry>Copy Constructor</entry>
+ <entry>Copy Constructor<sbr/>
+ 复制构造函数。</entry>
</row>
</tbody>
@@ -890,22 +992,23 @@
</para>
<para>
- <bridgehead renderas="sect4">Format Date Parser Accessors</bridgehead>
+ <bridgehead renderas="sect4">Format Date Parser Accessors 格式化日期分
析器的访问器</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>string_type
format()</screen></entry>
- <entry>Returns the format that will be used when parsing dates
in those functions where there is no format parameter.</entry>
+ <entry>Returns the format that will be used when parsing dates
in those functions where there is no format parameter.<sbr/>
+ 返回在那些不带格式化参数的函数中进行日期分析时所使用的格式。
</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -913,7 +1016,8 @@
<row>
<entry valign="top" morerows="1"><screen>void
format(string_type)</screen></entry>
- <entry>Sets the format that will be used when parsing dates in
those functions where there is no format parameter.</entry>
+ <entry>Sets the format that will be used when parsing dates in
those functions where there is no format parameter.<sbr/>
+ 设置在那些不带格式化参数的函数中进行日期分析时所使用的格式。
</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -923,7 +1027,8 @@
<entry valign="top" morerows="1"><screen>void
short_month_names(...)
Parameter:
input_collection_type names</screen></entry>
- <entry>Replace the short month names used by the parser. The
collection must contain values for each month, starting with
January.</entry>
+ <entry>Replace the short month names used by the parser. The
collection must contain values for each month, starting with January.<sbr/>
+ 替换分析器所用的短月份名。collection 必须包含每个月份的值，从一
月开始。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -933,7 +1038,8 @@
<entry valign="top" morerows="1"><screen>void
long_month_names(...)
Parameter:
input_collection_type names</screen></entry>
- <entry>Replace the long month names used by the parser. The
collection must contain values for each month, starting with
January.</entry>
+ <entry>Replace the long month names used by the parser. The
collection must contain values for each month, starting with January.<sbr/>
+ 替换分析器所用的长月份名。collection 必须包含每个月份的值，从一
月开始。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -943,7 +1049,8 @@
<entry valign="top" morerows="1"><screen>void
short_weekday_names(...)
Parameter:
input_collection_type names</screen></entry>
- <entry>Replace the short weekday names used by the parser. The
collection must contain values for each weekday, starting with
Sunday.</entry>
+ <entry>Replace the short weekday names used by the parser. The
collection must contain values for each weekday, starting with Sunday.<sbr/>
+ 替换分析器所用的短周日名。collection 必须包含每个周日的值，从星
期天开始。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -953,7 +1060,8 @@
<entry valign="top" morerows="1"><screen>void
long_weekday_names(...)
Parameter:
input_collection_type names</screen></entry>
- <entry>Replace the long weekday names used by the parser. The
collection must contain values for each weekday, starting with
Sunday.</entry>
+ <entry>Replace the long weekday names used by the parser. The
collection must contain values for each weekday, starting with Sunday.<sbr/>
+ 替换分析器所用的长周日名。collection 必须包含每个周日的值，从星
期天开始。</entry>
***The diff for this file has been truncated for email.***
=======================================
--- /trunk/libs/date_time/xmldoc/io_tutorial.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/io_tutorial.xml Wed Jan 6 17:26:22 2010
@@ -9,20 +9,21 @@
<section id="date_time.io_tutorial"
xmlns:xi="http://www.w3.org/2001/XInclude";>
- <title>Date Time IO Tutorial</title>
- <bridgehead renderas="sect2">Date Time IO Tutorial</bridgehead>
-
- <link linkend="basic_use">Basic Use</link> |
- <link linkend="format_strings">Format Strings</link> |
- <link linkend="content_strings">Content Strings</link> |
- <link linkend="tut_sv">Special Values</link> |
- <link linkend="tut_dper">Date/Time Periods</link> |
- <link linkend="tut_dgen">Date Generators</link>
+ <title>Date Time IO Tutorial 日期时间 IO 指南</title>
+ <bridgehead renderas="sect2">Date Time IO Tutorial 日期时间 IO 指南
</bridgehead>
+
+ <link linkend="basic_use">Basic Use 基本用法</link> |
+ <link linkend="format_strings">Format Strings 格式化串</link> |
+ <link linkend="content_strings">Content Strings 内容字符串</link> |
+ <link linkend="tut_sv">Special Values 特殊值</link> |
+ <link linkend="tut_dper">Date/Time Periods 日期/时间段</link> |
+ <link linkend="tut_dgen">Date Generators 日期生成器 </link>
<anchor id="basic_use" />
- <bridgehead renderas="sect4">Basic Use</bridgehead>
- <para>Facets are automatically imbued when operators '>>' and '<<'
are called. The list of date_time objects that can be streamed are:</para>
- <bridgehead renderas="sect5">Gregorian</bridgehead>
+ <bridgehead renderas="sect4">Basic Use 基本用法</bridgehead>
+ <para>Facets are automatically imbued when operators '>>' and '<<'
are called. The list of date_time objects that can be streamed are:<sbr/>
+ 在调用 '>>' 和 '<<' 时，会自动使用 Facets. 可以进行流输入输出的
date_time 对象列举如下：</para>
+ <bridgehead renderas="sect5">Gregorian 格里历</bridgehead>
<para>
<code>date</code>,
<code>days</code>,
@@ -43,13 +44,14 @@
<code>time_period</code>,
<code>time_duration</code>
</para>
- <bridgehead renderas="sect5">Local_time</bridgehead>
+ <bridgehead renderas="sect5">Local_time 本地时间</bridgehead>
<para>
<code>local_date_time</code>
</para>
<para>
- The following example is of the basic use of the new IO code,
utilizing all the defaults. (this example can be found in the
<code>libs/date_time/examples/tutorial</code> directory)
+ The following example is of the basic use of the new IO code,
utilizing all the defaults. (this example can be found in the
<code>libs/date_time/examples/tutorial</code> directory)<sbr/>
+ 以下是使用新的 IO 代码的简单例子，全部使用缺省值。(这个例子可以在
<code>libs/date_time/examples/tutorial</code> 目录下找到)
</para>
<programlisting>
<![CDATA[
@@ -69,12 +71,17 @@
]]>
</programlisting>
- <para>This example used the default settings for the input and output
facets. The default formats are such that interoperability like that shown
in the example is possible. NOTE: Input streaming of local_date_time can
only be done with a <link
linkend="date_time.local_time.posix_time_zone">posix time zone
string</link>. The default output format uses a time zone abbreviation. The
format can be changed so out and in match (as we will see later in this
tutorial).</para>
+ <para>This example used the default settings for the input and output
facets. The default formats are such that interoperability like that shown
in the example is possible. NOTE: Input streaming of local_date_time can
only be done with a <link
linkend="date_time.local_time.posix_time_zone">posix time zone
string</link>. The default output format uses a time zone abbreviation. The
format can be changed so out and in match (as we will see later in this
tutorial).<sbr/>
+ 这个例子使用了输入和输出 facets 的缺省值。缺省的格式正如上例所示。注
意：local_date_time 的流输入只能用一个
+ <link linkend="date_time.local_time.posix_time_zone">posix 时区字符串
</link> 来完成。
+ 缺省的输出格式将使用时区缩写。这个格式可以被改变，以使得输入和输出相匹配
(在本指南稍后将会看到)。</para>
<anchor id="format_strings" />
- <bridgehead renderas="sect4">Format Strings</bridgehead>
- <para>The format strings control the order, type, and style of the
date/time elements used. The facets provide some predefined formats
(iso_format_specifier, iso_format_extended_specifier, and
default_date_format) but the user can easily create their own.</para>
- (continued from previous example)
+ <bridgehead renderas="sect4">Format Strings 格式化串</bridgehead>
+ <para>The format strings control the order, type, and style of the
date/time elements used. The facets provide some predefined formats
(iso_format_specifier, iso_format_extended_specifier, and
default_date_format) but the user can easily create their own.<sbr/>
+ 格式化串控制着所用的日期/时间元素的顺序、类型和风格。facets 提供了一些预
定义的格式(iso_format_specifier,
+ iso_format_extended_specifier, 和 default_date_format)，不过用户也可以很
容易地创建自己的格式。</para>
+ (continued from previous example 继续前一个例子)
<programlisting>
<![CDATA[
local_time_facet* output_facet = new local_time_facet();
@@ -99,11 +106,13 @@
]]>
</programlisting>
- <para>Format strings are not limited to date/time elements. Extra
verbiage can be placed in a format string. NOTE: When extra verbiage is
present in an input format, the data being input must also contain the
exact verbiage.</para>
- (continued from previous example)
+ <para>Format strings are not limited to date/time elements. Extra
verbiage can be placed in a format string. NOTE: When extra verbiage is
present in an input format, the data being input must also contain the
exact verbiage.<sbr/>
+ 格式化串前不仅限于日期/时间元素。可以往格式化串中放入其它内容。注意：如果
在输入格式化串中存在其它内容，
+ 那么输入的数据中也必须包含这些内容。</para>
+ (continued from previous example 继续前一个例子)
<programlisting>
<![CDATA[
- // extra words in format
+ // extra words in format 格式中的额外单词
string my_format("The extended ordinal time %Y-%jT%H:%M can also be \
represented as %A %B %d, %Y");
output_facet->format(my_format.c_str());
@@ -112,7 +121,7 @@
ss << ldt;
cout << ss.str() << endl;
- // matching extra words in input
+ // matching extra words in input 在输入中必须要有相匹配的单词
ss.str("The extended ordinal time 2005-128T12:15 can also be \
represented as Sunday May 08, 2005");
ss >> ldt;
@@ -121,10 +130,14 @@
</programlisting>
<anchor id="content_strings" />
- <bridgehead renderas="sect4">Content Strings</bridgehead>
- <para>So far we've shown how a user can achieve a great deal of
customization with very little effort by using formats. Further
customization can be achieved through user defined elements (ie strings).
The elements that can be customized are: Special value names, month names,
month abbreviations, weekday names, weekday abbreviations, delimiters of
the date/time periods, and the phrase elements of the
date_generators.</para>
- <para>The default values for these are as follows:</para>
- <bridgehead renderas="sect5">Special values</bridgehead>
+ <bridgehead renderas="sect4">Content Strings 内容字符串</bridgehead>
+ <para>So far we've shown how a user can achieve a great deal of
customization with very little effort by using formats. Further
customization can be achieved through user defined elements (ie strings).
The elements that can be customized are: Special value names, month names,
month abbreviations, weekday names, weekday abbreviations, delimiters of
the date/time periods, and the phrase elements of the date_generators.<sbr/>
+ 前面我们示范了如何通过格式化以极少量的工作量来达到大量的定制化。更进一步
的定制化可以通过用户自定义元素(即字符串)来完成。
+ 可以被定制的元素包括：特殊值的名字、月份名、月份缩写、周日名、周日缩写、
日期/时间段的定界符，
+ 以及 date_generators 的短语元素。</para>
+ <para>The default values for these are as follows:<sbr/>
+ 以上元素的缺省值如下：</para>
+ <bridgehead renderas="sect5">Special values 特殊值</bridgehead>
<para>
<code>not-a-date-time</code>,
<code>-infinity</code>,
@@ -132,15 +145,17 @@
<code>minimum-date-time</code>,
<code>maximum-date-time</code>
</para>
- <bridgehead renderas="sect5">Months</bridgehead>
+ <bridgehead renderas="sect5">Months 月份</bridgehead>
<para>
- <code>English calendar and three letter abbreviations</code>
+ <code>English calendar and three letter abbreviations<sbr/>
+ 英语名字及三字母的缩写</code>
</para>
- <bridgehead renderas="sect5">Weekdays</bridgehead>
+ <bridgehead renderas="sect5">Weekdays 周日</bridgehead>
<para>
- <code>English calendar and three letter abbreviations</code>
+ <code>English calendar and three letter abbreviations<sbr/>
+ 英语名字及三字母缩写</code>
</para>
- <bridgehead renderas="sect5">Date generator phrase elements</bridgehead>
+ <bridgehead renderas="sect5">Date generator phrase elements 日期生成器的
短语元素</bridgehead>
<para>
<code>first</code>,
<code>second</code>,
@@ -152,15 +167,18 @@
<code>after</code>,
<code>of</code>
</para>
- <para>NOTE: We've shown earlier that the components of a date/time
representation can be re-ordered via the format string. This is not the
case with date_generators. The elements themselves can be customized but
their order cannot be changed.</para>
-
- <bridgehead renderas="sect4">Content Strings</bridgehead>
- <para>To illustrate the customization possibilities we will use custom
strings for months and weekdays (we will only use long names, is all
lowercase, for this example).</para>
- (continued from previous example)
+ <para>NOTE: We've shown earlier that the components of a date/time
representation can be re-ordered via the format string. This is not the
case with date_generators. The elements themselves can be customized but
their order cannot be changed.<sbr/>
+ 注意：我们在前面曾经示范过日期/时间表示中的组件可以通过格式化串来重新排
序。
+ 但是对于 date_generators 来说则不可以。其中的元素可以定制但顺序不可改变。
</para>
+
+ <bridgehead renderas="sect4">Content Strings 内容字符串</bridgehead>
+ <para>To illustrate the customization possibilities we will use custom
strings for months and weekdays (we will only use long names, is all
lowercase, for this example).<sbr/>
+ 为了示范定制化的可能性，我们将为月份和周日使用定制的字符串(我们在这个例子
中只使用长名字，且全为小写)。</para>
+ (continued from previous example 继续前一个例子)
<programlisting>
<![CDATA[
- // set up the collections of custom strings.
- // only the full names are altered for the sake of brevity
+ // set up the collections of custom strings. 设置定制字符串的
collections.
+ // only the full names are altered for the sake of brevity 为简短起见，只
修改全名
string month_names[12] = { "january", "february", "march",
"april", "may", "june",
"july", "august", "september",
@@ -170,21 +188,21 @@
"thursday", "friday", "saturday" };
vector<string> long_days(&day_names[0], &day_names[7]);
- // create date_facet and date_input_facet using all defaults
+ // create date_facet and date_input_facet using all defaults 使用缺省值
创建 date_facet 和 date_input_facet
date_facet* date_output = new date_facet();
date_input_facet* date_input = new date_input_facet();
ss.imbue(locale(ss.getloc(), date_output));
ss.imbue(locale(ss.getloc(), date_input));
- // replace names in the output facet
+ // replace names in the output facet 替换输出 facet 中的名字
date_output->long_month_names(long_months);
date_output->long_weekday_names(long_days);
- // replace names in the input facet
+ // replace names in the input facet 替换输入 facet 中的名字
date_input->long_month_names(long_months);
date_input->long_weekday_names(long_days);
- // customize month, weekday and date formats
+ // customize month, weekday and date formats 定制月份、周日和日期的格式
date_output->format("%Y-%B-%d");
date_input->format("%Y-%B-%d");
date_output->month_format("%B"); // full name
@@ -206,17 +224,19 @@
<anchor id="tut_sv" />
- <bridgehead renderas="sect4">Special Values</bridgehead>
- <para>Customizing the input and output of special values is best done by
creating a new special_values_parser and special_values_formatter. The new
strings can be set at construction time (as in the example below).</para>
- (continued from previous example)
+ <bridgehead renderas="sect4">Special Values 特殊值</bridgehead>
+ <para>Customizing the input and output of special values is best done by
creating a new special_values_parser and special_values_formatter. The new
strings can be set at construction time (as in the example below).<sbr/>
+ 定制输入和输出用的特殊值，最好的方法是创建一个新的 special_values_parser
和 special_values_formatter.
+ 新的字符串在构造的时候进行设置(如下例所示)。</para>
+ (continued from previous example 继续前一个例子)
<programlisting>
<![CDATA[
- // reset the formats to defaults
+ // reset the formats to defaults 将格式重置为缺省
output_facet->format(local_time_facet::default_time_format);
input_facet->format(local_time_input_facet::default_time_input_format);
- // create custom special_values parser and formatter objects
- // and add them to the facets
+ // create custom special_values parser and formatter objects 创建定制的
special_values 分析器和格式化器对象
+ // and add them to the facets 并将它们加入到 facets
string sv[5] = {"nadt","neg_inf", "pos_inf", "min_dt", "max_dt" };
vector<string> sv_names(&sv[0], &sv[5]);
special_values_parser sv_parser(sv_names.begin(), sv_names.end());
@@ -236,36 +256,40 @@
cout << ss.str() << endl; // "1400-Jan-01 00:00:00 UTC"
]]>
</programlisting>
- <para>NOTE: even though we sent in strings for min and max to the
formatter, they are ignored because those special values construct to
actual dates (as shown above).</para>
+ <para>NOTE: even though we sent in strings for min and max to the
formatter, they are ignored because those special values construct to
actual dates (as shown above).<sbr/>
+ 注意：虽然我们将 min 和 max 的字符串也传递给了格式化器，但是它们会被忽
略，
+ 因为这两个特殊值是以真实的日期来构造的(如上所示)。</para>
<anchor id="tut_dper" />
- <bridgehead renderas="sect4">Date/Time Periods</bridgehead>
- <para>Customizing the input and output of periods is best done by
creating a new period_parser and period_formatter. The new strings can be
set at construction time (as in the example below).</para>
- (continued from previous example)
+ <bridgehead renderas="sect4">Date/Time Periods 日期/时间段</bridgehead>
+ <para>Customizing the input and output of periods is best done by
creating a new period_parser and period_formatter. The new strings can be
set at construction time (as in the example below).<sbr/>
+ 定制时间段的输入输出，最好的方法是创建一个新的 period_parser 和
period_formatter.
+ 新的字符串在构造的时候进行设置(如下例所示)。</para>
+ (continued from previous example 继续前一个例子)
<programlisting>
<![CDATA[
- // all formats set back to defaults (not shown for brevity)
-
- // create our date_period
- date_period dp(date(2005,Mar,1), days(31)); // month of march
-
- // custom period formatter and parser
+ // all formats set back to defaults (not shown for brevity) 将所有格式设
置回缺省值(为简短起见，不再列出)
+
+ // create our date_period 创建我们的 date_period
+ date_period dp(date(2005,Mar,1), days(31)); // month of march 整个三月份
+
+ // custom period formatter and parser 定制时间段格式化器和分析器
period_formatter per_formatter(period_formatter::AS_OPEN_RANGE,
" to ", "from ", " exclusive", "
inclusive" );
period_parser per_parser(period_parser::AS_OPEN_RANGE,
" to ", "from ", " exclusive" , "inclusive" );
- // default output
+ // default output 缺省输出
ss.str("");
ss << dp;
cout << ss.str() << endl; // "[2005-Mar-01/2005-Mar-31]"
- // add out custom parser and formatter to the facets
+ // add out custom parser and formatter to the facets 将我们的定制分析器
和格式化器加入到 facets
date_output->period_formatter(per_formatter);
date_input->period_parser(per_parser);
- // custom output
+ // custom output 定制化输出
ss.str("");
ss << dp;
cout << ss.str() << endl; // "from 2005-Feb-01 to 2005-Apr-01 exclusive"
@@ -273,30 +297,33 @@
</programlisting>
<anchor id="tut_dgen" />
- <bridgehead renderas="sect4">Date Generators</bridgehead>
- <para>Customizing the input and output of date_generators is done by
replacing the existing strings (in the facet) with new strings.</para>
- <para>NOTE: We've shown earlier that the components of a date/time
representation can be re-ordered via the format string. This is not the
case with date_generators. The elements themselves can be customized but
their order cannot be changed.</para>
- (continued from previous example)
+ <bridgehead renderas="sect4">Date Generators 日期生成器</bridgehead>
+ <para>Customizing the input and output of date_generators is done by
replacing the existing strings (in the facet) with new strings.<sbr/>
+ 定制 date_generators 的输入输出可以通过将(在 facet 中的)已有字符串替换为
新字符串来完成。</para>
+ <para>NOTE: We've shown earlier that the components of a date/time
representation can be re-ordered via the format string. This is not the
case with date_generators. The elements themselves can be customized but
their order cannot be changed.<sbr/>
+ 注意：前面我们曾经示范过日期/时间表示中的组件可以通过格式化串变更顺序。但
是对于 date_generators 则不可以。
+ 其中的元素可以定制，但顺序不可改变。</para>
+ (continued from previous example 继续前一个例子)
<programlisting>
<![CDATA[
- // custom date_generator phrases
+ // custom date_generator phrases 定制 date_generator 短语
string dg_phrases[9] = { "1st", "2nd", "3rd", "4th", "5th",
"final", "prior to", "following", "in" };
vector<string> phrases(&dg_phrases[0], &dg_phrases[9]);
- // create our date_generator
+ // create our date_generator 创建我们的 date_generator
first_day_of_the_week_before d_gen(Monday);
- // default output
+ // default output 缺省输出
ss.str("");
ss << d_gen;
cout << ss.str() << endl; // "Mon before"
- // add our custom strings to the date facets
+ // add our custom strings to the date facets 将我们的定制字符串加入到日
期 facets
date_output->date_gen_phrase_strings(phrases);
date_input->date_gen_element_strings(phrases);
- // custom output
+ // custom output 定制化的输出
ss.str("");
ss << d_gen;
cout << ss.str() << endl; // "Mon prior to"
=======================================
--- /trunk/libs/date_time/xmldoc/local_date_time.xml Mon Dec 28 23:05:14
2009
+++ /trunk/libs/date_time/xmldoc/local_date_time.xml Wed Jan 6 17:26:22
2010
@@ -8,44 +8,47 @@
-->
<section id="date_time.local_time.local_date_time">
- <title>Local Date Time</title>
-
- <link linkend="local_date_time_intro">Introduction</link> --
- <link linkend="local_date_time_header">Header</link> --
- <link linkend="local_date_time_clock_constr">Construct From Clock</link>
--
- <link linkend="local_date_time_constr">Construction</link> --
- <link linkend="local_date_time_accessors">Accessors</link> --
- <link linkend="local_date_time_operators">Operators</link> --
+ <title>Local Date Time 本地日期时间</title>
+
+ <link linkend="local_date_time_intro">Introduction 简介</link> --
+ <link linkend="local_date_time_header">Header 头文件</link> --
+ <link linkend="local_date_time_clock_constr">Construct From Clock 从时钟
构造</link> --
+ <link linkend="local_date_time_constr">Construction 构造</link> --
+ <link linkend="local_date_time_accessors">Accessors 访问器</link> --
+ <link linkend="local_date_time_operators">Operators 操作符</link> --
<link linkend="local_date_time_tm_func">Struct tm Functions</link>
<anchor id="local_date_time_intro" />
- <bridgehead renderas="sect3">Introduction</bridgehead>
+ <bridgehead renderas="sect3">Introduction 简介</bridgehead>
<para>
- A local_date_time object is a point in time and an associated time
zone. The time is represented internally as UTC.
+ A local_date_time object is a point in time and an associated time
zone. The time is represented internally as UTC.<sbr/>
+ local_date_time 对象是一个时间点加上一个相应时区。该时间在内部表示为
UTC.
</para>
<anchor id="local_date_time_header" />
- <bridgehead renderas="sect3">Header</bridgehead>
+ <bridgehead renderas="sect3">Header 头文件</bridgehead>
<para>
The inclusion of a single header will bring in all boost::local_time
types,
-functions, and IO operators.
+functions, and IO operators.<sbr/>
+包含单个头文件即可引入所有 boost::local_time 类型、函数和 IO 操作符。
<programlisting>
#include "boost/date_time/local_time/local_time.hpp"
</programlisting>
</para>
<anchor id="local_date_time_clock_constr" />
- <bridgehead renderas="sect3">Construct From Clock</bridgehead>
+ <bridgehead renderas="sect3">Construct From Clock 从时钟构造</bridgehead>
<para>
- Creation of a local_date_time object from clock is possible with
either second, or sub second resolution.
+ Creation of a local_date_time object from clock is possible with
either second, or sub second resolution.<sbr/>
+ 从时钟创建一个 local_date_time 对象，精度可以是秒或次秒级。
</para>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry>Syntax</entry>
- <entry>Example</entry>
+ <entry>Syntax 语法</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
@@ -82,29 +85,44 @@
</para>
<anchor id="local_date_time_constr" />
- <bridgehead renderas="sect3">Construction</bridgehead>
+ <bridgehead renderas="sect3">Construction 构造</bridgehead>
<para>
- Construction of a local_date_time object can be done with a ptime and
a time_zone_ptr where the ptime represents UTC time. Construction with a
wall-clock representation takes the form of a date, a time_duration, a
time_zone_ptr, and a fourth parameter that addresses the following
complication.
+ Construction of a local_date_time object can be done with a ptime and
a time_zone_ptr where the ptime represents UTC time. Construction with a
wall-clock representation takes the form of a date, a time_duration, a
time_zone_ptr, and a fourth parameter that addresses the following
complication.<sbr/>
+ 要构造一个 local_date_time 对象，可以用一个 ptime 加一个 time_zone_ptr
来构造，其中 ptime 表示 UTC 时间。
+ 从一个带有日期、time_duration 和 time_zone_ptr 的 wall-clock 表示进行构
造，要解决以下复杂性。
</para>
<para>
- Construction from a wall-clock rep may result in differing shifts for
a particular time zone, depending on daylight savings rules for that zone.
This means it is also possible to create a local_date_time with a
non-existent, or duplicated, UTC representation. These cases occur during
the forward shift in time that is the transition into daylight savings and
during the backward shift that is the transition out of daylight savings.
The user has two options for handling these cases: a bool flag that states
if the time is daylight savings, or an enum that states what to do when
either of these cases are encountered.
+ Construction from a wall-clock rep may result in differing shifts for
a particular time zone, depending on daylight savings rules for that zone.
This means it is also possible to create a local_date_time with a
non-existent, or duplicated, UTC representation. These cases occur during
the forward shift in time that is the transition into daylight savings and
during the backward shift that is the transition out of daylight savings.
The user has two options for handling these cases: a bool flag that states
if the time is daylight savings, or an enum that states what to do when
either of these cases are encountered.<sbr/>
+ 从一个 wall-clock 表示进行构造可能导致对某个时区进行不同的位移，这取决
于该时区的夏令时规则。
+ 这意味着也可能会创建出一个不存在的或重复的，以UTC表示的
local_date_time.
+ 这种情况会发生在刚好转入夏令时和从夏令时转出的时候。用户有两个选择来处
理这种情况：
+ 用一个 bool 标志来表示该时间是否为夏令时，或者使用一个 enum 来表示遇到
这种情形时要做什么。
</para>
<para>
- The bool flag is ignored when the given time_zone has no daylight
savings specification. When the daylight savings status of a given time
label is calculated and it does not match the flag, a
<code>local_time::dst_not_valid</code> exception is thrown. If a time label
is invalid (does not exist), a <code>local_time::time_label_invalid</code>
exception is thrown.
+ The bool flag is ignored when the given time_zone has no daylight
savings specification. When the daylight savings status of a given time
label is calculated and it does not match the flag, a
<code>local_time::dst_not_valid</code> exception is thrown. If a time label
is invalid (does not exist), a <code>local_time::time_label_invalid</code>
exception is thrown.<sbr/>
+ 当给定的 time_zone 没有夏令时规则时，该 bool 标志将被忽略。当给定的时间
标签的夏令时状态被计算出来并且与该标志不匹配时，
+ 将抛出一个 <code>local_time::dst_not_valid</code> 异常。如果时间标签是
无效的(即不存在)，则抛出
+ <code>local_time::time_label_invalid</code> 异常。
</para>
<para>
- There are two elements in the
<code>local_date_time::DST_CALC_OPTIONS</code> enum:
<code>EXCEPTION_ON_ERROR</code> and <code>NOT_DATE_TIME_ON_ERROR</code>.
The possible exceptions thrown are a
<code>local_time::ambiguous_result</code> or a
<code>local_time::time_label_invalid</code>. The
<code>NOT_DATE_TIME_ON_ERROR</code> sets the time value to the special
value <code>local_time::not_a_date_time</code> in the event of either a
invalid or an ambiguous time label.
+ There are two elements in the
<code>local_date_time::DST_CALC_OPTIONS</code> enum:
<code>EXCEPTION_ON_ERROR</code> and <code>NOT_DATE_TIME_ON_ERROR</code>.
The possible exceptions thrown are a
<code>local_time::ambiguous_result</code> or a
<code>local_time::time_label_invalid</code>. The
<code>NOT_DATE_TIME_ON_ERROR</code> sets the time value to the special
value <code>local_time::not_a_date_time</code> in the event of either a
invalid or an ambiguous time label.<sbr/>
+ 在 <code>local_date_time::DST_CALC_OPTIONS</code> enum 是有两个元
素：<code>EXCEPTION_ON_ERROR</code> 和
+ <code>NOT_DATE_TIME_ON_ERROR</code>. 可能抛出的异常是
<code>local_time::ambiguous_result</code> 或
+ <code>local_time::time_label_invalid</code>. 如果时间标签无效或不明确
时，<code>NOT_DATE_TIME_ON_ERROR</code>
+ 将时间值设为特定的 <code>local_time::not_a_date_time</code>.
+
+
</para>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
@@ -113,7 +131,8 @@
Parameters:
posix_time::ptime
time_zone_ptr</screen></entry>
- <entry>The given time is expected to be UTC. Therefore, the
given time will be adjusted according to the offset described in the time
zone.</entry>
+ <entry>The given time is expected to be UTC. Therefore, the
given time will be adjusted according to the offset described in the time
zone.<sbr/>
+ 给定的时间应为 UTC. 因此给定时间将被根据时区的偏移量来调整。
</entry>
</row>
<row>
<entry><screen>
@@ -133,7 +152,9 @@
time_duration
time_zone_ptr
bool</screen></entry>
-<entry>The passed time information understood to be in the passed tz. The
DST flag must be passed to indicate whether the time is in daylight savings
or not. May throw a <code>dst_not_valid</code> or
<code>time_label_invalid</code> exception.</entry>
+<entry>The passed time information understood to be in the passed tz. The
DST flag must be passed to indicate whether the time is in daylight savings
or not. May throw a <code>dst_not_valid</code> or
<code>time_label_invalid</code> exception.<sbr/>
+传入的时间信息被理解为在被传入时区的时间。必须传入 DST 标志以表示该时间是否
为夏令时。可能抛出 <code>dst_not_valid</code>
+或 <code>time_label_invalid</code> 异常。</entry>
</row>
<row>
<entry><screen>date d(2004,Nov,5);
@@ -153,7 +174,9 @@
time_duration
time_zone_ptr
DST_CALC_OPTIONS</screen></entry>
- <entry>The passed time information understood to be in the
passed tz. The DST flag is calculated according to the specified rule. May
throw a <code>ambiguous_result</code> or <code>time_label_invalid</code>
exception.</entry>
+ <entry>The passed time information understood to be in the
passed tz. The DST flag is calculated according to the specified rule. May
throw a <code>ambiguous_result</code> or <code>time_label_invalid</code>
exception.<sbr/>
+ 被传入的时间信息被理解为在被传入时区的时间。DST 标志会根据指定
规则计算出来。可能抛出 <code>ambiguous_result</code>
+ 或 <code>time_label_invalid</code> 异常。</entry>
</row>
<row>
<entry><screen>date d(2004,Nov,5);
@@ -168,7 +191,8 @@
<row>
<entry valign="top"
morerows="1"><screen>local_date_time(local_date_time);</screen></entry>
- <entry>Copy Constructor.</entry>
+ <entry>Copy Constructor.<sbr/>
+ 复制构造函数。</entry>
</row>
<row>
<entry><screen>local_date_time az_2(az);</screen></entry>
@@ -179,7 +203,8 @@
Parameters:
special_values
time_zone_ptr</screen></entry>
- <entry>Special Values constructor.</entry>
+ <entry>Special Values constructor.<sbr/>
+ 特殊值构造函数。</entry>
</row>
<row>
<entry><screen>time_zone_ptr zone(
@@ -198,23 +223,24 @@
</para>
<anchor id="local_date_time_accessors" />
- <bridgehead renderas="sect3">Accessors</bridgehead>
+ <bridgehead renderas="sect3">Accessors 访问器</bridgehead>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>time_zone_ptr
zone()</screen></entry>
- <entry>Returns associated time_zone object via a
time_zone_ptr</entry>
+ <entry>Returns associated time_zone object via a
time_zone_ptr<sbr/>
+ 通过一个 time_zone_ptr 返回相关联的 time_zone 对象。</entry>
</row>
<row>
<entry><screen></screen></entry>
@@ -222,7 +248,8 @@
<row>
<entry valign="top" morerows="1"><screen>bool
is_dst()</screen></entry>
- <entry>Determines if time value is in DST for associated
zone.</entry>
+ <entry>Determines if time value is in DST for associated
zone.<sbr/>
+ 判断时间值是否在相关时区的DST中。</entry>
</row>
<row>
<entry></entry>
@@ -230,7 +257,8 @@
<row>
<entry valign="top" morerows="1"><screen>ptime
utc_time()</screen></entry>
- <entry>Converts the local time value to a UTC value.</entry>
+ <entry>Converts the local time value to a UTC value.<sbr/>
+ 将本地时间转为UTC值。</entry>
</row>
<row>
<entry><screen>ptime pt(date(2004,Nov,5),
@@ -244,7 +272,8 @@
<row>
<entry valign="top" morerows="1"><screen>ptime
local_time()</screen></entry>
- <entry>Returns the local time for this object
(Wall-clock).</entry>
+ <entry>Returns the local time for this object
(Wall-clock).<sbr/>
+ 返回该对象的本地时间(Wall-clock)。</entry>
</row>
<row>
<entry><screen>ptime pt(date(2004,Nov,5),
@@ -263,7 +292,8 @@
Parameters:
time_zone_ptr
time_duration</screen></entry>
- <entry>Returns a local_date_time representing the same UTC
time as calling object, plus optional time_duration, with given time
zone.</entry>
+ <entry>Returns a local_date_time representing the same UTC
time as calling object, plus optional time_duration, with given time
zone.<sbr/>
+ 给定某个时区，返回该时区与调用对象相同UTC时间的
local_date_time，可能会加上一段 time_duration.</entry>
</row>
<row>
<entry><screen>local_date_time nyc =
az.local_time_in(nyc_zone);
@@ -291,7 +321,8 @@
-->
<row>
<entry valign="top" morerows="1"><screen>bool is_infinity()
const</screen></entry>
- <entry>Returns true if local_date_time is either positive or
negative infinity</entry>
+ <entry>Returns true if local_date_time is either positive or
negative infinity<sbr/>
+ 返回 true 如果 local_date_time 为正无限或负无限。</entry>
</row>
<row>
<entry><screen>local_date_time ldt(pos_infin);
@@ -300,7 +331,8 @@
<row>
<entry valign="top" morerows="1"><screen>bool
is_neg_infinity() const</screen></entry>
- <entry>Returns true if local_date_time is negative
infinity</entry>
+ <entry>Returns true if local_date_time is negative
infinity<sbr/>
+ 返回 true 如果 local_date_time 为负无限。</entry>
</row>
<row>
<entry><screen>local_date_time ldt(neg_infin);
@@ -309,7 +341,8 @@
<row>
<entry valign="top" morerows="1"><screen>bool
is_pos_infinity() const</screen></entry>
- <entry>Returns true if local_date_time is positive
infinity</entry>
+ <entry>Returns true if local_date_time is positive
infinity<sbr/>
+ 返回 true 如果 local_date_time 为正无限。</entry>
</row>
<row>
<entry><screen>local_date_time ldt(neg_infin);
@@ -318,7 +351,8 @@
<row>
<entry valign="top" morerows="1"><screen>bool
is_not_a_date_time() const</screen></entry>
- <entry>Returns true if value is not a date</entry>
+ <entry>Returns true if value is not a date<sbr/>
+ 返回 true 如果该值不是一个有效日期。</entry>
</row>
<row>
<entry><screen>local_date_time ldt(not_a_date_time);
@@ -327,7 +361,8 @@
<row>
<entry valign="top" morerows="1"><screen>bool is_special()
const</screen></entry>
- <entry>Returns true if local_date_time is any
<code>special_value</code></entry>
+ <entry>Returns true if local_date_time is any
<code>special_value</code><sbr/>
+ 返回 true 如果 local_date_time 为任一
<code>special_value</code> </entry>
</row>
<row>
<entry><screen>local_date_time ldt(pos_infin);
@@ -347,22 +382,24 @@
</para>
<anchor id="local_date_time_operators" />
- <bridgehead renderas="sect3">Operators</bridgehead>
+ <bridgehead renderas="sect3">Operators 操作符</bridgehead>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"
morerows="1"><screen>operator<<</screen></entry>
- <entry>Output streaming operator. This operator is part of the
v1.33 IO addition to date_time. For complete details on this feature see
<link linkend="date_time.date_time_io">Date Time IO</link>. The default
output is shown in this example.</entry>
+ <entry>Output streaming operator. This operator is part of the
v1.33 IO addition to date_time. For complete details on this feature see
<link linkend="date_time.date_time_io">Date Time IO</link>. The default
output is shown in this example.<sbr/>
+ 流输出操作符。该操作符是 v1.33 中所增加的对 date_time 的 IO 的一
部分。有关详情请见
+ <link linkend="date_time.date_time_io">日期时间 IO</link> 一节。
缺省的输出请见下例。</entry>
</row>
<row>
<entry><screen>
@@ -377,7 +414,11 @@
<row>
<entry valign="top"
morerows="1"><screen>operator>></screen></entry>
- <entry>Input streaming operator. This operator is part of the
v1.33 IO addition to date_time. For complete details on this feature see
<link linkend="date_time.date_time_io">Date Time IO</link>. At this time,
<code>local_date_time</code> objects can only be streamed in with a Posix
Time Zone string. A complete description of a Posix Time Zone string can be
found in the documentation for the <link
linkend="posix_time_zone_intro">posix_time_zone</link> class.</entry>
+ <entry>Input streaming operator. This operator is part of the
v1.33 IO addition to date_time. For complete details on this feature see
<link linkend="date_time.date_time_io">Date Time IO</link>. At this time,
<code>local_date_time</code> objects can only be streamed in with a Posix
Time Zone string. A complete description of a Posix Time Zone string can be
found in the documentation for the <link
linkend="posix_time_zone_intro">posix_time_zone</link> class.<sbr/>
+ 流输入操作符。该操作符是 v1.33 中所增加的对 date_time 的 IO 的一
部分。有关详情请见
+ <link linkend="date_time.date_time_io">日期时间 IO</link> 一节。
当前 ，<code>local_date_time</code>
+ 对象只能使用 Posix 时区字符串进行流输入。有关 Posix 时区字符串的
完整描述请见
+ <link linkend="posix_time_zone_intro">posix_time_zone</link> 类的
相关文档。</entry>
</row>
<row>
<entry><screen>stringstream ss;
@@ -390,7 +431,8 @@
<entry valign="top" morerows="1"><screen>operator==, operator!=,
operator>, operator<,
operator>=, operator<=</screen></entry>
- <entry>A full complement of comparison operators</entry>
+ <entry>A full complement of comparison operators<sbr/>
+ 完整的比较操作符。</entry>
</row>
<row>
<entry><screen>ldt1 == ldt2, etc</screen></entry>
@@ -399,7 +441,9 @@
<row>
<entry valign="top" morerows="1"><screen>operator+, operator+=,
operator-, operator-=</screen></entry>
- <entry>Addition, subtraction, and shortcut operators for
<code>local_date_time</code> and date duration types. These include:
<code>days</code>, <code>months</code>, and <code>years</code>.</entry>
+ <entry>Addition, subtraction, and shortcut operators for
<code>local_date_time</code> and date duration types. These include:
<code>days</code>, <code>months</code>, and <code>years</code>.<sbr/>
+ <code>local_date_time</code> 和日期长度类型间的加法、减法以及相关
简写操作符。日期长度类型包括有：
+ <code>days</code>, <code>months</code>, 和
<code>years</code>.</entry>
</row>
<row>
<entry><screen>ldt + days(5), etc</screen></entry>
@@ -408,7 +452,8 @@
<row>
<entry valign="top" morerows="1"><screen>operator+, operator+=,
operator-, operator-=</screen></entry>
- <entry>Addition, subtraction, and shortcut operators for
<code>local_date_time</code> and <code>time_duration</code>.</entry>
+ <entry>Addition, subtraction, and shortcut operators for
<code>local_date_time</code> and <code>time_duration</code>.<sbr/>
+ <code>local_date_time</code> 和 <code>time_duration</code> 间的加
法、减法以及相关简写操作符。</entry>
</row>
<row>
<entry><screen>ldt + hours(5), etc</screen></entry>
@@ -419,26 +464,28 @@
<anchor id="local_date_time_tm_func" />
<bridgehead renderas="sect3">Struct tm Functions</bridgehead>
- <para>Function for converting a <code>local_date_time</code> object to a
<code>tm</code> struct is provided.</para>
+ <para>Function for converting a <code>local_date_time</code> object to a
<code>tm</code> struct is provided.<sbr/>
+ 系统提供了将 <code>local_date_time</code> 对象转换为 <code>tm</code> 结构
的函数。</para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>tm
to_tm(local_date_time)</screen></entry>
- <entry>A function for converting a <code>local_date_time</code>
object to a <code>tm</code> struct.</entry>
+ <entry>A function for converting a <code>local_date_time</code>
object to a <code>tm</code> struct.<sbr/>
+ 将 <code>local_date_time</code> 对象转换为 <code>tm</code> 结构的
函数。</entry>
</row>
<row>
<entry><screen>
-// 6am, 2005-Jul-05 local time
+// 6am, 2005-Jul-05 local time 本地时间
std::string z("EST-05EDT,M4.1.0,M10.1.0");
ptime pt(date(2005,Jul,5),
hours(10));
@@ -448,7 +495,7 @@
/* tm_year => 105
tm_mon => 6
tm_mday => 5
- tm_wday => 2 (Tuesday)
+ tm_wday => 2 (Tuesday 星期二)
tm_yday => 185
tm_hour => 6
tm_min => 0
=======================================
--- /trunk/libs/date_time/xmldoc/local_time.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/local_time.xml Wed Jan 6 17:26:22 2010
@@ -9,54 +9,70 @@
<section id="date_time.local_time"
xmlns:xi="http://www.w3.org/2001/XInclude";>
- <title>Local Time</title>
- <bridgehead renderas="sect2">Local Time System</bridgehead>
+ <title>Local Time 本地时间</title>
+ <bridgehead renderas="sect2">Local Time System 本地时间系统</bridgehead>
<para>
- <link linkend="local_intro">Introduction</link> --
- <link linkend="local_ex">Usage Examples</link>
+ <link linkend="local_intro">Introduction 简介</link> --
+ <link linkend="local_ex">Usage Examples 用例</link>
</para>
<anchor id="local_intro" />
- <bridgehead renderas="sect3">Introduction</bridgehead>
+ <bridgehead renderas="sect3">Introduction 简介</bridgehead>
<para>
- The library supports 4 main extensions for the management of local
times. This includes
+ The library supports 4 main extensions for the management of local
times. This includes <sbr/>
+ 本库支持4种对本地时间管理的主要扩展。它们包括：
<simplelist>
- <member>local_date_time -- locally adjusted time point</member>
- <member>posix_time_zone -- time zone defined by posix string
(eg: "EST10EDT,M10.5.0,M3.5.0/03")</member>
- <member>time_zone_database -- get time zones by region from .csv
file (eg: America/New York)</member>
- <member>time_zone -- abstract time zone interface</member>
+ <member>local_date_time -- locally adjusted time point 本地调整后的时
间点</member>
+ <member>posix_time_zone -- time zone defined by posix string
(eg: "EST10EDT,M10.5.0,M3.5.0/03") 由posix字符串
(如："EST10EDT,M10.5.0,M3.5.0/03")定义的时区</member>
+ <member>time_zone_database -- get time zones by region from .csv
file (eg: America/New York) 按地区从.csv文件(如：America/New York)取出时区
</member>
+ <member>time_zone -- abstract time zone interface 抽象的时区接口
</member>
</simplelist>
</para>
<para>
- Together, these extensions define a time system adjusted for recording
times related to a specific earth location. This time system utilizes all
the features and benefits of the posix_time system (see <link
linkend="date_time.posix_time">posix_time</link> for full details). It uses
a time_zone object which contains all the necessary data/rules to enable
adjustments to and from various time zones. The time_zone objects used in
date_time are handled via a
boost::shared_ptr<boost::local_time::time_zone>.
+ Together, these extensions define a time system adjusted for recording
times related to a specific earth location. This time system utilizes all
the features and benefits of the posix_time system (see <link
linkend="date_time.posix_time">posix_time</link> for full details). It uses
a time_zone object which contains all the necessary data/rules to enable
adjustments to and from various time zones. The time_zone objects used in
date_time are handled via a
boost::shared_ptr<boost::local_time::time_zone>.<sbr/>
+ 以上扩展一起定义了一个经调整的时间系统来记录与特定地理位置相关的时间。
该时间系统使用了
+ <link linkend="date_time.posix_time">posix_time</link> 时间的所有特性和
优点(详情请参见 posix_time)。
+ 它使用一个 time_zone 对象来保存按不同时区进行调整所需的数据/规则。这个
time_zone 对象被用在 date_time 中，
+ 通过一个 boost::shared_ptr<boost::local_time::time_zone> 来处理。
</para>
<para>
- The phrase "wall-clock" refers to the time that would be shown on a
wall clock in a particular time zone at any point in time. Local_time uses
a time zone object to account for differences in time zones and daylight
savings adjustments. For example: While 5:00 pm, October 10, 2004 in Sydney
Australia occurs at exactly the same instant as 3:00 am, October 10, 2004
in New York USA, it is a 14 hour difference in wall-clock times. However, a
point in time just one day later will result in a 16 hour difference in
wall-clock time due to daylight savings adjustments in both time zones. The
local_time system tracks these by means of a time point, stored as UTC, and
time_zone objects that contain all the necessary data to correctly
calculate wall-clock times.
+ The phrase "wall-clock" refers to the time that would be shown on a
wall clock in a particular time zone at any point in time. Local_time uses
a time zone object to account for differences in time zones and daylight
savings adjustments. For example: While 5:00 pm, October 10, 2004 in Sydney
Australia occurs at exactly the same instant as 3:00 am, October 10, 2004
in New York USA, it is a 14 hour difference in wall-clock times. However, a
point in time just one day later will result in a 16 hour difference in
wall-clock time due to daylight savings adjustments in both time zones. The
local_time system tracks these by means of a time point, stored as UTC, and
time_zone objects that contain all the necessary data to correctly
calculate wall-clock times.<sbr/>
+ 术语 "wall-clock" 表示在特定时区、特定时间点的时钟所显示的时间。
Local_time 使用一个 time zone
+ 对象来区分不同的时区以及夏令时的调整。例如：澳大利亚悉尼的2004年10月
10日下午5:00相当于美国纽约的
+ 2004年10月10日上午3:00, 在两个 wall-clock 时间之间有14个小时的差距。但
是，
+ 一天以后的同一个时间点将由于两个时区不同的夏令时调整而导致两个
wall-clock 时间之间的差距变为16个小时。
+ local_time 系统可以依靠保存在UTC中的时间点来跟踪这些，而 time_zone 对象
则包含了正确计算 wall-clock 时间所需的所有数据。
</para>
<anchor id="local_ex" />
- <bridgehead renderas="sect3">Usage Examples</bridgehead>
+ <bridgehead renderas="sect3">Usage Examples 用例</bridgehead>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry>Example</entry>
- <entry>Description</entry>
+ <entry>Example 例子</entry>
+ <entry>Description 说明</entry>
</row>
</thead>
<tbody>
<row>
- <entry><link
linkend="date_time.examples.simple_time_zone">Simple Time
Zone</link></entry>
- <entry>Side by side examples of Time Zone usage. Both
<type>custom_time_zone</type> and <type>posix_time_zone</type> are
shown.</entry>
+ <entry><link
linkend="date_time.examples.simple_time_zone">Simple Time Zone<sbr/>
+ 简单的时区</link></entry>
+ <entry>Side by side examples of Time Zone usage. Both
<type>custom_time_zone</type> and <type>posix_time_zone</type> are
shown.<sbr/>
+ 多个使用时区的方法的例子。包括 <type>custom_time_zone</type>
和 <type>posix_time_zone</type> 的示范。</entry>
</row>
<row>
- <entry><link linkend="date_time.examples.calc_rules">Daylight
Savings Calc Rules</link></entry>
- <entry>Simple example showing the creation of all five
<type>dst_calc_rule</type> types.</entry>
+ <entry><link linkend="date_time.examples.calc_rules">Daylight
Savings Calc Rules<sbr/>
+ 夏令时计算规则</link></entry>
+ <entry>Simple example showing the creation of all five
<type>dst_calc_rule</type> types.<sbr/>
+ 示范创建所有五个 <type>dst_calc_rule</type> 类型的简单例子。
</entry>
</row>
<row>
- <entry><link
linkend="date_time.examples.seconds_since_epoch">Seconds Since
Epoch</link></entry>
- <entry>Example that calculates the total seconds elapsed since
the epoch (1970-Jan-01) utilizing local_date_time.</entry>
+ <entry><link
linkend="date_time.examples.seconds_since_epoch">Seconds Since Epoch<sbr/>
+ 由 Epoch 起计的秒数</link></entry>
+ <entry>Example that calculates the total seconds elapsed since
the epoch (1970-Jan-01) utilizing local_date_time.<sbr/>
+ 使用 local_date_time 计算自 epoch (1970-Jan-01)起的总秒数的例
子。</entry>
</row>
</tbody>
</tgroup>
=======================================
--- /trunk/libs/date_time/xmldoc/local_time_period.xml Mon Dec 28 23:05:14
2009
+++ /trunk/libs/date_time/xmldoc/local_time_period.xml Wed Jan 6 17:26:22
2010
@@ -8,43 +8,48 @@
-->
<section id="date_time.local_time.local_time_period">
- <title>Local Time Period</title>
-
- <link linkend="local_time_period_intro">Introduction</link> --
- <link linkend="local_time_period_header">Header</link> --
- <link linkend="local_time_period_constr">Construction</link> --
- <link linkend="local_time_period_accessors">Accessors</link> --
- <link linkend="local_time_period_operators">Operators</link>
+ <title>Local Time Period 本地时间段</title>
+
+ <link linkend="local_time_period_intro">Introduction 简介</link> --
+ <link linkend="local_time_period_header">Header 头文件</link> --
+ <link linkend="local_time_period_constr">Construction 构造</link> --
+ <link linkend="local_time_period_accessors">Accessors 访问器</link> --
+ <link linkend="local_time_period_operators">Operators 操作符</link>
<anchor id="local_time_period_intro" />
- <bridgehead renderas="sect3">Introduction</bridgehead>
+ <bridgehead renderas="sect3">Introduction 简介</bridgehead>
<para>
- The class <code>boost::local_time::local_time_period</code> provides
direct representation for ranges between two local times. Periods provide
the ability to simplify some types of calculations by simplifying the
conditional logic of the program.
+ The class <code>boost::local_time::local_time_period</code> provides
direct representation for ranges between two local times. Periods provide
the ability to simplify some types of calculations by simplifying the
conditional logic of the program. <sbr/>
+ 类 <code>boost::local_time::local_time_period</code> 提供了对两个本地时
间之间的范围的直接表示。
+ 时间段可以通过简化程序的条件逻辑来简化一些计算类型。
</para>
<para>
- A period that is created with beginning and end points being equal, or
with a duration of zero, is known as a zero length period. Zero length
periods are considered invalid (it is perfectly legal to construct an
invalid period). For these periods, the <code>last</code> point will always
be one unit less that the <code>begin</code> point.
+ A period that is created with beginning and end points being equal, or
with a duration of zero, is known as a zero length period. Zero length
periods are considered invalid (it is perfectly legal to construct an
invalid period). For these periods, the <code>last</code> point will always
be one unit less that the <code>begin</code> point.<sbr/>
+ 由相同的开始点与结束点，或者由开始点与长度为零的时间长度所构建的时间
段，被称为零长度时间段。
+ 零长度时间段被认为是无效的时间段(但是构建一个无效时间段却是完全合法的
)。对于这些时间段，
+ last 时间点总是比 begin 时间点小一个时间单元。
</para>
<anchor id="local_time_period_header" />
- <bridgehead renderas="sect3">Header</bridgehead>
+ <bridgehead renderas="sect3">Header 头文件</bridgehead>
<para>
- <programlisting>#include "boost/date_time/local_time/local_time.hpp"
//include all types plus i/o
+ <programlisting>#include "boost/date_time/local_time/local_time.hpp"
//include all types plus i/o 包含所有类型和i/o
or
-#include "boost/date_time/local_time/local_time_types.hpp" //no i/o just
types</programlisting>
+#include "boost/date_time/local_time/local_time_types.hpp" //no i/o just
types 只有类型没有i/o</programlisting>
</para>
<anchor id="local_time_period_constr" />
- <bridgehead renderas="sect3">Construction</bridgehead>
+ <bridgehead renderas="sect3">Construction 构造</bridgehead>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
@@ -53,7 +58,8 @@
Parameters:
local_date_time beginning
local_date_time end</screen></entry>
- <entry> Create a period as [begin, end). If end is <= begin then
the period will be defined as invalid.</entry>
+ <entry> Create a period as [begin, end). If end is <= begin then
the period will be defined as invalid.<sbr/>
+ 创建一个 [begin, end) 的时间段。如果 end <= begin 则时间段被定义
为无效时间段。</entry>
</row>
<row>
<entry><screen>time_zone_ptr
@@ -62,7 +68,7 @@
beg(ptime(date(2005,Jan,1),hours(0)), zone);
local_date_time
end(ptime(date(2005,Feb,1),hours(0)), zone);
-// period for the entire month of Jan 2005
+// period for the entire month of Jan 2005 2005年1月整个月的时间段
local_time_period ltp(beg, end);</screen>
</entry>
</row>
@@ -72,21 +78,23 @@
Parameters:
local_date_time beginning
time_duration length</screen></entry>
- <entry>Create a period as [begin, begin+len) where end would be
begin+len. If len is <= zero then the period will be defined as
invalid.</entry>
+ <entry>Create a period as [begin, begin+len) where end would be
begin+len. If len is <= zero then the period will be defined as
invalid.<sbr/>
+ 创建一个 [begin, begin+len) 时间段，其中 end 为 begin+len. 如果
len <= 0 则时间段被定义为无效时间段。</entry>
</row>
<row>
<entry><screen>time_zone_ptr
zone(new posix_time_zone("MST-07"));
local_date_time
beg(ptime(date(2005,Jan,1),hours(0)), zone);
-// period for the whole day of 2005-Jan-01
+// period for the whole day of 2005-Jan-01 2005年1月1日整天的时间段
local_time_period ltp(beg, hours(24));</screen>
</entry>
</row>
<row>
<entry valign="top"
morerows="1"><screen>local_time_period(local_time_period
rhs)</screen></entry>
- <entry>Copy constructor</entry>
+ <entry>Copy constructor<sbr/>
+ 复制构造函数。</entry>
</row>
<row>
<entry><screen>local_time_period ltp1(ltp);</screen></entry>
@@ -98,23 +106,24 @@
<anchor id="local_time_period_accessors" />
- <bridgehead renderas="sect3">Accessors</bridgehead>
+ <bridgehead renderas="sect3">Accessors 访问器</bridgehead>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>local_date_time
begin()</screen></entry>
- <entry>Return first local_date_time of the period.</entry>
+ <entry>Return first local_date_time of the period.<sbr/>
+ 返回该时间段的第一个 local_date_time.</entry>
</row>
<row>
<entry><screen>time_zone_ptr
@@ -128,7 +137,8 @@
<row>
<entry valign="top" morerows="1"><screen>local_date_time
last()</screen></entry>
- <entry>Return last local_date_time in the period</entry>
+ <entry>Return last local_date_time in the period<sbr/>
+ 返回该时间段的最后一个 local_date_time </entry>
</row>
<row>
<entry><screen>time_zone_ptr
@@ -142,7 +152,8 @@
<row>
<entry valign="top" morerows="1"><screen>local_date_time
end()</screen></entry>
- <entry>Return one past the last in period</entry>
+ <entry>Return one past the last in period<sbr/>
+ 返回时间段的 last 之后的时间点</entry>
</row>
<row>
<entry><screen>time_zone_ptr
@@ -156,7 +167,8 @@
<row>
<entry valign="top" morerows="1"><screen>time_duration
length()</screen></entry>
- <entry>Return the length of the local_time period.</entry>
+ <entry>Return the length of the local_time period.<sbr/>
+ 返回时间段的长度。</entry>
</row>
<row>
<entry><screen>time_zone_ptr
@@ -170,7 +182,8 @@
<row>
<entry valign="top" morerows="1"><screen>bool
is_null()</screen></entry>
- <entry>True if period is not well formed. eg: end less than or equal
to begin.</entry>
+ <entry>True if period is not well formed. eg: end less than or equal
to begin.<sbr/>
+ 返回 True 如果时间段是无效的。例如：end 小于等于 begin.</entry>
</row>
<row>
<entry><screen>time_zone_ptr
@@ -186,7 +199,8 @@
<row>
<entry valign="top" morerows="1"><screen>bool
contains(local_date_time)</screen></entry>
- <entry>True if local_date_time is within the period. Zero length
periods cannot contain any points</entry>
+ <entry>True if local_date_time is within the period. Zero length
periods cannot contain any points<sbr/>
+ 返回 True 如果 local_date_time 位于时间段内。零长度时间段不能包含任
何时间点。</entry>
</row>
<row>
<entry><screen>time_zone_ptr
@@ -207,10 +221,11 @@
<row>
<entry valign="top" morerows="1"><screen>bool
contains(local_time_period)</screen></entry>
- <entry>True if period is within the period</entry>
+ <entry>True if period is within the period<sbr/>
+ 返回 True 如果给定时间段位于本时间段内。</entry>
</row>
<row>
- <entry><screen>// using jan_mst period from previous example
+ <entry><screen>// using jan_mst period from previous example 使
用前例中的 jan_mst 时间段
local_date_time
beg((ptime(date(2005,Jan,7),hours(0))), zone);
@@ -221,10 +236,11 @@
<row>
<entry valign="top" morerows="1"><screen>bool
intersects(local_time_period)</screen></entry>
- <entry> True if periods overlap</entry>
+ <entry> True if periods overlap<sbr/>
+ 返回 True 如果两个时间段交叉。</entry>
</row>
<row>
- <entry><screen>// using jan_mst period from previous example
+ <entry><screen>// using jan_mst period from previous example 使
用前例中的 jan_mst 时间段
local_date_time
beg((ptime(date(2005,Jan,7),hours(0))), zone);
@@ -237,10 +253,11 @@
<row>
<entry valign="top" morerows="1"><screen>local_time_period
intersection(local_time_period)</screen></entry>
- <entry>Calculate the intersection of 2 periods. Null if no
intersection.</entry>
+ <entry>Calculate the intersection of 2 periods. Null if no
intersection.<sbr/>
+ 计算两个时间段的交集。如果不相交则返回空。</entry>
</row>
<row>
- <entry><screen>// using jan_mst period from previous example
+ <entry><screen>// using jan_mst period from previous example 使
用前例中的 jan_mst 时间段
local_date_time
beg((ptime(date(2005,Jan,7),hours(0))), zone);
@@ -255,10 +272,11 @@
<row>
<entry valign="top" morerows="1"><screen>local_time_period
merge(local_time_period)</screen></entry>
- <entry>Returns union of two periods. Null if no
intersection.</entry>
+ <entry>Returns union of two periods. Null if no intersection.<sbr/>
+ 返回两个时间段的并集。如果不相交则返回空。</entry>
</row>
<row>
- <entry><screen>// using jan_mst period from previous example
+ <entry><screen>// using jan_mst period from previous example 使
用前例中的 jan_mst 时间段
local_date_time
beg((ptime(date(2005,Jan,7),hours(0))), zone);
@@ -273,10 +291,11 @@
<row>
<entry valign="top" morerows="1"><screen>local_time_period
span(local_time_period)</screen></entry>
- <entry>Combines two periods and any gap between them such that begin
= min(p1.begin, p2.begin) and end = max(p1.end , p2.end).</entry>
+ <entry>Combines two periods and any gap between them such that begin
= min(p1.begin, p2.begin) and end = max(p1.end , p2.end).<sbr/>
+ 合并两个时间段及其间隔，即 begin = min(p1.begin, p2.begin) 且 end
= max(p1.end , p2.end).</entry>
</row>
<row>
- <entry><screen>// using jan_mst period from previous example
+ <entry><screen>// using jan_mst period from previous example 使
用前例中的 jan_mst 时间段
local_date_time
beg((ptime(date(2005,Mar,1),hours(0))), zone);
@@ -291,7 +310,8 @@
<row>
<entry valign="top" morerows="1"><screen>void
shift(time_duration)</screen></entry>
- <entry>Add duration to both begin and end.</entry>
+ <entry>Add duration to both begin and end.<sbr/>
+ 为 begin 和 end 同时加上一个时间长度</entry>
</row>
<row>
<entry><screen>local_date_time
@@ -311,17 +331,17 @@
<anchor id="local_time_period_operators" />
- <bridgehead renderas="sect3">Operators</bridgehead>
+ <bridgehead renderas="sect3">Operators 操作符</bridgehead>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
@@ -346,7 +366,8 @@
-->
<row>
<entry valign="top" morerows="1"><screen>operator==,
operator!=</screen></entry>
- <entry>Equality operators. Periods are equal if ltp1.begin ==
ltp2.begin && ltp1.last == ltp2.last</entry>
+ <entry>Equality operators. Periods are equal if ltp1.begin ==
ltp2.begin && ltp1.last == ltp2.last<sbr/>
+ 相等性比较操作符。两个时间段相等，如果 ltp1.begin == ltp2.begin
&& ltp1.last == ltp2.last</entry>
</row>
<row>
<entry><screen>if (ltp1 == ltp2) {...</screen></entry>
@@ -354,7 +375,8 @@
<row>
<entry valign="top"
morerows="1"><screen>operator<</screen></entry>
- <entry>Ordering with no overlap. True if ltp1.end() less than
ltp2.begin()</entry>
+ <entry>Ordering with no overlap. True if ltp1.end() less than
ltp2.begin()<sbr/>
+ 无交叉的顺序比较。返回 True 如果 ltp1.end() 小于
ltp2.begin()</entry>
</row>
<row>
<entry><screen>if (ltp1 < ltp2) {...</screen></entry>
@@ -362,7 +384,8 @@
<row>
<entry valign="top"
morerows="1"><screen>operator></screen></entry>
- <entry>Ordering with no overlap. True if ltp1.begin() greater than
ltp2.end()</entry>
+ <entry>Ordering with no overlap. True if ltp1.begin() greater than
ltp2.end()<sbr/>
+ 无交叉的顺序比较。返回 True 如果 ltp1.begin() 大于
ltp2.end()</entry>
</row>
<row>
<entry><screen>if (ltp1 > ltp2) {... etc</screen></entry>
@@ -370,7 +393,8 @@
<row>
<entry valign="top" morerows="1"><screen>operator<=,
operator>=</screen></entry>
- <entry>Defined in terms of the other operators.</entry>
+ <entry>Defined in terms of the other operators.<sbr/>
+ 根据其它操作符定义。</entry>
</row>
<row>
<entry></entry>
=======================================
--- /trunk/libs/date_time/xmldoc/motivation.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/motivation.xml Wed Jan 6 17:26:22 2010
@@ -6,15 +6,25 @@
-->
<section id="Motivation">
- <title>Motivation</title>
+ <title>Motivation 动机</title>
<para>
- The motivation for this library comes from working with and helping
build several date-time libraries on several projects. Date-time libraries
provide fundamental infrastructure for most development projects. However,
most of them have limitations in their ability to calculate, format,
convert, or perform some other functionality. For example, most libraries
do not correctly handle leap seconds, provide concepts such as infinity, or
provide the ability to use high resolution or network time sources. These
libraries also tend to be rigid in their representation of dates and times.
Thus customized policies for a project or subproject are not possible.
+ The motivation for this library comes from working with and helping
build several date-time libraries on several projects. Date-time libraries
provide fundamental infrastructure for most development projects. However,
most of them have limitations in their ability to calculate, format,
convert, or perform some other functionality. For example, most libraries
do not correctly handle leap seconds, provide concepts such as infinity, or
provide the ability to use high resolution or network time sources. These
libraries also tend to be rigid in their representation of dates and times.
Thus customized policies for a project or subproject are not possible.<sbr/>
+ 本库的动机来自于在多个项目中对多个日期时间库的使用和建立。这些日期时间
库为大多数开发项目提供了基础的架构。
+ 不过，这些库中多数在它们的计算、格式化、转换或执行其它功能的能力上有所
限制。例如，许多库不能正确地处理闰秒，
+ 提供象无限这样的概念，或是提供高分辨率或网络时间源的能力。这些库还倾向
于严格规定日期和时间的表示法。这样，
+ 针对某个项目或子项目的定制策略就不可能了。
</para>
<para>
- Programming with dates and times should be almost as simple and
natural as programming with strings and integers. Applications with lots
of temporal logic can be radically simplified by having a robust set of
operators and calculation capabilities. Classes should provide the ability
to compare dates and times, add lengths or time durations, retrieve dates
and times from clocks, and work naturally with date and time intervals.
+ Programming with dates and times should be almost as simple and
natural as programming with strings and integers. Applications with lots
of temporal logic can be radically simplified by having a robust set of
operators and calculation capabilities. Classes should provide the ability
to compare dates and times, add lengths or time durations, retrieve dates
and times from clocks, and work naturally with date and time
intervals.<sbr/>
+ 在编程中使用日期和时间与在编程中使用字符串和整数几乎一样简单和自然。
+ 带有大量时间逻辑的应用程序可以通过一组健壮的操作符和计算能力得以根本性
的简化。
+ 类可以提供对日期和时间进行比较、增加时间长度、从时钟取出日期和时间，以
及自然地使用日期和时间间隔。
</para>
<para>
- Another motivation for development of the library was to apply modern
C++ library design techniques to the date-time domain. Really to build a
framework for the construction of building temporal types. For example, by
providing iterators and traits classes to control fundamental properties of
the library. To the authors knowledge this library is the only substantial
attempt to apply modern C++ to a date-time library.
+ Another motivation for development of the library was to apply modern
C++ library design techniques to the date-time domain. Really to build a
framework for the construction of building temporal types. For example, by
providing iterators and traits classes to control fundamental properties of
the library. To the authors knowledge this library is the only substantial
attempt to apply modern C++ to a date-time library.<sbr/>
+ 开发本库的另一个动机是，将现代的C++库设计技术应用于日期时间领域。为构建
时间类型真正地建立一个框架。
+ 例如，通过提供迭代器和 traits 类，来控制本库的基本属性。就作者所知而
言，
+ 本库是将现代C++理念应用于日期时间库的唯一真正的尝试。
</para>
</section>
=======================================
--- /trunk/libs/date_time/xmldoc/posix_time.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/posix_time.xml Wed Jan 6 17:26:22 2010
@@ -9,46 +9,56 @@
<section id="date_time.posix_time"
xmlns:xi="http://www.w3.org/2001/XInclude";>
- <title>Posix Time</title>
- <bridgehead renderas="sect2">Posix Time System</bridgehead>
+ <title>Posix Time Posix 时间</title>
+ <bridgehead renderas="sect2">Posix Time System Posix 时间系统
</bridgehead>
<para>
- <link linkend="posix_intro">Introduction</link> --
- <link linkend="posix_ex">Usage Examples</link>
+ <link linkend="posix_intro">Introduction 简介</link> --
+ <link linkend="posix_ex">Usage Examples 用例</link>
</para>
<anchor id="posix_intro" />
- <bridgehead renderas="sect3">Introduction</bridgehead>
+ <bridgehead renderas="sect3">Introduction 简介</bridgehead>
<para>
- Defines a non-adjusted time system with nano-second/micro-second
resolution and stable calculation properties. The nano-second resolution
option uses 96 bits of underlying storage for each ptime while the
micro-second resolution uses 64 bits per ptime (see <link
linkend="date_time.buildinfo">Build Options</link> for details). This time
system uses the Gregorian calendar to implement the date portion of the
time representation.
+ Defines a non-adjusted time system with nano-second/micro-second
resolution and stable calculation properties. The nano-second resolution
option uses 96 bits of underlying storage for each ptime while the
micro-second resolution uses 64 bits per ptime (see <link
linkend="date_time.buildinfo">Build Options</link> for details). This time
system uses the Gregorian calendar to implement the date portion of the
time representation. <sbr/>
+ 定义一个无调整的、分辨率为纳秒/微秒级的、具有稳定的计算特性的时间系统。
如果是纳秒级精度的，
+ 则每个 ptime 使用96位的底层存储，而微秒级精度则每个 ptime 使用64位存储
(详情请见
+ <link linkend="date_time.buildinfo">构建选项</link>)。该时间系统使用格
里历来实现时间表示中的日期部分。
</para>
<anchor id="posix_ex" />
- <bridgehead renderas="sect3">Usage Examples</bridgehead>
+ <bridgehead renderas="sect3">Usage Examples 用例</bridgehead>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry>Example</entry>
- <entry>Description</entry>
+ <entry>Example 例子</entry>
+ <entry>Description 说明</entry>
</row>
</thead>
<tbody>
<row>
- <entry><link linkend="date_time.examples.time_math">Time
Math</link></entry>
- <entry>A few simple calculations using ptime and
time_durations.</entry>
+ <entry><link linkend="date_time.examples.time_math">Time Math<sbr/>
+ 时间算术</link></entry>
+ <entry>A few simple calculations using ptime and
time_durations.<sbr/>
+ 几个很简单的使用 ptime 和 time_durations 的计算。</entry>
</row>
<row>
- <entry><link linkend="date_time.examples.print_hours">Print
Hours</link></entry>
- <entry>Retrieve time from clock, use a time_iterator.</entry>
+ <entry><link linkend="date_time.examples.print_hours">Print
Hours<sbr/>
+ 打印小时</link></entry>
+ <entry>Retrieve time from clock, use a time_iterator.<sbr/>
+ 从时钟取出时间，使用 time_iterator.</entry>
</row>
<row>
- <entry><link linkend="date_time.examples.local_utc_conversion">Local
to UTC Conversion</link></entry>
+ <entry><link linkend="date_time.examples.local_utc_conversion">Local
to UTC Conversion<sbr/>
+ 本地时间到 UTC 的转换</link></entry>
<entry>Demonstrates a couple different ways to convert a local to UTC
time including daylight savings rules.</entry>
</row>
<row>
- <entry><link linkend="date_time.examples.time_periods">Time
Periods</link></entry>
- <entry>Some simple examples of intersection and display of time
periods.</entry>
+ <entry><link linkend="date_time.examples.time_periods">Time
Periods<sbr/>
+ 时间段</link></entry>
+ <entry>Some simple examples of intersection and display of time
periods.<sbr/>
+ 一些简单的计算时间段的交集并打印的例子。</entry>
</row>
</tbody>
</tgroup>
=======================================
--- /trunk/libs/date_time/xmldoc/posix_time_zone.xml Mon Dec 28 23:05:14
2009
+++ /trunk/libs/date_time/xmldoc/posix_time_zone.xml Wed Jan 6 17:26:22
2010
@@ -8,95 +8,129 @@
-->
<section id="date_time.local_time.posix_time_zone">
- <title>Posix Time Zone</title>
-
- <link linkend="posix_time_zone_intro">Introduction</link> --
- <link linkend="posix_time_zone_notes">Important Notes</link> --
- <link linkend="posix_time_zone_header">Header</link> --
- <link linkend="posix_time_zone_constr">Construction</link> --
- <link linkend="posix_time_zone_accessors">Accessors</link>
+ <title>Posix Time Zone Posix时区</title>
+
+ <link linkend="posix_time_zone_intro">Introduction 简介</link> --
+ <link linkend="posix_time_zone_notes">Important Notes 重要说明</link> --
+ <link linkend="posix_time_zone_header">Header 头文件</link> --
+ <link linkend="posix_time_zone_constr">Construction 构造</link> --
+ <link linkend="posix_time_zone_accessors">Accessors 访问器</link>
<anchor id="posix_time_zone_intro" />
- <bridgehead renderas="sect3">Introduction</bridgehead>
+ <bridgehead renderas="sect3">Introduction 简介</bridgehead>
<para>
- A posix_time_zone object is a set of data and rules that provide
information about a time zone. Information such as the offset from UTC,
it's name and abbreviation, as well as daylight savings rules, called <link
linkend="date_time.local_time.dst_calc_rules">dst_calc_rules</link>. These
rules are stored as a boost::shared_ptr<dst_calc_rules>.
+ A posix_time_zone object is a set of data and rules that provide
information about a time zone. Information such as the offset from UTC,
it's name and abbreviation, as well as daylight savings rules, called <link
linkend="date_time.local_time.dst_calc_rules">dst_calc_rules</link>. These
rules are stored as a boost::shared_ptr<dst_calc_rules>.<sbr/>
+ posix_time_zone 对象是一组数据和规则，它提供了与时区有关的信息。这些信
息包括：距UTC的偏移、时区的名字和缩写，
+ 以及被称为 <link
linkend="date_time.local_time.dst_calc_rules">dst_calc_rules</link> 的夏令时
规则。
+ 这些规则被保存为一个 boost::shared_ptr<dst_calc_rules>.
</para>
<para>
- As a convenience, a typedef for shared_ptr<dst_calc_rules> is
provided.
+ As a convenience, a typedef for shared_ptr<dst_calc_rules> is
provided.<sbr/>
+ 为方便使用，系统为 shared_ptr<dst_calc_rules> 提供了一个 typedef.
<programlisting>typedef boost::shared_ptr<dst_calc_rules>
local_time::dst_calc_rule_ptr;</programlisting>
</para>
<para>
- A posix_time_zone is unique in that the object is created from a Posix
time zone string (IEEE Std 1003.1). A POSIX time zone string takes the form
of:
+ A posix_time_zone is unique in that the object is created from a Posix
time zone string (IEEE Std 1003.1). A POSIX time zone string takes the form
of:<sbr/>
+ posix_time_zone 是唯一的，因为该对象创建自一个 Posix 时区字符串(IEEE
Std 1003.1)。POSIX 时区字符串的格式如下：
<literallayout>
- "std offset dst [offset],start[/time],end[/time]" (w/no
spaces).</literallayout>'std' specifies the abbrev of the time
zone. 'offset' is the offset from UTC. 'dst' specifies the abbrev of the
time zone during daylight savings time. The second offset is how many hours
changed during DST. 'start' and 'end' are the dates when DST goes into (and
out of) effect. 'offset' takes the form of:
+ "std offset dst [offset],start[/time],end[/time]" (w/no spaces 可带或
不带空格).</literallayout>'std' specifies the abbrev of the time
zone. 'offset' is the offset from UTC. 'dst' specifies the abbrev of the
time zone during daylight savings time. The second offset is how many hours
changed during DST. 'start' and 'end' are the dates when DST goes into (and
out of) effect. 'offset' takes the form of: <sbr/>
+ 'std' 给出时区的缩写。'offset' 为距UTC的偏移。'dst' 给出时区在夏令时
的缩写。第二个 offset 表示在DST时要改变的小时数。
+ 'start' 和 'end' 为开始(和结束)DST的日期。'offset' 的格式如下：
<literallayout>
- [+|-]hh[:mm[:ss]] {h=0-23, m/s=0-59}</literallayout>'time'
and 'offset' take the same form. 'start' and 'end' can be one of three
forms:
+ [+|-]hh[:mm[:ss]] {h=0-23, m/s=0-59}</literallayout>'time'
and 'offset' take the same form. 'start' and 'end' can be one of three
forms: <sbr/>
+ 'time' 和 'offset' 具有相同的格式。'start' 和 'end' 可以是以下三种格
式之一：
<literallayout>
- Mm.w.d {month=1-12, week=1-5 (5 is always last), day=0-6}
- Jn {n=1-365 Feb29 is never counted}
- n {n=0-365 Feb29 is counted in leap years}</literallayout>
+ Mm.w.d {month=1-12, week=1-5 (5 is always last 5总是表示最后一周),
day=0-6}
+ Jn {n=1-365 Feb29 is never counted Feb29不被计算}
+ n {n=0-365 Feb29 is counted in leap years Feb29 在闰年时被计算
}</literallayout>
</para>
<para>
- Exceptions will be thrown under the following conditions:
+ Exceptions will be thrown under the following conditions: <sbr/>
+ 在以下条件下将抛出异常：
<itemizedlist>
- <listitem>An exception will be thrown for an invalid date spec (see
<link linkend="date_time.gregorian.date_class">date
class</link>).</listitem>
- <listitem>A boost::local_time::bad_offset exception will be thrown
for:</listitem>
- <listitem>A DST start or end offset that is negative or more than 24
hours.</listitem>
- <listitem>A UTC zone that is greater than +12 or less than -12
hours.</listitem>
- <listitem>A boost::local_time::bad_adjustment exception will be
thrown for a DST adjustment that is 24 hours or more (positive or
negative)</listitem>
+ <listitem>An exception will be thrown for an invalid date spec (see
<link linkend="date_time.gregorian.date_class">date class</link>).<sbr/>
+ 无效的日期表示(请见 <link
linkend="date_time.gregorian.date_class">date 类</link>)会抛出异常。
</listitem>
+ <listitem>A boost::local_time::bad_offset exception will be thrown
for:<sbr/>
+ 以下情况会抛出 boost::local_time::bad_offset 异常：</listitem>
+ <listitem>A DST start or end offset that is negative or more than 24
hours.<sbr/>
+ DST开始或结束的偏移量为负或大于24小时。</listitem>
+ <listitem>A UTC zone that is greater than +12 or less than -12
hours.<sbr/>
+ UTC时区大于 +12 或小于 -12 小时。</listitem>
+ <listitem>A boost::local_time::bad_adjustment exception will be
thrown for a DST adjustment that is 24 hours or more (positive or
negative)<sbr/>
+ DST调整量为24小时或更多(正的或负的)时将抛出
boost::local_time::bad_adjustment 异常。</listitem>
</itemizedlist>
</para>
- <para>As stated above, the 'offset' and '/time' portions of the string
are not required. If they are not given they default to 01:00 for 'offset',
and 02:00 for both occurrences of '/time'.
+ <para>As stated above, the 'offset' and '/time' portions of the string
are not required. If they are not given they default to 01:00 for 'offset',
and 02:00 for both occurrences of '/time'.<sbr/>
+ 如上所述，字符串的 'offset' 和 '/time' 部分不是必须的。如果没有给出这些部
分，则缺省的 'offset' 为 01:00，两次 '/time' 均为 02:00。
</para>
<para>
- Some examples are:
+ Some examples are:<sbr/>
+ 举例如下：
<literallayout>
"PST-8PDT01:00:00,M4.1.0/02:00:00,M10.1.0/02:00:00"
- "PST-8PDT,M4.1.0,M10.1.0"</literallayout>These two are actually the
same specification (defaults were used in the second string). This zone
lies eight hours west of GMT and makes a one hour shift forward during
daylight savings time. Daylight savings for this zone starts on the first
Sunday of April at 2am, and ends on the first Sunday of October at 2am.
+ "PST-8PDT,M4.1.0,M10.1.0"</literallayout>These two are actually the
same specification (defaults were used in the second string). This zone
lies eight hours west of GMT and makes a one hour shift forward during
daylight savings time. Daylight savings for this zone starts on the first
Sunday of April at 2am, and ends on the first Sunday of October at
2am.<sbr/>
+ 这两个字符串其实是相同的表示(第二个字符串中使用了缺省值)。该时区位于
GMT以西8小时，且在夏令时要向前调整1个小时。
+ 该时区的夏令时开始于4月第一个星期天的2am, 结束于10月第一个星期天的
2am.
<literallayout>
- "MST-7"</literallayout>This zone is as simple as it gets. This zone
lies seven hours west of GMT and has no daylight savings.
+ "MST-7"</literallayout>This zone is as simple as it gets. This zone
lies seven hours west of GMT and has no daylight savings.<sbr/>
+ 这个时区非常简单。它位于GMT以西7个小时且没有夏令时。
<literallayout>
- "EST10EDT,M10.5.0,M3.5.0/03"</literallayout>This string describes
the time zone for Sydney Australia. It lies ten hours east of GMT and makes
a one hour shift forward during daylight savings. Being located in the
southern hemisphere, daylight savings begins on the last Sunday in October
at 2am and ends on the last Sunday in March at 3am.
+ "EST10EDT,M10.5.0,M3.5.0/03"</literallayout>This string describes
the time zone for Sydney Australia. It lies ten hours east of GMT and makes
a one hour shift forward during daylight savings. Being located in the
southern hemisphere, daylight savings begins on the last Sunday in October
at 2am and ends on the last Sunday in March at 3am.<sbr/>
+ 该字符串表示了澳大利亚悉尼的时区。它位于GMT以东10个小时，其夏令时要向
前调整1个小时。由于它位于南半球，
+ 所以夏令时开始于10月最后一个星期天的2am，结束于3月最后一个星期天的
3am.
<literallayout>
- "FST+3FDT02:00,J60/00,J304/02"</literallayout>This specification
describes a fictitious zone that lies three hours east of GMT. It makes a
two hour shift forward for daylight savings which begins on March 1st at
midnight, and ends on October 31st at 2am. The 'J' designation in the
start/end specs signifies that counting starts at one and February 29th is
never counted.
+ "FST+3FDT02:00,J60/00,J304/02"</literallayout>This specification
describes a fictitious zone that lies three hours east of GMT. It makes a
two hour shift forward for daylight savings which begins on March 1st at
midnight, and ends on October 31st at 2am. The 'J' designation in the
start/end specs signifies that counting starts at one and February 29th is
never counted.<sbr/>
+ 它表示了一个位于GMT以东3个小时的假想的时区。其夏令时要向前调整2个小
时，开始于3月1日的午夜，
+ 结束于10月31日的2am. 其中的 'J' 指明 start/end 的表示从1起计且不计2月
29日。
<literallayout>
- "FST+3FDT,59,304"</literallayout>This specification is significant
because of the '59'. The lack of 'J' for the start and end dates, indicates
that the Julian day-count begins at zero and ends at 365. If you do the
math, you'll see that allows for a total of 366 days. This is fine in leap
years, but in non-leap years '59' (Feb-29) does not exist. This will
construct a valid posix_time_zone object but an exception will be thrown if
the date of '59' is accessed in a non-leap year. Ex:
+ "FST+3FDT,59,304"</literallayout>This specification is significant
because of the '59'. The lack of 'J' for the start and end dates, indicates
that the Julian day-count begins at zero and ends at 365. If you do the
math, you'll see that allows for a total of 366 days. This is fine in leap
years, but in non-leap years '59' (Feb-29) does not exist. This will
construct a valid posix_time_zone object but an exception will be thrown if
the date of '59' is accessed in a non-leap year. Ex:<sbr/>
+ 这个表示中的'59'尤其重要。在 start 和 end 日期的表示中没有 'J', 表示
天数的计数从0起计且结束于365.
+ 如果你算一下，可以算出总天数为366天。如果是闰年这没有问题，但是在非闰
年就不存在 '59' (Feb-29) 这天。
+ 所以，它将构造一个有效的 posix_time_zone 对象，但是如果在非闰年访
问 '59' 这天将会抛出异常。如：
<programlisting>posix_time_zone
leap_day(std::string("FST+3FDT,59,304"));
leap_day.dst_local_start_time(2004); // ok
-leap_day.dst_local_start_time(2003); // Exception thrown</programlisting>
+leap_day.dst_local_start_time(2003); // Exception thrown 抛出异常
</programlisting>
</para>
<para>
- The posix_time_zone objects are used via a
boost::shared_ptr<local_time::time_zone_base>. As a convenience, a
typedef for boost::shared_ptr<local_time::time_zone_base> is provided:
+ The posix_time_zone objects are used via a
boost::shared_ptr<local_time::time_zone_base>. As a convenience, a
typedef for boost::shared_ptr<local_time::time_zone_base> is
provided: <sbr/>
+ posix_time_zone 对象是通过一个
boost::shared_ptr<local_time::time_zone_base> 被使用的。
+ 为方便使用，系统提供了对
boost::shared_ptr<local_time::time_zone_base> 的 typedef:
<programlisting>typedef boost::shared_ptr<time_zone_base>
local_time::time_zone_ptr;</programlisting>
</para>
<para>
- See <link linkend="date_time.examples.simple_time_zone">Simple time
zone</link> for a side by side example of time_zone and posix_time_zone
usage.
+ See <link linkend="date_time.examples.simple_time_zone">Simple time
zone</link> for a side by side example of time_zone and posix_time_zone
usage.<sbr/>
+ 有关 time_zone 和 posix_time_zone 的用法的例子，请见 <link
linkend="date_time.examples.simple_time_zone">简单的时区</link>。
</para>
<anchor id="posix_time_zone_notes" />
- <bridgehead renderas="sect3">Important Notes</bridgehead>
+ <bridgehead renderas="sect3">Important Notes 重要说明</bridgehead>
<itemizedlist>
- <listitem>posix_time_zone objects use the standard and daylight
savings abbreviations in place of the full names (see <link
linkend="posix_time_zone_accessors">Accessors</link> below).</listitem>
- <listitem>'Jn' and 'n' date specifications can not be mixed in a
specification string. Ex: "FST+3FDT,59,J304" </listitem>
- <listitem>'n' date specification of 59 represents Feb-29. Do not
attempt to access in a non-leap year or an exception will be
thrown.</listitem>
+ <listitem>posix_time_zone objects use the standard and daylight
savings abbreviations in place of the full names (see <link
linkend="posix_time_zone_accessors">Accessors</link> below).<sbr/>
+ posix_time_zone 对象使用标准的和夏令时的缩写来代替全称(请见后面的
+ <link linkend="posix_time_zone_accessors">访问器</link>)。</listitem>
+ <listitem>'Jn' and 'n' date specifications can not be mixed in a
specification string. Ex: "FST+3FDT,59,J304" <sbr/>
+ 'Jn' 和 'n' 日期表示法不能在一个字符串中混用。
如："FST+3FDT,59,J304"</listitem>
+ <listitem>'n' date specification of 59 represents Feb-29. Do not
attempt to access in a non-leap year or an exception will be thrown.<sbr/>
+ 'n' 日期表示法中的 59 表示 Feb-29. 不要在非闰年时访问它，否则将抛出异
常。</listitem>
</itemizedlist>
<anchor id="posix_time_zone_header" />
- <bridgehead renderas="sect3">Header</bridgehead>
+ <bridgehead renderas="sect3">Header 头文件</bridgehead>
<para>
- The inclusion of a single header will bring in all boost::local_time
types, functions, and IO operators.
+ The inclusion of a single header will bring in all boost::local_time
types, functions, and IO operators.<sbr/>
+ 包含单个头文件即可引入所有 boost::local_time 类型、函数和 IO 操作符。
<programlisting>#include "boost/date_time/local_time/local_time.hpp"</programlisting>
</para>
<anchor id="posix_time_zone_constr" />
- <bridgehead renderas="sect3">Construction</bridgehead>
+ <bridgehead renderas="sect3">Construction 构造</bridgehead>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry>Syntax</entry>
- <entry>Example</entry>
+ <entry>Syntax 语法</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
@@ -112,23 +146,24 @@
</para>
<anchor id="posix_time_zone_accessors" />
- <bridgehead renderas="sect3">Accessors</bridgehead>
+ <bridgehead renderas="sect3">Accessors 访问器</bridgehead>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>std::string
dst_zone_abbrev()</screen></entry>
- <entry>Returns the daylight savings abbreviation for the
represented time zone.</entry>
+ <entry>Returns the daylight savings abbreviation for the
represented time zone.<sbr/>
+ 返回被表示时区的夏令时缩写。</entry>
</row>
<row>
<entry><screen>nyc_zone_sh_ptr->dst_zone_abbrev();
// "EDT"</screen></entry>
@@ -136,7 +171,8 @@
<row>
<entry valign="top" morerows="1"><screen>std::string
std_zone_abbrev()</screen></entry>
- <entry>Returns the standard abbreviation for the represented
time zone.</entry>
+ <entry>Returns the standard abbreviation for the represented
time zone.<sbr/>
+ 返回被表示时区的标准缩写。</entry>
</row>
<row>
<entry><screen>nyc_zone_sh_ptr->std_zone_abbrev();
// "EST"</screen></entry>
@@ -144,7 +180,8 @@
<row>
<entry valign="top" morerows="1"><screen>std::string
dst_zone_name()</screen></entry>
- <entry>Returns the daylight savings ABBREVIATION for the
represented time zone.</entry>
+ <entry>Returns the daylight savings ABBREVIATION for the
represented time zone.<sbr/>
+ 返回被表示时区的夏令时缩写。</entry>
</row>
<row>
<entry><screen>nyc_zone_sh_ptr->dst_zone_name();
// "EDT"</screen></entry>
@@ -152,7 +189,8 @@
<row>
<entry valign="top" morerows="1"><screen>std::string
std_zone_name()</screen></entry>
- <entry>Returns the standard ABBREVIATION for the represented
time zone.</entry>
+ <entry>Returns the standard ABBREVIATION for the represented
time zone.<sbr/>
+ 返回被表示时区的标准缩写。</entry>
</row>
<row>
<entry><screen>nyc_zone_sh_ptr->std_zone_name();
// "EST"</screen></entry>
@@ -160,7 +198,8 @@
<row>
<entry valign="top" morerows="1"><screen>bool
has_dst()</screen></entry>
- <entry>Returns true when time_zone's shared_ptr to
dst_calc_rules is not NULL.</entry>
+ <entry>Returns true when time_zone's shared_ptr to
dst_calc_rules is not NULL.<sbr/>
+ 返回 true 如果 time_zone 中指向 dst_calc_rules 的 shared_ptr 非
空。</entry>
</row>
<row>
<entry><screen>nyc_zone_sh_ptr->has_dst(); // true
@@ -171,7 +210,8 @@
<row>
<entry valign="top" morerows="1"><screen>
ptime dst_local_start_time(greg_year)</screen></entry>
- <entry>The date and time daylight savings time begins in given
year. Returns not_a_date_time if this zone has no daylight savings.</entry>
+ <entry>The date and time daylight savings time begins in given
year. Returns not_a_date_time if this zone has no daylight savings.<sbr/>
+ 给定年份的夏令时开始日期和时间。如果该时区没有夏令时，则返回
not_a_date_time.</entry>
</row>
<row>
<entry><screen>nyc_zone_sh_ptr->dst_local_start_time(2004);
@@ -181,7 +221,8 @@
<row>
<entry valign="top" morerows="1"><screen>
ptime dst_local_end_time(greg_year)</screen></entry>
- <entry>The date and time daylight savings time ends in given
year. Returns not_a_date_time if this zone has no daylight savings.</entry>
+ <entry>The date and time daylight savings time ends in given
year. Returns not_a_date_time if this zone has no daylight savings.<sbr/>
+ 给定年份的夏令时结束日期和时间。如果该时区没有夏令时，则返回
not_a_date_time.</entry>
</row>
<row>
<entry><screen>nyc_zone_sh_ptr->dst_local_end_time(2004);
@@ -191,7 +232,8 @@
<row>
<entry valign="top" morerows="1"><screen>
time_duration base_utc_offset()</screen></entry>
- <entry>The amount of time offset from UTC (typically in
hours).</entry>
+ <entry>The amount of time offset from UTC (typically in
hours).<sbr/>
+ 距UTC的偏移量(通常以小时数表示)。</entry>
</row>
<row>
<entry><screen>nyc_zone_sh_ptr->base_utc_offset(); //
-05:00</screen></entry>
@@ -199,7 +241,8 @@
<row>
<entry valign="top"
morerows="1"><screen>posix_time::time_duration dst_offset()</screen></entry>
- <entry>The amount of time shifted during daylight
savings.</entry>
+ <entry>The amount of time shifted during daylight
savings.<sbr/>
+ 夏令时的时间偏移量。</entry>
</row>
<row>
<entry><screen>nyc_zone_sh_ptr->dst_offset(); //
01:00</screen></entry>
@@ -207,7 +250,11 @@
<row>
<entry valign="top" morerows="1"><screen>std::string
to_posix_string()</screen></entry>
- <entry>Returns a posix time zone string representation of this
time_zone_base object. Depending on how the time_zone object was created,
the date-spec format of the string will be in either 'M' notation or 'n'
notation. Every possible date-spec that can be represented in 'J' notation
can also be represented in 'n' notation. The reverse is not true so
only 'n' notation is used for these types of date-specs. For a detailed
description of a posix time zone string see <link
linkend="date_time.local_time.posix_time_zone">posix_time_zone</link>.</entry>
+ <entry>Returns a posix time zone string representation of this
time_zone_base object. Depending on how the time_zone object was created,
the date-spec format of the string will be in either 'M' notation or 'n'
notation. Every possible date-spec that can be represented in 'J' notation
can also be represented in 'n' notation. The reverse is not true so
only 'n' notation is used for these types of date-specs. For a detailed
description of a posix time zone string see <link
linkend="date_time.local_time.posix_time_zone">posix_time_zone</link>.<sbr/>
+ 返回该 time_zone_base 对象的 posix 时区字符串表示。取决于
time_zone 对象是如何创建的，
+ 返回的字符串的日期表示格式可能是 'M' 格式或 'n' 格式。每个可以
用 'J' 格式来表示的日期都可以表示为 'n' 格式。
+ 反之则不然，所以在这些日期表示法中只使用了 'n' 格式。有关
posix 时区字符串的详细描述，
+ 请见 <link
linkend="date_time.local_time.posix_time_zone">posix_time_zone</link>.</entry>
</row>
<row>
<entry><screen>nyc_zone_sh_ptr->to_posix_string();
=======================================
--- /trunk/libs/date_time/xmldoc/ptime_class.xml Mon Dec 28 23:05:14 2009
+++ /trunk/libs/date_time/xmldoc/ptime_class.xml Wed Jan 6 17:26:22 2010
@@ -10,55 +10,59 @@
<section id="date_time.posix_time.ptime_class">
<title>Ptime</title>
- <link linkend="ptime_intro">Introduction</link> --
- <link linkend="ptime_header">Header</link> --
- <link linkend="ptime_constr">Construction</link> --
- <link linkend="ptime_from_string">Construct from String</link> --
- <link linkend="ptime_from_clock">Construct from Clock</link> --
- <link linkend="ptime_from_funcs">Construct using Conversion
functions</link> --
- <link linkend="ptime_accessors">Accessors</link> --
- <link linkend="ptime_to_string">Conversion To String</link> --
- <link linkend="ptime_operators">Operators</link> --
+ <link linkend="ptime_intro">Introduction 简介</link> --
+ <link linkend="ptime_header">Header 头文件</link> --
+ <link linkend="ptime_constr">Construction 构造</link> --
+ <link linkend="ptime_from_string">Construct from String 从字符串构造
</link> --
+ <link linkend="ptime_from_clock">Construct from Clock 从时钟构造</link>
--
+ <link linkend="ptime_from_funcs">Construct using Conversion functions 使
用转换函数进行构造</link> --
+ <link linkend="ptime_accessors">Accessors 访问器</link> --
+ <link linkend="ptime_to_string">Conversion To String 转换为字符串</link>
--
+ <link linkend="ptime_operators">Operators 操作符</link> --
<link linkend="ptime_struct_tm">Struct tm, time_t, and FILETIME
Functions</link>
<anchor id="ptime_intro" />
- <bridgehead renderas="sect3">Introduction</bridgehead>
+ <bridgehead renderas="sect3">Introduction 简介</bridgehead>
<para>
- The class boost::posix_time::ptime is the primary interface for time
point manipulation. In general, the ptime class is immutable once
constructed although it does allow assignment.
+ The class boost::posix_time::ptime is the primary interface for time
point manipulation. In general, the ptime class is immutable once
constructed although it does allow assignment. <sbr/>
+ 类 boost::posix_time::ptime 是处理时间点的主要接口。通常，ptime 类在构
造后就不再改变，不过它也允许进行赋值。
</para>
<para>
- Class ptime is dependent on <link
linkend="date_time.gregorian.date_class">gregorian::date</link> for the
interface to the date portion of a time point.
+ Class ptime is dependent on <link
linkend="date_time.gregorian.date_class">gregorian::date</link> for the
interface to the date portion of a time point. <sbr/>
+ 类 ptime 依赖于 <link
linkend="date_time.gregorian.date_class">gregorian::date</link>，作为时间点
的日期部分的接口。
</para>
<para>
- Other techniques for creating times include <link
linkend="date_time.posix_time.time_iterators">time iterators</link>.
+ Other techniques for creating times include <link
linkend="date_time.posix_time.time_iterators">time iterators</link>. <sbr/>
+ 其它创建时间的方法还包括有 <link
linkend="date_time.posix_time.time_iterators">时间迭代器</link>。
</para>
<anchor id="ptime_header" />
- <bridgehead renderas="sect3">Header</bridgehead>
+ <bridgehead renderas="sect3">Header 头文件</bridgehead>
<para>
- <programlisting>#include "boost/date_time/posix_time/posix_time.hpp"
//include all types plus i/o
+ <programlisting>#include "boost/date_time/posix_time/posix_time.hpp"
//include all types plus i/o 包含所有类型和i/o
or
-#include "boost/date_time/posix_time/posix_time_types.hpp" //no i/o just
types</programlisting>
+#include "boost/date_time/posix_time/posix_time_types.hpp" //no i/o just
types 只有类型没有i/o</programlisting>
</para>
<anchor id="ptime_constr" />
- <bridgehead renderas="sect3">Construction</bridgehead>
+ <bridgehead renderas="sect3">Construction 构造</bridgehead>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top"
morerows="1"><screen>ptime(date,time_duration)</screen></entry>
- <entry>Construct from a date and offset</entry>
+ <entry>Construct from a date and offset<sbr/>
+ 从一个日期和时间偏移进行构造。</entry>
</row>
<row>
<entry><screen>ptime t1(date(2002,Jan,10),
@@ -70,7 +74,8 @@
<row>
<entry valign="top"
morerows="1"><screen>ptime(ptime)</screen></entry>
- <entry>Copy constructor</entry>
+ <entry>Copy constructor<sbr/>
+ 复制构造函数。</entry>
</row>
<row>
<entry><screen>ptime t3(t1)</screen></entry>
@@ -78,7 +83,8 @@
<row>
<entry valign="top" morerows="1"><screen>ptime(special_values
sv)</screen></entry>
- <entry>Constructor for infinities, not-a-date-time, max_date_time,
and min_date_time</entry>
+ <entry>Constructor for infinities, not-a-date-time, max_date_time,
and min_date_time<sbr/>
+ 无限时间、无效时间、最大时间和最小时间的构造函数。</entry>
</row>
<row>
<entry><screen>ptime d1(neg_infin);
@@ -90,7 +96,9 @@
<row>
<entry valign="top" morerows="1"><screen>ptime;</screen></entry>
- <entry>Default constructor. Creates a ptime object initialized to
not_a_date_time. NOTE: this constructor can be disabled by defining
DATE_TIME_NO_DEFAULT_CONSTRUCTOR (see compiler_config.hpp)</entry>
+ <entry>Default constructor. Creates a ptime object initialized to
not_a_date_time. NOTE: this constructor can be disabled by defining
DATE_TIME_NO_DEFAULT_CONSTRUCTOR (see compiler_config.hpp)<sbr/>
+ 缺省构造函数。创建一个 ptime 对象，初始化为 not_a_date_time. 注：该
构造函数可以通过下定义
+ DATE_TIME_NO_DEFAULT_CONSTRUCTOR 来禁止(请见
compiler_config.hpp)</entry>
</row>
<row>
<entry><screen>ptime p; // p => not_a_date_time</screen></entry>
@@ -102,23 +110,25 @@
<anchor id="ptime_from_string" />
- <bridgehead renderas="sect3">Construct from String</bridgehead>
+ <bridgehead renderas="sect3">Construct from String 从字符串构造
</bridgehead>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>ptime
time_from_string(std::string)</screen></entry>
- <entry>From delimited string. NOTE: Excess digits in
fractional seconds will be dropped. Ex: "1:02:03.123456999" =>
1:02:03.123456. This behavior is affected by the precision the library is
compiled with (see <link linkend="date_time.buildinfo">Build-Compiler
Information</link>.</entry>
+ <entry>From delimited string. NOTE: Excess digits in
fractional seconds will be dropped. Ex: "1:02:03.123456999" =>
1:02:03.123456. This behavior is affected by the precision the library is
compiled with (see <link linkend="date_time.buildinfo">Build-Compiler
Information</link>).<sbr/>
+ 从带分隔的字符串进行构造。注：秒的小数部分中超出精度的部分将被
截掉。如："1:02:03.123456999" => 1:02:03.123456.
+ 该行为受编译本库时的精度所影响(请见 <link
linkend="date_time.buildinfo">构建及编译器信息</link>)</entry>
</row>
<row>
<entry><screen>std::string ts("2002-01-20 23:59:59.000");
@@ -127,7 +137,8 @@
<row>
<entry valign="top" morerows="1"><screen>ptime
from_iso_string(std::string)</screen></entry>
- <entry>From non delimited iso form string.</entry>
+ <entry>From non delimited iso form string.<sbr/>
+ 从不带分隔的字符串构造。</entry>
</row>
<row>
<entry><screen>std::string ts("20020131T235959");
@@ -140,23 +151,24 @@
<anchor id="ptime_from_clock" />
- <bridgehead renderas="sect3">Construct from Clock</bridgehead>
+ <bridgehead renderas="sect3">Construct from Clock 从时钟构造</bridgehead>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>ptime
second_clock::local_time()</screen></entry>
- <entry>Get the local time, second level resolution, based on the time
zone settings of the computer.</entry>
+ <entry>Get the local time, second level resolution, based on the time
zone settings of the computer.<sbr/>
+ 取得本地时间，秒级精度，基于计算机的时区设置。</entry>
</row>
<row>
<entry><screen>ptime t(second_clock::local_time());</screen></entry>
@@ -164,7 +176,8 @@
<row>
<entry valign="top" morerows="1"><screen>ptime
second_clock::universal_time()</screen></entry>
- <entry>Get the UTC time.</entry>
+ <entry>Get the UTC time.<sbr/>
+ 取得 UTC 时间。</entry>
</row>
<row>
<entry><screen>ptime
t(second_clock::universal_time())</screen></entry>
@@ -172,7 +185,10 @@
<row>
<entry valign="top" morerows="1"><screen>ptime
microsec_clock::local_time()</screen></entry>
- <entry>Get the local time using a sub second resolution clock. On
Unix systems this is implemented using GetTimeOfDay. On most Win32
platforms it is implemented using ftime. Win32 systems often do not
achieve microsecond resolution via this API. If higher resolution is
critical to your application test your platform to see the achieved
resolution.</entry>
+ <entry>Get the local time using a sub second resolution clock. On
Unix systems this is implemented using GetTimeOfDay. On most Win32
platforms it is implemented using ftime. Win32 systems often do not
achieve microsecond resolution via this API. If higher resolution is
critical to your application test your platform to see the achieved
resolution.<sbr/>
+ 使用次秒级精度的时钟取得本地时间。在 Unix 系统上，以 GetTimeOfDay
来实现。
+ 在大多数 Win32 平台上则以 ftime 实现。Win32 系统通常不能通过此 API
达到微秒级精度。
+ 如果你的应用程序需要更高的精度，请测试你的平台，以确定可达到的精
度。</entry>
</row>
<row>
<entry><screen>ptime
t(microsec_clock::local_time());</screen></entry>
@@ -180,7 +196,10 @@
<row>
<entry valign="top" morerows="1"><screen>ptime
microsec_clock::universal_time()</screen></entry>
- <entry>Get the UTC time using a sub second resolution clock. On Unix
systems this is implemented using GetTimeOfDay. On most Win32 platforms it
is implemented using ftime. Win32 systems often do not achieve microsecond
resolution via this API. If higher resolution is critical to your
application test your platform to see the achieved resolution.</entry>
+ <entry>Get the UTC time using a sub second resolution clock. On Unix
systems this is implemented using GetTimeOfDay. On most Win32 platforms it
is implemented using ftime. Win32 systems often do not achieve microsecond
resolution via this API. If higher resolution is critical to your
application test your platform to see the achieved resolution.<sbr/>
+ 使用次秒级精度的时钟取得 UTC 时间。在 Unix 系统上，以 GetTimeOfDay
来实现。
+ 在大多数 Win32 平台上则以 ftime 实现。Win32 系统通常不能通过此 API
达到微秒级精度。
+ 如果你的应用程序需要更高的精度，请测试你的平台，以确定可达到的精
度。</entry>
</row>
<row>
<entry><screen>ptime
t(microsec_clock::universal_time());</screen></entry>
@@ -192,23 +211,24 @@
<anchor id="ptime_from_funcs" />
- <bridgehead renderas="sect3">Construct using Conversion
Functions</bridgehead>
+ <bridgehead renderas="sect3">Construct using Conversion Functions 使用转
换函数进行构造</bridgehead>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>ptime from_time_t(time_t
t);</screen></entry>
- <entry>Converts a time_t into a ptime.</entry>
+ <entry>Converts a time_t into a ptime.<sbr/>
+ 将 time_t 转换为 ptime.</entry>
</row>
<row>
<entry><screen>ptime t = from_time_t(tt);</screen></entry>
@@ -216,7 +236,8 @@
<row>
<entry valign="top" morerows="1"><screen>ptime
from_ftime<ptime>(FILETIME ft);</screen></entry>
- <entry>Creates a ptime object from a FILETIME
structure.</entry>
+ <entry>Creates a ptime object from a FILETIME structure.<sbr/>
+ 从 FILETIME 结构创建 ptime 对象。</entry>
</row>
<row>
<entry><screen>ptime t =
from_ftime<ptime>(ft);</screen></entry>
@@ -228,23 +249,24 @@
<anchor id="ptime_accessors" />
- <bridgehead renderas="sect3">Accessors</bridgehead>
+ <bridgehead renderas="sect3">Accessors 访问器</bridgehead>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>date
date()</screen></entry>
- <entry>Get the date part of a time.</entry>
+ <entry>Get the date part of a time.<sbr/>
+ 取出时间的日期部分。</entry>
</row>
<row>
<entry><screen>date d(2002,Jan,10);
@@ -255,7 +277,8 @@
<row>
<entry valign="top" morerows="1"><screen>time_duration
time_of_day()</screen></entry>
- <entry>Get the time offset in the day.</entry>
+ <entry>Get the time offset in the day.<sbr/>
+ 取出在一天中的时间偏移。</entry>
</row>
<row>
<entry><screen>date d(2002,Jan,10);
@@ -266,7 +289,8 @@
<row>
<entry valign="top" morerows="1"><screen>bool is_infinity()
const</screen></entry>
- <entry>Returns true if ptime is either positive or negative
infinity</entry>
+ <entry>Returns true if ptime is either positive or negative
infinity<sbr/>
+ 返回 true 如果 ptime 是正的或负的无限。</entry>
</row>
<row>
<entry><screen>ptime pt(pos_infin);
@@ -275,7 +299,8 @@
<row>
<entry valign="top" morerows="1"><screen>bool
is_neg_infinity() const</screen></entry>
- <entry>Returns true if ptime is negative infinity</entry>
+ <entry>Returns true if ptime is negative infinity<sbr/>
+ 返回 true 如果 ptime 为负无限。</entry>
</row>
<row>
<entry><screen>ptime pt(neg_infin);
@@ -284,7 +309,8 @@
<row>
<entry valign="top" morerows="1"><screen>bool
is_pos_infinity() const</screen></entry>
- <entry>Returns true if ptime is positive infinity</entry>
+ <entry>Returns true if ptime is positive infinity<sbr/>
+ 返回 true 如果 ptime 为正无限。</entry>
</row>
<row>
<entry><screen>ptime pt(neg_infin);
@@ -293,7 +319,8 @@
<row>
<entry valign="top" morerows="1"><screen>bool
is_not_a_date_time() const</screen></entry>
- <entry>Returns true if value is not a ptime</entry>
+ <entry>Returns true if value is not a ptime<sbr/>
+ 返回 true 如果其值不是一个 ptime</entry>
</row>
<row>
<entry><screen>ptime pt(not_a_date_time);
@@ -302,7 +329,8 @@
<row>
<entry valign="top" morerows="1"><screen>bool is_special()
const</screen></entry>
- <entry>Returns true if ptime is any
<code>special_value</code></entry>
+ <entry>Returns true if ptime is any
<code>special_value</code><sbr/>
+ 返回 true 如果 ptime 为某个 <code>special_value</code> </entry>
</row>
<row>
<entry><screen>ptime pt(pos_infin);
@@ -320,23 +348,25 @@
<anchor id="ptime_to_string" />
- <bridgehead renderas="sect3">Conversion to String</bridgehead>
+ <bridgehead renderas="sect3">Conversion to String 转换为字符串
</bridgehead>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>std::string
to_simple_string(ptime)</screen></entry>
- <entry>To <code>YYYY-mmm-DD HH:MM:SS.fffffffff</code> string
where <code>mmm</code> 3 char month name. Fractional seconds only included
if non-zero.</entry>
+ <entry>To <code>YYYY-mmm-DD HH:MM:SS.fffffffff</code> string
where <code>mmm</code> 3 char month name. Fractional seconds only included
if non-zero.<sbr/>
+ 转换为 <code>YYYY-mmm-DD HH:MM:SS.fffffffff</code> 字符串，其
中 <code>mmm</code> 为3字符月份名。
+ 秒的小数部分仅在非零时包含。</entry>
</row>
<row>
<entry><screen>2002-Jan-01 10:00:01.123456789</screen></entry>
@@ -344,7 +374,8 @@
<row>
<entry valign="top" morerows="1"><screen>std::string
to_iso_string(ptime)</screen></entry>
- <entry>Convert to form <code>YYYYMMDDTHHMMSS,fffffffff</code>
where <code>T</code> is the date-time separator</entry>
+ <entry>Convert to form <code>YYYYMMDDTHHMMSS,fffffffff</code>
where <code>T</code> is the date-time separator<sbr/>
+ 转换为 <code>YYYYMMDDTHHMMSS,fffffffff</code> 其中
<code>T</code> 为日期-时间分隔符。</entry>
</row>
<row>
<entry><screen>20020131T100001,123456789</screen></entry>
@@ -352,7 +383,8 @@
<row>
<entry valign="top" morerows="1"><screen>std::string
to_iso_extended_string(ptime)</screen></entry>
- <entry>Convert to form
<code>YYYY-MM-DDTHH:MM:SS,fffffffff</code> where <code>T</code> is the
date-time separator</entry>
+ <entry>Convert to form
<code>YYYY-MM-DDTHH:MM:SS,fffffffff</code> where <code>T</code> is the
date-time separator<sbr/>
+ 转换为 <code>YYYY-MM-DDTHH:MM:SS,fffffffff</code> 其中
<code>T</code> 为日期-时间分隔符。</entry>
</row>
<row>
<entry><screen>2002-01-31T10:00:01,123456789</screen></entry>
@@ -364,23 +396,25 @@
<anchor id="ptime_operators" />
- <bridgehead renderas="sect3">Operators</bridgehead>
+ <bridgehead renderas="sect3">Operators 操作符</bridgehead>
<para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>operator<<,
operator>></screen></entry>
- <entry>Streaming operators. <emphasis
role="strong">Note:</emphasis> As of version 1.33, streaming operations
have been greatly improved. See <link linkend="date_time.date_time_io">Date
Time IO System</link> for more details (including exceptions and error
conditions).</entry>
+ <entry>Streaming operators. <emphasis
role="strong">Note:</emphasis> As of version 1.33, streaming operations
have been greatly improved. See <link linkend="date_time.date_time_io">Date
Time IO System</link> for more details (including exceptions and error
conditions).<sbr/>
+ 流操作符。<emphasis role="strong">注：</emphasis>和版本1.33一
样，流操作符得到了改进。
+ 详情请见 <link linkend="date_time.date_time_io">日期时间IO系统
</link>(包括异常和错误条件)。</entry>
</row>
<row>
<entry><screen>ptime pt(not_a_date_time);
@@ -396,7 +430,8 @@
operator>, operator<,
operator>=, operator<=</screen>
</entry>
- <entry>A full complement of comparison operators</entry>
+ <entry>A full complement of comparison operators<sbr/>
+ 完整的比较操作符。</entry>
</row>
<row>
<entry><screen>t1 == t2, etc</screen></entry>
@@ -404,7 +439,8 @@
<row>
<entry valign="top" morerows="1"><screen>ptime
operator+(days)</screen></entry>
- <entry>Return a ptime adding a day offset</entry>
+ <entry>Return a ptime adding a day offset<sbr/>
+ 返回加上日子偏移后的 ptime</entry>
</row>
<row>
<entry><screen>date d(2002,Jan,1);
@@ -416,7 +452,8 @@
<row>
<entry valign="top" morerows="1"><screen>ptime
operator-(days)</screen></entry>
- <entry>Return a ptime subtracting a day offset</entry>
+ <entry>Return a ptime subtracting a day offset<sbr/>
+ 返回减去日子偏移后的 ptime</entry>
</row>
<row>
<entry><screen>date d(2002,Jan,1);
@@ -428,7 +465,8 @@
<row>
<entry valign="top" morerows="1"><screen>ptime
operator+(time_duration)</screen></entry>
- <entry>Return a ptime adding a time duration</entry>
+ <entry>Return a ptime adding a time duration<sbr/>
+ 返回加上时间长度后的 ptime</entry>
</row>
<row>
<entry><screen>date d(2002,Jan,1);
@@ -439,7 +477,8 @@
<row>
<entry valign="top" morerows="1"><screen>ptime
operator-(time_duration)</screen></entry>
- <entry>Return a ptime subtracting a time duration</entry>
+ <entry>Return a ptime subtracting a time duration<sbr/>
+ 返回减去时间长度后的 ptime</entry>
</row>
<row>
<entry><screen>date d(2002,Jan,1);
@@ -450,13 +489,14 @@
<row>
<entry valign="top" morerows="1"><screen>time_duration
operator-(ptime)</screen></entry>
- <entry>Take the difference between two times.</entry>
+ <entry>Take the difference between two times.<sbr/>
+ 获得两个时间之间的差距。</entry>
</row>
<row>
<entry><screen>date d(2002,Jan,1);
ptime t1(d,minutes(5));
ptime t2(d,seconds(5));
-time_duration t3 = t2 - t1;//negative result</screen>
+time_duration t3 = t2 - t1;//negative result 结果为负</screen>
</entry>
</row>
</tbody>
@@ -466,22 +506,25 @@
<anchor id="ptime_struct_tm" />
<bridgehead renderas="sect3">Struct tm, time_t, and FILETIME
Functions</bridgehead>
- <para>Functions for converting posix_time objects to, and from,
<code>tm</code> structs are provided as well as conversion from
<code>time_t</code> and <code>FILETIME</code>.</para>
+ <para>Functions for converting posix_time objects to, and from,
<code>tm</code> structs are provided as well as conversion from
<code>time_t</code> and <code>FILETIME</code>.<sbr/>
+ 库中提供了 posix_time 对象与 <code>tm</code> 结构之间进行相互转换的函
数，还有从 <code>time_t</code> 和
+ <code>FILETIME</code> 进行转换的函数。</para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
- <entry valign="top" morerows="1">Syntax</entry>
- <entry>Description</entry>
+ <entry valign="top" morerows="1">Syntax 语法</entry>
+ <entry>Description 说明</entry>
</row>
<row>
- <entry>Example</entry>
+ <entry>Example 例子</entry>
</row>
</thead>
<tbody>
<row>
<entry valign="top" morerows="1"><screen>tm
to_tm(ptime)</screen></entry>
- <entry>A function for converting a <code>ptime</code> object to
a <code>tm</code> struct. The <code>tm_isdst</code> field is set to
-1.</entry>
+ <entry>A function for converting a <code>ptime</code> object to
a <code>tm</code> struct. The <code>tm_isdst</code> field is set to
-1.<sbr/>
+ 该函数将 <code>ptime</code> 对象转换为 <code>tm</code> 结构。其
中 <code>tm_isdst</code> 字段设为 -1.</entry>
</row>
<row>
<entry><screen>ptime pt(date(2005,Jan,1), time_duration(1,2,3));
@@ -489,7 +532,7 @@
/* tm_year => 105
tm_mon => 0
tm_mday => 1
- tm_wday => 6 (Saturday)
+ tm_wday => 6 (Saturday 星期六)
tm_yday => 0
tm_hour => 1
tm_min => 2
@@ -500,7 +543,9 @@
<row>
<entry valign="top" morerows="1"><screen>date date_from_tm(tm
datetm)</screen></entry>
- <entry>A function for converting a <code>tm</code> struct to a
<code>date</code> object. The fields: <code>tm_wday </code>, <code>tm_yday
</code>, and <code>tm_isdst</code> are ignored.</entry>
+ <entry>A function for converting a <code>tm</code> struct to a
<code>date</code> object. The fields: <code>tm_wday </code>, <code>tm_yday
</code>, and <code>tm_isdst</code> are ignored.<sbr/>
+ 该函数将 <code>tm</code> 结构转换为 <code>date</code> 对象。字段
<code>tm_wday</code>, <code>tm_yday</code>,
+ 和 <code>tm_isdst</code> 均被忽略。</entry>
</row>
<row>
<entry><screen>tm pt_tm;
@@ -517,7 +562,10 @@
<row>
<entry valign="top" morerows="1"><screen>tm
to_tm(time_duration)</screen></entry>
- <entry>A function for converting a <code>time_duration</code>
object to a <code>tm</code> struct. The fields: <code>tm_year</code>,
<code>tm_mon</code>, <code>tm_mday</code>, <code>tm_wday</code>,
<code>tm_yday</code> are set to zero. The <code>tm_isdst</code> field is
set to -1.</entry>
+ <entry>A function for converting a <code>time_duration</code>
object to a <code>tm</code> struct. The fields: <code>tm_year</code>,
<code>tm_mon</code>, <code>tm_mday</code>, <code>tm_wday</code>,
<code>tm_yday</code> are set to zero. The <code>tm_isdst</code> field is
set to -1.<sbr/>
+ 该函数将 <code>time_duration</code> 对象转换为 <code>tm</code> 结
构。字段 <code>tm_year</code>,
+ <code>tm_mon</code>, <code>tm_mday</code>, <code>tm_wday</code>,
<code>tm_yday</code> 均设为零。
+ 字段 <code>tm_isdst</code> 被设为 -1.</entry>
</row>
<row>
<entry><screen>time_duration td(1,2,3);
@@ -536,7 +584,8 @@
<row>
<entry valign="top" morerows="1"><screen>ptime
from_time_t(std::time_t)</screen></entry>
- <entry>Creates a <code>ptime</code> from the time_t parameter.
The seconds held in the time_t are added to a time point of
1970-Jan-01.</entry>
+ <entry>Creates a <code>ptime</code> from the time_t parameter.
The seconds held in the time_t are added to a time point of
1970-Jan-01.<sbr/>
+ 从 time_t 参数创建一个 <code>ptime</code>. 在 time_t 中的秒值被加
到时间点 1970-Jan-01 上。</entry>
</row>
<row>
<entry><screen>ptime pt(not_a_date_time);
@@ -548,7 +597,8 @@
<row>
<entry valign="top" morerows="1"><screen>ptime
from_ftime<ptime>(FILETIME)</screen></entry>
- <entry>A template function that constructs a <code>ptime</code>
from a FILETIME struct.</entry>
+ <entry>A template function that constructs a <code>ptime</code>
from a FILETIME struct.<sbr/>
+ 该模板函数从 FILETIME 结构构造 <code>ptime</code>.</entry>
</row>
<row>
<entry><screen>FILETIME ft;
=======================================
***Additional files exist in this changeset.***
Other related posts:
- » [boost-doc-zh] r362 committed - 翻译 date_time 库的xml文件 - boost-doc-zh
