NAME

Date::Spoken::German - Output dates as ASCII text as you would speak it

SYNOPSIS

use Date::Spoken::German;

print timetospoken( time() );
print datetospoken( $DAY, $MONTH, $YEAR );

DESCRIPTION

This module provides you with functions to easily convert a date (given
as either integer values for day, month and year or as a unix timestamp)
to its representation as german text, like you would read it aloud.

EXPORTABLE TAGS

:ALL    - all helper methods are also exported into the callers namespace

FUNCTIONS

Exported by default

timetospoken( $TIMESTAMP )

In scalar context, return a string consisting of the text
representation of the date in the given unix timestamp,
like e.g. "dreizehnter Mai zweitausenddrei".

In list context, returns the three words of the string as a list.

datetospoken( $DAY, $MONTH, $YEAR )

Takes the values for day of month, month and year as integers
(month starting with B<1>) and gives the same return values as
I<timetospoken>.

Exported by :ALL

yeartospoken( $YEAR )

Takes a year (absolute integer value) as input and returns the
text representation in German.

monthtospoken( $MONTH )

Takes a month (integer value, January = 1) as input and returns
the text representation in German.

daytospoken( $DAY )

Converts a day number to its German text representation.

KNOWN ISSUES

None at the moment.

BUGS

Please report all bugs to the author of this module:
Christian Winter <thepoet@a-za-z0-9.de>

CREDITS

To Larry Wall for Perl itself, and to all developers out there
contributing to the Perl community. Special thanks to all regulars
in the usenet perl groups for giving me a lot of hints that helped
me understand what Perl can do.

SEE ALSO

B<perldoc perl> on Perl itselft.
B<perldoc perlmod> on Perl modules.