NAME

Mojolicious::Plugin::Human - Helpers to print values as human readable form.

SYNOPSIS

    $self->plugin('Human', {

        # Set money parameters if you need
        money_delim => ",",
        money_digit => " ",

        # Local format for date and time strings
        datetime    => '%d.%m.%Y %H:%M',
        time        => '%H:%M:%S',
        date        => '%d.%m.%Y',

        phone_country   => 1,
    });

    # Controllers

    $self->human_datetime( time );

    # Templates

    # return '2015-05-23 13:63'
    %= human_datetime '2015-05-23 13:63:67 +0400'

DESCRIPTION

You can use this module in Mojo template engine to make you users happy.

CONFIGURATION

money_format

Set printf like money format. Default %.2f

money_delim

Set format for human readable delimiter of money. Default: .

money_digit

Set format for human readable digits of money. Default: ,

datefull

Set full format for human readable date and time. Default: %F %T

datetime

Set format for human readable date and time. Default: %F %H:%M

time

Set format for human readable time. Default: %H:%M:%S

date

Set format for human readable date. Default: %F

tz

Set default time zone for DateTime. Default: local

tz_force

Force use time zone

tz_cookie

Set default cookie name for extract time zone from client. Default: tz

interval_format

Set default time format for intervals. Default : %0.2d:%0.2d:%0.2d

phone_country

Set country code for phones functions. Default: 7

suffix_one

Set default suffix for 1 value. DEPRICATED!

suffix_two

Set default suffix for value between 2 and 5. DEPRICATED!

suffix_many

Set default suffix for other values. DEPRICATED!

cut_length

Set default max length for human_cut. Default: 8

DATE AND TIME HELPERS

str2datetime $str, $tz

Get string or number, return DateTime object. Optional get $tz timezone.

str2time $str, $tz

Get string, return timestamp. Optional get $tz timezone.

strftime $str, $tz

Get string, return formatted string. Optional get $tz timezone.

human_datetime $str, $tz

Get string, return date and time string in human readable form. Optional get $tz timezone.

human_time $str, $tz

Get string, return time string in human readable form. Optional get $tz timezone.

human_date $str, $tz

Get $str string, return date string in human readable form. Optional get $tz timezone.

human_interval $sec

Get count of seconds and return interval human readable form.

MONEY HELPERS

human_money $str

human_money $format, $str

Get number, return money string in human readable form with levels.

human_money_short $str

human_money_short $format, $str

Like human_money but discard zeros.

PHONE HELPERS

flat_phone $str, $country

Get srtring, return flat phone string.

human_phone $str, $country, $add

Get srtring, return phone string in human readable form.

human_phones $str, $country, $add

Get srtring, return phones (if many) string in human readable form.

TEXT HELPERS

human_suffix $str, $count, $one, $two, $many

Get word base form and add some of suffix ($one, $two, $many) depends of $count DEPRICATED!

human_suffix_ru $count, $one, $two, $many

Get word form for ($one, $two, $many) depends of $count

human_cut $str, $length

Return string cut off $length and ellipsis in the end.

DISTANCE HELPERS

human_distance $dist

Return distance, without fractional part if possible.

AUTHORS

Dmitry E. Oboukhov <unera@debian.org>, Roman V. Nikolaev <rshadow@rambler.ru>

COPYRIGHT

Copyright (C) 2011 Dmitry E. Oboukhov <unera@debian.org> Copyright (C) 2011 Roman V. Nikolaev <rshadow@rambler.ru>

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.

cpanm Mojolicious::Plugin::Human

perl -MCPAN -e shell
install Mojolicious::Plugin::Human