39.12 Importing and Exporting Diary Entries
You can transfer diary entries between Emacs diary files and a
variety of other formats.
You can import diary entries from Outlook-generated appointment
messages. While viewing such a message in Rmail or Gnus, do M-x
diary-from-outlook to import the entry. You can make this command
recognize additional appointment message formats by customizing the
The icalendar package allows you to transfer data between your Emacs
diary file and iCalendar files, which are defined in “RFC
2445—Internet Calendaring and Scheduling Core Object Specification
(iCalendar)” (as well as the earlier vCalendar format).
Importing works for “ordinary” (i.e. non-recurring) events, but (at
present) may not work correctly (if at all) for recurring events.
Exporting of diary files into iCalendar files should work correctly for
most diary entries. Please note that icalendar.el is work in
progress, so usage may evolve in future.
iCalendar data from the current buffer and adds it to your (default)
diary file. This function is also suitable for automatic extraction of
iCalendar data; for example with the Rmail mail client one could use:
(add-hook 'rmail-show-message-hook 'icalendar-import-buffer)
icalendar-import-file imports an iCalendar file
and adds the results to an Emacs diary file. For example:
(icalendar-import-file "/here/is/calendar.ics" "/there/goes/ical-diary")
You can use an
#include directive to add the import file contents
to the main diary file, if these are distinct. see Fancy Diary Display.
icalendar-export-file to interactively export an entire
Emacs diary file to iCalendar format. To export only a part of a diary
file, mark the relevant area, and call
In both cases the result is appended to the target file.