Time::Normalize version 0.02
============================

This module is no big deal.  It doesn't do anything flashy, or
revolutionary, or even difficult.  It simply provides some functions
that aid in parsing date/time values, by taking various input values
and normalizing them into standard, ready-to-use values.

This module is meant to be used as an aid for checking and
reformatting sloppy input values from dubious sources.  But it also
can be used simply to transform or reformat known-good time and date
values as well.


EXAMPLES

 ($y, $m, $d) = normalize_ymd (2005, 'jan', 7);
 # Returns '2005', '01', '07'.

 ($y, $m, $d, $w, $wn, $wn3, $mn, $mn3) = normalize_ymd ('05', 1, 7);
 # Returns '2005', '01', '07', 3, 'Friday', 'Fri', 'January', 'Jan'.

 ($h24, $m, $s, $h12, $am) = normalize_hms (13, 45);
 # Returns '13', '45', '00', 1, 'p'

 ($h24, $m, $s, $h12, $am) = normalize_hms (11, 45, undef, 'P.M.');
 # Returns '23', '45', '00', 11, 'p'

 ($y, $m, $d) = normalize_ymd (2005, 'February', 29);
 # Throws an error: Invalid day "29"

DEVELOPMENT STATE

This is a brand-new module.  It has a decent test suite, and no known
bugs, but it has not been extensively field-tested.  So use with
caution.

If you find any bugs, or if any behavior of Time::Normalize surprises
you, I would be grateful if you would send me an email message about
it.  Thanks.


INSTALLATION

To install this module, do the standard Perl module four-step:

   perl Makefile.PL    or    perl Makefile.pl LIB='my/install/path'
   make
   make test
   make install

DEPENDENCIES

This module requires these other modules and libraries:

  POSIX
  I18N::Langinfo  (optional)
  Test::More      (used by the test suite only)


COPYRIGHT AND LICENSE

Eric J. Roode, roode@cpan.org

Copyright (c) 2005 by Eric J. Roode. All Rights Reserved.
This module is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.

To avoid my spam filter, please include "Perl", "module", or this
module's name in the message's subject line, and/or GPG-sign your
message.