NAME

Oxford::Calendar - Oxford calendar conversion routines

SYNOPSIS

    use Oxford::Calendar;
    print "Today is ", Oxford::Calendar::ToOx(reverse Date::Calc::Today);

DESCRIPTION

This module converts Oxford dates to and from Real World dates using data supplied in YAML data.

If the file /etc/oxford-calendar.yaml exists, data will be read from that; otherwise, built-in data will be used.

Functions

ToOx($day, $month, $year)

Given a day, month and year in standard human format (that is, month is 1-12, not 0-11, and year is four digits) will return a string of the form

    Day, xth week, Term.

or, on error, the text Out of range.

Parse($string)

Takes a free-form description of an Oxford calendar date, and attempts to divine the expected meaning. If the name of a term is not found, the current term will be assumed. If the description is unparsable, the text "UNPARSABLE" is returned. Otherwise, output is of the form ($year,$term,$week,$day)

This function is experimental.

FromOx($year, $term, $week, $day)

Converts an Oxford date into a Georgian date, returning a string of the form DD/MM/YYYY or an error message.

AUTHOR

Simon Cozens

Eugene van der Pijll, pijll@cpan.org

Dominic Hargreaves