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