<?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.posix_time"
  xmlns:xi="http://www.w3.org/2001/XInclude">
  <title>Posix Time</title>
  <bridgehead renderas="sect2">Posix Time System</bridgehead>
  <para>
    <link linkend="posix_intro">Introduction</link> -- 
    <link linkend="posix_ex">Usage Examples</link>
  </para>  
  
  <anchor id="posix_intro" />
  <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. 
  </para>

  <anchor id="posix_ex" />
  <bridgehead renderas="sect3">Usage Examples</bridgehead>
  <para>
    <informaltable frame="all">
      <tgroup cols="2">
	<thead>
	  <row>
	    <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>
	  </row>
	  <row>
	    <entry><link linkend="date_time.examples.print_hours">Print Hours</link></entry>
	    <entry>Retrieve time from clock, use a time_iterator.</entry>
	  </row>
	  <row>
	    <entry><link linkend="date_time.examples.local_utc_conversion">Local to UTC Conversion</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>
	  </row>
	</tbody>
      </tgroup>
    </informaltable>
  </para>
  
  <xi:include href="ptime_class.xml" />
  <xi:include href="time_duration.xml" />
  <xi:include href="time_period.xml" />
  <xi:include href="time_iterators.xml" />
  <!-- includes here -->
  
</section>

