NAME

Time::Human - Convert localtime() format to "speaking clock" time

SYNOPSIS

use Time::Human;
print "The time is now ", humanize(localtime());

DESCRIPTION

This module provides a "vague" rendering of the time into natural language; it's originally intended for text-to-speech applications and other speech-based interfaces.

It's fully internationalised: if you look at the code, you'll see a global variable called %Time::Human::templates, which you can fill in for other languages. If you do multinationalise it, please send me templates for other languages to be added to future releases. You can set the default language via the global variable $Time::Human::Language

$Time::Human::Evening and $Time::Human::Night decide the hours at which afternoon turns to evening and evening turns to night in your culture. For instance, Greeks may want evening to start at 11pm; for hackers, evening may start at 3am.

EXPORT

humanize is exported.

LICENSE

This module may be distributed under the same terms as Perl itself, that is, GPL or Artistic license at your choice. This software is a gift, not a burden, and as such is totally unsupported. I'll take patches gladly but reserve the right to ignore support email about it.

AUTHOR

Simon Cozens, simon@cpan.org

SEE ALSO

perl(1).