File: time.el.html

Facilities to display current time/date and a new-mail indicator in the Emacs mode line. The entry point is display-time.

Use world-clock to display world clock in a buffer.

Defined variables (37)

display-time-24hr-formatNon-nil indicates time should be displayed as hh:mm, 0 <= hh <= 23.
display-time-day-and-dateNon-nil means M-x display-time should display day and date as well as time.
display-time-default-load-averageWhich load average value will be shown in the mode line.
display-time-formatString specifying format for displaying the time in the mode line.
display-time-hookList of functions to be called when the time is updated on the mode line.
display-time-intervalSeconds between updates of time in the mode line.
display-time-load-averageValue of the system’s load average currently shown on the mode line.
display-time-load-average-thresholdLoad-average values below this value won’t be shown in the mode line.
display-time-mail-directoryName of mail inbox directory, for indicating existence of new mail.
display-time-mail-faceFace to use for ‘display-time-mail-string’.
display-time-mail-fileFile name of mail inbox file, for indicating existence of new mail.
display-time-mail-functionFunction to call, for indicating existence of new mail.
display-time-mail-iconImage specification to offer as the mail indicator on a graphic display.
display-time-mail-stringString to use as the mail indicator in ‘display-time-string-forms’.
display-time-modeNon-nil if Display-Time mode is enabled.
display-time-mode-hookHook run after entering or leaving ‘display-time-mode’.
display-time-server-down-timeTime when mail file’s file system was recorded to be down.
display-time-stringString used in mode lines to display a time string.
display-time-string-formsList of expressions governing display of the time in the mode line.
display-time-use-mail-iconNon-nil means use an icon as mail indicator on a graphic display.
display-time-world-buffer-nameName of the ‘world-clock’ buffer.
display-time-world-listAlist of time zones and places for ‘world-clock’ to display.
display-time-world-time-formatTime format for ‘world-clock’, see ‘format-time-string’.
display-time-world-timer-enableIf non-nil, a timer will update the ‘world-clock’ buffer.
display-time-world-timer-secondInterval in seconds for updating the ‘world-clock’ buffer.
legacy-style-world-listAlist of traditional-style time zones and places for ‘world-clock’.
world-clock--timerThe current world clock timer.
world-clock-buffer-nameName of the ‘world-clock’ buffer.
world-clock-listAlist of time zones and places for ‘world-clock’ to display.
world-clock-mode-abbrev-tableAbbrev table for ‘world-clock-mode’.
world-clock-mode-hookHook run after entering ‘world-clock-mode’.
world-clock-mode-mapKeymap for ‘world-clock-mode’.
world-clock-mode-syntax-tableSyntax table for ‘world-clock-mode’.
world-clock-time-formatTime format for ‘world-clock’, see ‘format-time-string’.
world-clock-timer-enableIf non-nil, a timer will update the ‘world-clock’ buffer.
world-clock-timer-secondInterval in seconds for updating the ‘world-clock’ buffer.
zoneinfo-style-world-listAlist of zoneinfo-style time zones and places for ‘world-clock’.

Defined functions (17)

display-time()
display-time-file-nonempty-p(FILE)
display-time-mode(&optional ARG)
display-time-next-load-average()
display-time-update()
display-time-world()
display-time-world-display(ALIST)
display-time-world-mode()
display-time-world-timer(&optional ARG NOCONFIRM)
emacs-init-time(&optional FORMAT)
emacs-uptime(&optional FORMAT HERE)
world-clock()
world-clock-cancel-timer()
world-clock-copy-time-as-kill()
world-clock-display(ALIST)
world-clock-mode()
world-clock-update(&optional ARG NOCONFIRM)

Defined faces (2)

display-time-date-and-timeFace for ‘display-time-format’.
world-clock-labelFace for time zone label in ‘world-clock’ buffer.