Tcl/Tk in a Nutshell

Name

clock

clock options...

Perform time-related functions.

clock clicks

Return system time as a high-resolution, system-dependent number.

clock format clockValue [-format string] [-gmt boolean]

Format time in human-readable format. ClockValue is a time value as returned by clock seconds, clock scan, or the -atime, -mtime, or -ctime options of the file command. The optional format string indicates how the string should be formatted, using the symbols described below. The optional -gmt argument takes a boolean argument: if true, the time is formatted using Greenwich Mean Time; otherwise, the local time zone is used.

%%	%	%a	Weekday (abbr.)
%A	Weekday (full)	%b	Month (abbr.)
%B	Month (full)	%c	Local date and time
%d	Day (01–31)	%H	Hour (00–23)
%h	Hour (00–12)	%j	Day (001–366)
%m	Month (01–12)	%M	Minute (00–59)
%p	A.M./P.M.	%S	Seconds (00–59)
%U	Week (01–52)	%w	Weekday (0–6)
%x	Local date	%X	Local time
%y	Year (00–99)	%Y	Year (full)
%Z	Time zone

clock scan dateString [-base clockVal] [-gmt boolean]

Parse dateString as a date and time, returning an integer clock value (the reverse of clock format). If the optional -base argument is used, clockVal is used to specify the date to be used for the resulting time value. If the Boolean -gmt argument is true, assume that time is specified in Greenwich Mean Time.

clock seconds

Return the current time, in seconds, using a system-dependent format.