GNU Emacs Manual. Node: Calendar Unit Motion

prev UPCalendar Motion NEXTMove to Beginning or End

27.1.1: Motion by Standard Lengths of Time

The commands for movement in the calendar buffer parallel the commands for movement in text. You can move forward and backward by days, weeks, months, and years.


Move point one day forward (calendar-forward-day).

C-b Move point one day backward (calendar-backward-day).
C-n Move point one week forward (calendar-forward-week).
C-p Move point one week backward (calendar-backward-week).
M-} Move point one month forward (calendar-forward-month).
M-{ Move point one month backward (calendar-backward-month).
C-x ] Move point one year forward (calendar-forward-year).
C-x [ Move point one year backward (calendar-backward-year).

The day and week commands are natural analogues of the usual Emacs commands for moving by characters and by lines. Just as C-n usually moves to the same column in the following line, in Calendar mode it moves to the same day in the following week. And C-p moves to the same day in the previous week.

The arrow keys are equivalent to C-f, C-b, C-n and C-p, just as they normally are in other modes.

The commands for motion by months and years work like those for weeks, but move a larger distance. The month commands M-} and M-{ move forward or backward by an entire month's time. The year commands C-x ] and C-x [ move forward or backward a whole year.

The easiest way to remember these commands is to consider months and years analogous to paragraphs and pages of text, respectively. But the commands themselves are not quite analogous. The ordinary Emacs paragraph commands move to the beginning or end of a paragraph, whereas these month and year commands move by an entire month or an entire year, which usually involves skipping across the end of a month or year.

All these commands accept a numeric argument as a repeat count. For convenience, the digit keys and the minus sign specify numeric arguments in Calendar mode even without the Meta modifier. For example, 100 C-f moves point 100 days forward from its present location.

prev UPCalendar Motion NEXTMove to Beginning or End