Variable: calendar-month-header

calendar-month-header is a customizable variable defined in calendar.el.gz.

Value

(propertize
 (format "%s %d"
	 (calendar-month-name month)
	 year)
 'font-lock-face 'calendar-month-header)

Documentation

Expression to evaluate to return the calendar month headings.

When this expression is evaluated, the variables month and year are integers appropriate to the relevant month. The result is padded to the width of calendar-month-digit-width.

For examples of three common styles, see calendar-american-month-header, calendar-european-month-header, and calendar-iso-month-header.

Changing this variable without using customize has no effect on pre-existing calendar windows.

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

View in manual

Probably introduced at or before Emacs version 24.3.

Source Code

;; Defined in /usr/src/emacs/lisp/calendar/calendar.el.gz
  :version "24.4") ; font-lock-function-name-face -> calendar-month-header

(defcustom calendar-month-header
  (cond ((eq calendar-date-style 'iso)
         calendar-iso-month-header)
        ((eq calendar-date-style 'european)
         calendar-european-month-header)
        (t calendar-american-month-header))
  "Expression to evaluate to return the calendar month headings.
When this expression is evaluated, the variables `month' and `year' are
integers appropriate to the relevant month.  The result is padded
to the width of `calendar-month-digit-width'.

For examples of three common styles, see `calendar-american-month-header',
`calendar-european-month-header', and `calendar-iso-month-header'.

Changing this variable without using customize has no effect on
pre-existing calendar windows."
  :group 'calendar
  :initialize 'custom-initialize-default
  :risky t
  :set (lambda (sym val)
         (set sym val)
         (calendar-redraw))
  :set-after '(calendar-date-style calendar-american-month-header
                                   calendar-european-month-header
                                   calendar-iso-month-header)
  :type 'sexp
  :version "24.3")