.\" Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.if !\nF .nr F 0
.if \nF>0 \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    if !\nF==2 \{\
.        nr % 0
.        nr F 2
.    \}
.\}
.\" ========================================================================
.\"
.IX Title "Human 3pm"
.TH Human 3pm "2017-11-10" "perl v5.26.1" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Time::Human \- Convert localtime() format to "speaking clock" time
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 2
\&  use Time::Human;
\&  print "The time is now ", humanize(localtime());
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This module provides a \*(L"vague\*(R" rendering of the time into natural
language; it's originally intended for text-to-speech applications
and other speech-based interfaces.
.PP
It's fully internationalised: if you look at the code, you'll see a
global variable called \f(CW%Time::Human::templates\fR, 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
\&\f(CW$Time::Human::Language\fR
.PP
\&\f(CW$Time::Human::Evening\fR and \f(CW$Time::Human::Night\fR 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.
.SH "USAGE"
.IX Header "USAGE"
.SS "Import Parameters"
.IX Subsection "Import Parameters"
This module accepts no arguments to it's \f(CW\*(C`import\*(C'\fR method (actually, it doesn't
        even have an import \f(CW\*(C`method\*(C'\fR).
.SS "Exports"
.IX Subsection "Exports"
This module exports a single \fIsymbols\fR, the \f(CW\*(C`humanize\*(C'\fR function.
.SH "CREDITS"
.IX Header "CREDITS"
Simon Cozens (\s-1SIMON\s0) for originally creating this module.
.PP
Ricardo \s-1SIGNES\s0 (\s-1RJBS\s0) for being inhumanly patient in waiting for me to apply a
one line whitespace trimming patch.
.PP
Everyone at the DateTime \f(CW\*(C`Asylum\*(C'\fR.
.SH "SUPPORT"
.IX Header "SUPPORT"
Support for this module is provided via the datetime@perl.org email list. See
http://lists.perl.org/ for more details
.SH "AUTHOR"
.IX Header "AUTHOR"
Simon Cozens, \f(CW\*(C`simon@cpan.org\*(C'\fR
.SH "CURRENT MAINTAINER"
.IX Header "CURRENT MAINTAINER"
Joshua Hoblitt, \f(CW\*(C`jhoblitt@cpan.org\*(C'\fR
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright (C) 2006\-2007  Joshua Hoblitt.  All rights reserved. 
Copyright (C) 2001\-2002(???)  Simon Cozens.
.PP
This program is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.
.PP
The full text of the license can be found in the \s-1LICENSE\s0 file included with
this module, or in perlartistic and perlgpl Pods as supplied with Perl
5.8.1 and later.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
DateTime, DateTime::Format::Human