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

SYNOPSIS
     use DateTime::Natural::Parse qw(natural_parse);

     $dt = natural_parse($date_string);

DESCRIPTION
    "DateTime::Natural::Parse" exports a function, "natural_parse()", by
    default which takes a string with a human readable date/time and creates
    a machine readable one by applying natural parsing logic.

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

     $dt = natural_parse($date_string);

     $dt = natural_parse($date_string, { debug => 1 });

    The options hash may contain the string 'debug' with a boolean value
    (0/1). Will output each token that is analysed with a trailing newline.

    Returns a "DateTime" object.

EXAMPLES
    Below are some examples of human readable date/time input:

  Simple
     thursday
     november
     friday 13:00
     mon 2:35
     4pm
     6 in the morning
     friday 1pm
     sat 7 in the evening
     yesterday
     today
     tomorrow
     this tuesday
     next month
     this morning
     this second
     yesterday at 4:00
     last friday at 20:00
     last week tuesday
     tomorrow at 6:45pm
     afternoon yesterday
     thursday last week

  Complex
     3 years ago
     5 months before now
     7 hours ago
     7 days from now
     in 3 hours
     1 year ago tomorrow
     3 months ago saturday at 5:00pm

SEE ALSO
    DateTime, <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>

