Variable: org-agenda-time-grid

org-agenda-time-grid is a customizable variable defined in org-agenda.el.gz.

Value

((daily today require-timed)
 (800 1000 1200 1400 1600 1800 2000)
 "......" "----------------")

Documentation

The settings for time grid for agenda display.

This is a list of four items. The first item is again a list. It contains symbols specifying conditions when the grid should be displayed:

 daily if the agenda shows a single day
 weekly if the agenda shows an entire week
 today show grid on current date, independent of daily/weekly display
 require-timed show grid only if at least one item has a time specification
 remove-match skip grid times already present in an entry

The second item is a list of integers, indicating the times that should have a grid line.

The third item is a string which will be placed right after the times that have a grid line.

The fourth item is a string placed after the grid times. This will align with agenda items.

This variable was added, or its default value changed, in Org version
9.6.

Source Code

;; Defined in /usr/src/emacs/lisp/org/org-agenda.el.gz
(defcustom org-agenda-time-grid
  (let ((graphical (and (display-graphic-p)
                        (char-displayable-p ?┄))))
    `((daily today require-timed)
      (800 1000 1200 1400 1600 1800 2000)
      ,(if graphical " ┄┄┄┄┄ " "......")
      ,(if graphical "┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄" "----------------")))
  "The settings for time grid for agenda display.
This is a list of four items.  The first item is again a list.  It contains
symbols specifying conditions when the grid should be displayed:

 daily         if the agenda shows a single day
 weekly        if the agenda shows an entire week
 today         show grid on current date, independent of daily/weekly display
 require-timed show grid only if at least one item has a time specification
 remove-match  skip grid times already present in an entry

The second item is a list of integers, indicating the times that
should have a grid line.

The third item is a string which will be placed right after the
times that have a grid line.

The fourth item is a string placed after the grid times.  This
will align with agenda items."
  :group 'org-agenda-time-grid
  :package-version '(Org . "9.6")
  :type
  '(list
    (set :greedy t :tag "Grid Display Options"
	 (const :tag "Show grid in single day agenda display" daily)
	 (const :tag "Show grid in weekly agenda display" weekly)
	 (const :tag "Always show grid for today" today)
	 (const :tag "Show grid only if any timed entries are present"
		require-timed)
	 (const :tag "Skip grid times already present in an entry"
		remove-match))
    (repeat :tag "Grid Times" (integer :tag "Time"))
    (string :tag "Grid String (after agenda times)")
    (string :tag "Grid String (aligns with agenda items)")))