hodie1

Usage

Overview

hodie prints out the current date using classic Latin, and in addition also prints it out and time using Roman numerals.

Options

-h, --help

Print short help message with syntax

-v, --verbose

Print months and days (pridie, Kalends, Nones, Ides) full and not the respective abbreviations (standard mode of operation)

Two occurrences of -v as well as the use of -vv or --extremely-verbose will include the numerals where applicable fully declined, as in 'ante diem quintum Kalends Septembres'.

-n, --numerals

Don't print anything in Latin - only the date and time as Roman numerals.

-x, --force-numerals

Print both the verbose latin and the date and time as Roman numerals.

-c, --classic, --auc

Print the year in the classic manner ab urbe condita instead of the more modern anno domini .

-a, --ante-diem

Print the date expressing the number of days to the next main day with the ante diem expression instead of ablative case.

-d, --date

Print out any date. This has a rather special syntax, with a keyword following the -d flag choosing input format. See section on DATE INPUT below.

-r, --republican OFFSET

Print out the date dated ab urbe tua condita with the offset counted in years as compared to the modern european kalendar (originating with the hypothetical birth of christ). hodie -r -753 would be equivalent with hodie -c

--version

Print out the version number of this release and exit. No matter whether other options appear on the command line or not.

Date input

Following the -d or the --date option flags, the first item must be one of the following:

verbose

In this case, the year, month and day are given by following the verbose keyword by the flags -y, --year, -m, --month, -d, --day for year, month and date respectively

ymd

After this flag, the date comes in the format YYYY-MM-DD , where the numbers may be separated by any non-numeric character.

dmy

With this flag, the date is given as DD-MM-YYYY

mdy

With this flag, the date is given as MM-DD-YYYY Restrictions on the characters that may replace the hyphen apply as above.

Return values

hodie returns zero. Always. If it doesn't, then something is really bad with the code.

For some really unreadable code, this means that hodie could be used as a strange replacement for true