1<?xml version="1.0" encoding="utf-8"?> 2<!DOCTYPE library PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" 3"../../../tools/boostbook/dtd/boostbook.dtd"> 4 5<!-- Copyright (c) 2001-2004 CrystalClear Software, Inc. 6 Subject to the Boost Software License, Version 1.0. 7 (See accompanying file LICENSE_1_0.txt or http://www.boost.org/LICENSE_1_0.txt) 8--> 9 10<section id="date_time.posix_time" 11 xmlns:xi="http://www.w3.org/2001/XInclude"> 12 <title>Posix Time</title> 13 <bridgehead renderas="sect2">Posix Time System</bridgehead> 14 <para> 15 <link linkend="posix_intro">Introduction</link> -- 16 <link linkend="posix_ex">Usage Examples</link> 17 </para> 18 19 <anchor id="posix_intro" /> 20 <bridgehead renderas="sect3">Introduction</bridgehead> 21 <para> 22 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. 23 </para> 24 25 <anchor id="posix_ex" /> 26 <bridgehead renderas="sect3">Usage Examples</bridgehead> 27 <para> 28 <informaltable frame="all"> 29 <tgroup cols="2"> 30 <thead> 31 <row> 32 <entry>Example</entry> 33 <entry>Description</entry> 34 </row> 35 </thead> 36 <tbody> 37 <row> 38 <entry><link linkend="date_time.examples.time_math">Time Math</link></entry> 39 <entry>A few simple calculations using ptime and time_durations.</entry> 40 </row> 41 <row> 42 <entry><link linkend="date_time.examples.print_hours">Print Hours</link></entry> 43 <entry>Retrieve time from clock, use a time_iterator.</entry> 44 </row> 45 <row> 46 <entry><link linkend="date_time.examples.local_utc_conversion">Local to UTC Conversion</link></entry> 47 <entry>Demonstrates a couple different ways to convert a local to UTC time including daylight savings rules.</entry> 48 </row> 49 <row> 50 <entry><link linkend="date_time.examples.time_periods">Time Periods</link></entry> 51 <entry>Some simple examples of intersection and display of time periods.</entry> 52 </row> 53 </tbody> 54 </tgroup> 55 </informaltable> 56 </para> 57 58 <xi:include href="ptime_class.xml" /> 59 <xi:include href="time_duration.xml" /> 60 <xi:include href="time_period.xml" /> 61 <xi:include href="time_iterators.xml" /> 62 <!-- includes here --> 63 64</section> 65 66