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 1) and gives the same return values as 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

Type perldoc perl to get info on Perl itselft. Type perldoc perlmod to get info on Perl modules.