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


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

the DateTime manpage, 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