README
1Package DateTime::Precise version 1.05
2
3This is the DateTime::Precise package. This module provides for the
4representation and manipulation of (almost) arbitrary locations in
5time including fractional seconds.
6
7DateTime::Precise.pm is not intended to be a replacement for any of
8the existing Date:: or Time:: modules, but you may find it useful as a
9supplement. Notable features:
10
11 * Date and time can include fractional seconds.
12
13 * Date is represented internally by an array of year, month, day,
14 hours, minutes, seconds, and fractional seconds. Using this method,
15 dates as far back as the start of the Gregorian calendar) can be
16 used.
17
18 * Methods are provided for doing date/time calculations.
19 Increment and decrement, as well as round, floor and ceil
20 functions by unit (second through year) are provided, as well as
21 simple date-difference operations.
22
23 * Methods are provided for input from and output to user-specified
24 formats (dprintf, dscanf, get_time, set_time, strftime).
25
26This module is based on the DateTime module written by Greg Fast
27(gdfast@usgs.gov).
28
29REQUIREMENTS
30
31 * Perl 5.004_04 or greater.
32
33AVAILABILITY
34
35The latest version of this package is available for download from a CPAN
36(Comprehensive Perl Archive Network) site near your at
37
38 http://www.perl.com/CPAN/authors/id/B/BZ/BZAJAC/
39
40INSTALLATION
41
42In order to use this package you will need Perl version 5.004_04 or
43better. Once that is completed, you install DateTime::Precise as you
44would install any perl module library, by running these commands:
45
46 perl Makefile.PL
47 make
48 make test
49 make install
50
51If you want to install a private copy of this package in some other
52directory, then you should try to produce the initial Makefile with
53something like this command:
54
55 perl Makefile.PL LIB=~/perl
56
57DOCUMENTATION
58
59See the CHANGES file for a list of recent changes. POD style
60documentation is included in all modules and scripts. These are
61normally converted to manual pages end installed as part of the "make
62install" process. You should also be able to use the 'perldoc'
63utility to extract documentation from the module files directly.
64
65IMPLEMENTATION
66
67This package is based on the DateTime package written by Greg Fast
68<gdfast@usgs.gov>. The _week_of_year routine is based on the
69Date_WeekOfYear routine from the Date::DateManip package written by
70Sullivan Beck.
71
72Instead of using the string representation used in the original DateTime
73package, this package represents the time internally as a seven element
74array, where the elements correspond to the year, month, day, hours,
75minutes, seconds, and fractional seconds.
76
77AUTHOR, COMMENTS, AND BUGS
78
79I welcome all comments and bug reports. Please email them to
80Blair Zajac <blair@orcaware.com>.
81