NAME

DateTimeX::Format::Ago - I should have written this module "3 years ago"

SYNOPSIS

my $then = DateTime->now->subtract(days => 3);
say DateTimeX::Format::Ago->format_datetime($then); # "3 days ago"

DESCRIPTION

Ever wished DateTime::Format::Natural had a format_datetime method? This module provides human-friendly datetime formatting, outputting strings like "3 days ago".

Primary use case: websites that show a list of a person's recent activities.

Constructor

new(language => $lang)

Creates a formatter object for the given language (a BCP47 language code). If the language is omitted, extracts it from $ENV{LANG}.

Decent English ('en'), German ('de') and French ('fr') support is provided. Portuguese ('pt') and Castillian Spanish ('es') are also provided, but some of the strings were translated with Google Translate, so they might not be perfect.

Methods

format_datetime($dt)

Returns something like "3 days ago", "just now" or "hace un año".

parse_datetime($string)

Croaks. Don't use this.

BUGS

Please report any bugs to http://rt.cpan.org/Dist/Display.html?Queue=DateTimeX-Format-Ago.

I'm actively seeking translations. Feel free to attach patches for other languages as bug reports.

SEE ALSO

DateTime, DateTime::Format::Natural.

http://www.rfc-editor.org/rfc/bcp/bcp47.txt.

AUTHOR

Toby Inkster <tobyink@cpan.org>.

COPYRIGHT AND LICENCE

This software is copyright (c) 2011 by Toby Inkster.

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

DISCLAIMER OF WARRANTIES

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.