NAME

Date::Period::Human - Human readable date periods

SYNOPSYS

    # Create the Date::Period::Human object
    my $d = Date::Period::Human->new();

    # Get a relative human readable date string
    my $s = $d->human_readable('2010-01-01 02:30:42');

    # Now $s contains the relative date

DESCRIPTION

Creates a string of relative time. This is useful when you're showing user created content, where it's nicer to show how long ago the item was posted instead of the date and time.

This also solves the problem where you don't know the timezone of the user who is viewing the item. This is solved because you show relative time instead of absolute time in most cases.

There is one case that isn't relative.

CLASS METHODS

This class contains one public class method.

new [options]

lang

The language you want to use. Default 'nl', can be 'en' for English.

today_and_now

An arrayref containing [ $year, $month, $day, $hour, $min, $sec ].

Will be used as the fixed point from which the relative time will be calculated.

METHODS

This class contains one public method.

$self->human_readable($mysql_date|$datetime)

Parses the $mysql_date and returns a human readable time string.

Or, $datetime (a DateTime object) and returns a human readable time string.

HOMEPAGE

http://github.com/pstuifzand/date-period-human

AUTHOR

Peter Stuifzand <peter@stuifzand.eu>

COPYRIGHT

Copyright 2010 Peter Stuifzand