NAME
    DateTime::Format::Natural - Create machine readable date/time with
    natural parsing logic

SYNOPSIS
     use DateTime::Format::Natural;

     $parse = DateTime::Format::Natural->new();

     $dt = $parse->parse_datetime($date_string);

DESCRIPTION
    "DateTime::Format::Natural" consists of a method, "parse_datetime()",
    which takes a string with a human readable date/time and creates a
    machine readable one by applying natural parsing logic.

FUNCTIONS
  new
    Creates a new DateTime::Format::Natural object.

     $parse = DateTime::Format::Natural->new(lang => '[en|de]');

    "lang" contains the language selected, currently limited to "en"
    (english) & "de" (german).

  parse_datetime
    Creates a "DateTime" object from a human readable date/time string.

     $dt = $parse->parse_datetime($date_string);

     $dt = $parse->parse_datetime(string => $date_string, debug => 1);

    The options may contain the keys "string", & "debug". "string" may
    consist of the datestring, whereas "debug" holds the boolean value for
    the debugging option. If debugging is enabled, each token that is
    analysed will be output to stdout with a trailing newline.

    The "string" parameter is required.

    Returns a "DateTime" object.

EXAMPLES
    See the modules "DateTime::Format::Natural::Lang::*" for a overview of
    valid input.

  format_datetime
    Not implemented yet.

SEE ALSO
    DateTime, Date::Calc, <http://datetime.perl.org/>

AUTHOR
    Steven Schubiger <schubiger@cpan.org>

LICENSE
    This program is free software; you may redistribute it and/or modify it
    under the same terms as Perl itself.

    See <http://www.perl.com/perl/misc/Artistic.html>