Synopsis:

on [#][<mode>]timer [<serial#>] [-|^]<match> { <action> }

Description:

This hook is triggered whenever the specified time (or time glob pattern) matches the current time. The time may be in one of two formats:

Format	Description
hh:mm<am\|pm>	0 ⇐ hh ⇐ 12, 0 ⇐ mm ⇐ 59, am or pm set accordingly
hh:mm	0 ⇐ hh ⇐ 23, 0 ⇐ mm ⇐ 59

$0	current time (format depends on CLOCK_24HOUR setting)

To inform the user of the time once per hour on the hour:

 on ^timer "%:00*" {
    xecho -b The time is now $Z
    beep
 }