Time::Duration::Parse(3pm)				User Contributed Perl Documentation				Time::Duration::Parse(3pm)

NAME

       Time::Duration::Parse - Parse string that represents time duration

SYNOPSIS

	 use Time::Duration::Parse;

	 my $seconds = parse_duration("2 minutes and 3 seconds"); # 123

DESCRIPTION

       Time::Duration::Parse is a module to parse human readable duration strings like 2 minutes and 3 seconds to seconds.

       It does the opposite of duration_exact function in Time::Duration and is roundtrip safe. So, the following is always true.

	 use Time::Duration::Parse;
	 use Time::Duration;

	 my $seconds = int rand 100000;
	 is( parse_duration(duration_exact($seconds)), $seconds );

FUNCTIONS

       parse_duration
	     $seconds = parse_duration($string);

	   Parses duration string and returns seconds. When it encounters an error in a given string, it dies an exception saying "Unknown
	   timespec: blah blah blah". This function is exported by default.

AUTHOR

       Tatsuhiko Miyagawa <miyagawa@bulknews.net>

COPYRIGHT

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

       Some internal code is taken from Cache and Cache::Cache modules on CPAN.

SEE ALSO

       Date::Manip, DateTime::Format::Duration, <http://use.perl.org/~miyagawa/journal/30310>

perl v5.10.0							    2008-06-02						Time::Duration::Parse(3pm)