Variable: world-clock-sort-order

world-clock-sort-order is a customizable variable defined in time.el.gz.

Value

nil

Documentation

Sort order of entries in the world-clock.

This variable can take a few different forms:

- A nil value indicates no sorting, and the displayed order is the same
  as in world-clock-list. This is the default.

- A string is taken as a format for format-time-string, whose output
  is used as the sorting key. For example, an ISO 8601 format "%FT%T"
  means entries are sorted in chronological order.

- A cons cell of the form (STRING . BOOL) again provides a format for
  format-time-string. The boolean part controls the sort direction.
  For example, ("%FT%T" . t) means entries are sorted in reverse
  chronological order.

- A function that takes a list of (TIMEZONE LABEL) entries and a TIME as
  arguments, and returns another list of entries.

This variable was added, or its default value changed, in Emacs 31.1.

Probably introduced at or before Emacs version 31.1.

Source Code

;; Defined in /usr/src/emacs/lisp/time.el.gz
(defcustom world-clock-sort-order nil
  "Sort order of entries in the `world-clock'.
This variable can take a few different forms:

- A nil value indicates no sorting, and the displayed order is the same
  as in `world-clock-list'.  This is the default.

- A string is taken as a format for `format-time-string', whose output
  is used as the sorting key.  For example, an ISO 8601 format `\"%FT%T\"'
  means entries are sorted in chronological order.

- A cons cell of the form (STRING . BOOL) again provides a format for
  `format-time-string'.  The boolean part controls the sort direction.
  For example, `(\"%FT%T\" .  t)' means entries are sorted in reverse
  chronological order.

- A function that takes a list of (TIMEZONE LABEL) entries and a TIME as
  arguments, and returns another list of entries."
  :version "31.1"
  :type '(choice (const :tag "No sorting" nil)
		 (const :tag "Chronological order" "%FT%T")
		 (const :tag "Reverse chronological order" ("%FT%T" . t))
		 (const :tag "Time of day order" "%T")
		 (const :tag "Reverse time of day order" ("%T" . t))
		 (string :tag "Format string")
		 (cons :tag "Format string and reverse flag"
		       (string :tag "Format string")
		       (boolean :tag "Reverse"))
		 (function :tag "Sorting function")))