Sébastien Aperghis-Tramoni > Time-Duration-fr-1.01 > Time::Duration::fr

Download:
Time-Duration-fr-1.01.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 1.01   Source  

NAME ^

Time::Duration::fr - describe time duration in French

VERSION ^

Version 0.01

SYNOPSIS ^

    use Time::Duration::fr;

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

DESCRIPTION ^

Time::Duration::fr 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 minutes et 10 secondes"

    duration(243550)    => "2 jours et 20 heures"
    duration(243550, 1) => "3 jours"
    duration(243550, 3) => "2 jours, 19 heures, et 39 minutes"
    duration(243550, 4) => "2 jours, 19 heures, 39 minutes, et 10 secondes"
duration_exact($seconds)

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

Example:

    duration_exact(31629659) => "1 année, 1 jour, 2 heures, et 59 secondes"
ago($seconds)
ago($seconds, $precision)
ago_exact($seconds)

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

Examples:

    ago(243550)         => "il y a 2 jours et 20 heures"
    ago(243550, 1)      => "il y a 3 jours"
    ago_exact(243550)   => "il y a 2 jours, 19 heures, 39 minutes, et 10 secondes"

    ago(0)              => "maintenant"

    ago(-243550)        => "dans 2 jours et 20 heures"
    ago(-243550, 1)     => "dans 3 jours"
from_now($seconds)
from_now($seconds, $precision)
from_now_exact($seconds)

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

Examples:

    from_now(243550)    => "dans 2 jours et 20 heures"
    from_now(243550, 1) => "dans 3 jours"

    from_now(0)         => "maintenant"

    from_now(-243550)   => "il y a 2 jours et 20 heures"
    from_now(-243550, 1)=> "il y a 3 jours"
later($seconds)
later($seconds, $precision)
later_exact($seconds)

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

Examples:

    later(243550)       => "2 jours et 20 heures plus tard"
    later(243550, 1)    => "3 jours plus tard"

    later(0)            => "maintenant"

    later(-243550)      => "2 jours et 20 heures plus tôt"
    later(-243550, 1)   => "3 jours plus tôt"
earlier($seconds)
earlier($seconds, $precision)
earlier_exact($seconds)

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

Examples:

    earlier(243550)     => "2 jours et 20 heures plus tôt"
    earlier(243550, 1)  => "3 jours plus tôt"

    earlier(0)          => "maintenant"

    earlier(-243550)    => "2 jours et 20 heures plus tard"
    earlier(-243550, 1) => "3 jours plus tard"
concise( function( ... ) )

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

Examples:

    ago(4567)           => "il y a 1 heure et 16 minutes"
    concise(ago(4567))  => "il y a 1h16m"

    earlier(31629659)           => "1 année et 1 jour plus tôt"
    concise(earlier(31629659))  => "1a1j plus tôt"

SEE ALSO ^

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

AUTHOR ^

Sébastien Aperghis-Tramoni <sebastien at aperghis.net>

BUGS ^

Please report any bugs or feature requests to bug-time-duration-fr at rt.cpan.org, or through the web interface at http://rt.cpan.org/Public/Dist/Display.html?Dist=Time-Duration-fr. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT ^

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

    perldoc Time::Duration::fr

You can also look for information at:

COPYRIGHT & LICENSE ^

Copyright 2010 Sébastien Aperghis-Tramoni, all rights reserved.

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

syntax highlighting: