Chapter 31. The Calendar and the Diary

Table of Contents
31.1. Movement in the Calendar
31.1.1. Motion by Standard Lengths of Time
31.1.2. Beginning or End of Week, Month or Year
31.1.3. Specified Dates
31.2. Scrolling in the Calendar
31.3. Counting Days
31.4. Miscellaneous Calendar Commands
31.5. LaTeX Calendar
31.6. Holidays
31.7. Times of Sunrise and Sunset
31.8. Phases of the Moon
31.9. Conversion To and From Other Calendars
31.9.1. Supported Calendar Systems
31.9.2. Converting To Other Calendars
31.9.3. Converting From Other Calendars
31.9.4. Converting from the Mayan Calendar
31.10. The Diary
31.10.1. Commands Displaying Diary Entries
31.10.2. The Diary File
31.10.3. Date Formats
31.10.4. Commands to Add to the Diary
31.10.5. Special Diary Entries
31.11. Appointments
31.12. Daylight Savings Time
31.13. Summing Time Intervals
31.14. Gnus
31.14.1. Gnus Buffers
31.14.2. When Gnus Starts Up
31.14.3. Summary of Gnus Commands
31.15. Running Shell Commands from Emacs
31.15.1. Single Shell Commands
31.15.2. Interactive Inferior Shell
31.15.3. Shell Mode
31.15.4. Shell Command History
31.15.5. Directory Tracking
31.15.6. Shell Mode Options
31.15.7. Emacs Terminal Emulator
31.15.8. Term Mode
31.15.9. Page-At-A-Time Output
31.15.10. Remote Host Shell
31.16. Using Emacs as a Server
31.17. Invoking emacsclient
31.18. Hardcopy Output
31.19. PostScript Hardcopy
31.20. Variables for PostScript Hardcopy
31.21. Sorting Text
31.22. Narrowing
31.23. Two-Column Editing
31.24. Editing Binary Files
31.25. Saving Emacs Sessions
31.26. Recursive Editing Levels
31.27. Emulation
31.28. Hyperlinking and Navigation Features
31.28.1. Following URLs
31.28.2. Activating URLs
31.28.3. Finding Files and URLs at Point
31.28.4. Finding Function and Variable Definitions
31.29. Dissociated Press
31.30. Other Amusements

Emacs provides the functions of a desk calendar, with a diary of planned or past events. It also has facilities for managing your appointments, and keeping track of how much time you spend working on certain projects.

To enter the calendar, type M-x calendar; this displays a three-month calendar centered on the current month, with point on the current date. With a numeric argument, as in C-u M-x calendar, it prompts you for the month and year to be the center of the three-month calendar. The calendar uses its own buffer, whose major mode is Calendar mode.

Mouse-2 in the calendar brings up a menu of operations on a particular date; C-Mouse-3 brings up a menu of commonly used calendar features that are independent of any particular date. To exit the calendar, type q. , for customization information about the calendar and diary.