Time::Duration::Parse.3pm

Langue: en

Autres versions - même langue

Version: 2008-06-02 (debian - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

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> 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>