Time::Normalize version 0.06
============================

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

I have used this module for about a year and a half, and it seems
to be reasonably stable.  I will upgrade its version number to 1.0
sometime in the next six months, unless I get feature requests or
bug reports.

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 type the following:

   perl Build.PL
   perl Build
   perl Build test
   perl Build install

If you do not have Module::Build, you can use the older steps:

   perl Makefile.PL
   make
   make test
   make install

On Windows, you will need to use nmake instead of make.

DEPENDENCIES

This module requires these other modules and libraries:

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


COPYRIGHT AND LICENSE

Eric J. Roode, roode@cpan.org

Copyright (c) 2005-2008 by Eric J. Roode. All Rights Reserved.
This module is free software; See the copyright notice in the
module source code for full details.

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.
