NAME

Date::Ordinal - Conversion of dates to ordinal numbers and vice versa

SYNOPSIS

use Date::Ordinal;

$ord     = month2ord('January');           # $ord gets 1
$mon     = ord2month('1');                 # $mon gets 'January'
$mon     = ord2month(1);                   # $mon gets 'January'
$mon     = ord2month('01');                # $mon gets 'January'

DESCRIPTION

The Locale::US module provides access to the two-letter codes for identifying states in the United States. You can either access the codes via the "conversion routines" (described below), or with the two functions which return lists of all states codes or all state names.

CONVERSION ROUTINES

There are two conversion routines: ord2month() and month2ord().

ord2month()

This function takes a month number [1..12] and returns a string which contains the name of the month identified. If the number is not a valid number, then undef will be returned:

$mon = ord2month('3');

month2ord()

This function takes a month name and returns the integer corresponding to the month name, if such exists. If the argument could not be identified as a month name, then undef will be returned:

$ord = month2ord('March');

The case of the month name is not important. See the section "KNOWN BUGS AND LIMITATIONS" below.

QUERY ROUTINES

There is one function (and a reference variant) which can be used to obtain a list of all month names:

all_month_names()

Returns a list of all month names;

all_month_names_ref()

Returns a reference to a list of all month names;

KNOWN BUGS AND LIMITATIONS

none

SEE ALSO

Locale::US

Date::Manip

AUTHOR

Terrence Brannon <tbrannon@end70.com>

COPYRIGHT

Copyright (c) 1999 End70 Corporation

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