oracular (3) Time::Human.3pm.gz

Provided by: libtime-human-perl_1.03-6_all bug

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.


USAGE
   Import Parameters
       This module accepts no arguments to it's "import" method (actually, it doesn't
               even have an import "method").

   Exports
       This module exports a single symbols, the "humanize" function.


CREDITS
       Simon Cozens (SIMON) for originally creating this module.

       Ricardo SIGNES (RJBS) for being inhumanly patient in waiting for me to apply a one line whitespace
       trimming patch.

       Everyone at the DateTime "Asylum".


SUPPORT
       Support for this module is provided via the datetime@perl.org email list. See http://lists.perl.org/ for
       more details


AUTHOR
       Simon Cozens, "simon@cpan.org"


CURRENT MAINTAINER
       Joshua Hoblitt, "jhoblitt@cpan.org"


       Copyright (C) 2006-2007  Joshua Hoblitt.  All rights reserved.  Copyright (C) 2001-2002(???)  Simon
       Cozens.

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

       The full text of the license can be found in the LICENSE file included with this module, or in
       perlartistic and perlgpl Pods as supplied with Perl 5.8.1 and later.


SEE ALSO
       DateTime, DateTime::Format::Human