NAME

Time::Duration::pl - Describe time duration in Polish

VERSION

version 0.003

SYNOPSIS

use Time::Duration::pl;

my $duration = duration(time() - $start_time);

DESCRIPTION

Time::Duration::pl is a localized version of Time::Duration.

FUNCTIONS

• duration($seconds)

• duration($seconds, $precision)

  Returns English text expressing the approximate time duration of abs($seconds), with at most $precision || 2 expressed units.

  Examples:

    duration(130)       => '2 minuty i 10 sekund'
  
    duration(243550)    => '2 dni i 20 godzin'
    duration(243550, 1) => '3 dni'
    duration(243550, 3) => '2 dni, 19 godzin i 39 minut'
    duration(243550, 4) => '2 dni, 19 godzin, 39 minut i 10 sekund'
  

• duration_exact($seconds)

  Same as duration($seconds), except that the returned value is an exact (unrounded) expression of $seconds.

  Example:

    duration_exact(31629659) => '1 rok, 1 dzień, 2 godziny i 59 sekund'
  

• ago($seconds)

• ago($seconds, $precision)

• ago_exact($seconds)

  Negative values are passed to from_now() / from_now_exact().

  Examples:

    ago(243550)         => '2 dni i 20 godzin temu'
    ago(243550, 1)      => '3 dni temu'
    ago_exact(243550)   => '2 dni, 19 godzin, 39 minut i 10 sekund temu'
  
    ago(0)              => 'teraz'
  
    ago(-243550)        => 'za 2 dni i 20 godzin'
    ago(-243550, 1)     => 'za 3 dni'
  

• from_now($seconds)

• from_now($seconds, $precision)

• from_now_exact($seconds)

  Negative values are passed to ago() / ago_exact().

  Examples:

    from_now(243550)    => 'za 2 dni i 20 godzin'
    from_now(243550, 1) => 'za 3 dni'
  
    from_now(0)         => 'teraz'
  
    from_now(-243550)   => '2 dni i 20 godzin temu'
    from_now(-243550, 1)=> '3 dni temu'
  

• later($seconds)

• later($seconds, $precision)

• later_exact($seconds)

  Negative values are passed to ago() / ago_exact().

  Examples:

    later(243550)       => '2 dni i 20 godzin później'
    later(243550, 1)    => '3 dni później'
  
    later(0)            => 'teraz'
  
    later(-243550)      => '2 dni i 20 godzin wcześniej'
    later(-243550, 1)   => '3 dni wcześniej'
  

• earlier($seconds)

• earlier($seconds, $precision)

• earlier_exact($seconds)

  Negative values are passed to ago() / ago_exact().

  Examples:

    earlier(243550)     => '2 dni i 20 godzin wcześniej'
    earlier(243550, 1)  => '3 dni wcześniej'
  
    earlier(0)          => 'teraz'
  
    earlier(-243550)    => '2 dni i 20 godzin później'
    earlier(-243550, 1) => '3 dni później'
  

• concise(...)

  concise() takes the string output of one of the above functions and makes it more concise.

  Examples:

    ago(4567)           => '1 godzina i 16 minut temu'
    concise(ago(4567))  => '1g16m temu'
  
    earlier(31629659)           => '1 rok i 1 dzień wcześniej'
    concise(earlier(31629659))  => '1r1d wcześniej'
  

CREDITS

The code was first copied from Time::Duration::fr by Sébastien Aperghis-Tramoni.

SEE ALSO

Time::Duration, Time::Duration::Locale

BUGS

Please report any bugs or feature requests through the web interface at https://github.com/Xaerxess/Time-Duration-pl/issues.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc Time::Duration::pl

AUTHOR

Grzegorz Rożniecki xaerxess@gmail.com

COPYRIGHT AND LICENSE

This software is copyright (c) 2013 by Grzegorz Rożniecki.

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