From the NannyMUD documentation

LAST CHANGE

2001-09-09

NAME

        timer - Time handling module.

DESCRIPTION

        The timer module provides a set of commands dealing with the
        time, both RL and NannyMUD's time. The module provides the
        commands:
	
        time    - Show the NannyMUD time, date, year, season, etc.
        ntime   - The same as 'time'.
        rtime   - Show the RL time.
	atime	- Show both NannyMUD time and RL time.
        alarm   - Alarm handling.
        chime   - Make the timer chime now and then.

COMMAND

NAME
        time - Nannytime.


SYNTAX


DESCRIPTION
        This command gives the NannyMUD time, date, year, season, what
        part of the day it is, what day in the month it is, and the
        phase of the moon including if it's waxing or waning.

        If given the flag '-i', some details, on how the NannyMUD time
        is built and connected to RL time, are given.

COMMAND

NAME
        ntime - An alias for 'time'.


SYNTAX
        ntime [-i]

DESCRIPTION
        This is an alias for 'time'.

COMMAND

NAME
        rtime - Real-life time.


SYNTAX
        rtime

DESCRIPTION
        This gives the local RL time of NannyMUD, i.e. middle europe,
        and, if available, how long you have been logged on.

COMMAND

NAME
        atime - All in one command.


SYNTAX
        atime

DESCRIPTION
        This command combines time and rtime into one for
        convenience.

COMMAND

NAME
        alarm - Set an alarm.


SYNTAX
        alarm

SYNTAX
        alarm [-c|-s|-d nr|-n nr]

SYNTAX
        alarm [-m msg] [-v] [+]hh:mm

DESCRIPTION
        The alarm command can be used to make the timer module send
        you an alarm at a certain time. The message sent contains a
        BEL characted, which will make your terminal beep (if it
        can).
	        
        hh:mm   This sets an alarm to go off at the time hh:mm.
        +hh:mm  This sets an alarm to go off at the time now+hh:mm.
        -c      This clears all entries in the alarm table.
        -s      This makes the module list all entries, as well as the
                number of times the alarm will chime, and the delay
                between the chimes.
        -m msg  This sets a message to use. Note that since this
                module uses getopts(), 'msg' must be a single word,
                i.e. it cannot contain any spaces. Use underlines
                instead. Those will be replaced with spaces.
        -v      Show the message as well as the time when setting an
                alarm. 


NOTE
        Note that alarms are not stored between sessions.

COMMAND

NAME
        chime - Set the chime.


SYNTAX
        chime [hour|day|daypart|month|season|year]

DESCRIPTION
        Using this command, you can make the timer module give you a
        tell when the hour, day, week, month, etc., changes.

        chime           Show all chimes.
        chime -c        Clear all chimes.
        chime hour      Toggle the chiming at the hour.
        chime day       Toggle the chiming at the new day.
        chime week      Toggle the chiming at the new week.
        chime moonphase Toggle the chiming at the new moonphase.
        chime daypart   Toggle the chiming at the new part of the day.
        chime month     Toggle the chiming at the new month.
        chime season    Toggle the chiming at the new season.
        chime year      Toggle the chiming at the year.


NOTE
        Some combinations of chimes will give you multiple signals
        when the event occurs. That is a feature.