File: posix_time.xml

package info (click to toggle)
boost1.88 1.88.0-1
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 576,932 kB
  • sloc: cpp: 4,149,234; xml: 136,789; ansic: 35,092; python: 33,910; asm: 5,698; sh: 4,604; ada: 1,681; makefile: 1,633; pascal: 1,139; perl: 1,124; sql: 640; yacc: 478; ruby: 271; java: 77; lisp: 24; csh: 6
file content (65 lines) | stat: -rw-r--r-- 2,518 bytes parent folder | download | duplicates (20)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
<?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>