Tatsuhiko Miyagawa > Time-Duration-Parse-0.06 > Time::Duration::Parse

Download:
Time-Duration-Parse-0.06.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 0.06   Source   Latest Release: Time-Duration-Parse-0.11

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

syntax highlighting: