NAME

Tk::StrfClock - a X/TK digital clock widget based on strftime.

SYNOPSIS

  use Tk::StrfClock;

  $top->StrfClock(
        -format => <strftime format string>,
        -update => [<seconds>|s|m|h|d],
        -advance => [<seconds>],
  );

DESCRIPTION

Tk::StrfClock is a digital clock widget, with all the other attributes of a Tk::Label.

OPTIONS

-format => <strftime format string>

        Sets the required date/time format using POSIX strftime format.
        The default is "%I:%M:%S%p, %A, %e %B %Y.".

-update => <seconds>|s|m|h|d|a

        Sets how often the clock is updated.  If set to the characters
        s, m, h, d or a then the clock is updated exactly on the second,
        minute, hour, day or is automatically guessed.

        The default is 'a'.

-advance => <seconds>

        Sets the clock fast or slow this many seconds. The default is
        0.

Other Tk::Label options.

MINIMAL EXAMPLE

  use Tk;
  use Tk::StrfClock;

  my $top=MainWindow->new();
  $top->StrfClock()->pack();
  MainLoop();

TESTING

 Run the module itself to start a test program.
 To increase the size of the fond add something like

 *StrfClock*font: -*-fixed-medium-r-normal--20-*-*-*-*-*-*-*

 to your .Xdefaults file.