37 |
* Other Calendars:: Converting dates to other calendar systems. |
* Other Calendars:: Converting dates to other calendar systems. |
38 |
* Diary:: Displaying events from your diary. |
* Diary:: Displaying events from your diary. |
39 |
* Appointments:: Reminders when it's time to do something. |
* Appointments:: Reminders when it's time to do something. |
40 |
|
* iCalendar:: Converting diary events to/from iCalendar format. |
41 |
* Daylight Savings:: How to specify when daylight savings time is active. |
* Daylight Savings:: How to specify when daylight savings time is active. |
42 |
* Time Intervals:: Keeping track of time intervals. |
* Time Intervals:: Keeping track of time intervals. |
43 |
@end menu |
@end menu |
755 |
|
|
756 |
@kindex g @var{char} @r{(Calendar mode)} |
@kindex g @var{char} @r{(Calendar mode)} |
757 |
@findex calendar-goto-iso-date |
@findex calendar-goto-iso-date |
758 |
|
@findex calendar-goto-iso-week |
759 |
@findex calendar-goto-julian-date |
@findex calendar-goto-julian-date |
760 |
@findex calendar-goto-astro-day-number |
@findex calendar-goto-astro-day-number |
761 |
@findex calendar-goto-hebrew-date |
@findex calendar-goto-hebrew-date |
769 |
@item g c |
@item g c |
770 |
Move to a date specified in the ISO commercial calendar |
Move to a date specified in the ISO commercial calendar |
771 |
(@code{calendar-goto-iso-date}). |
(@code{calendar-goto-iso-date}). |
772 |
|
@item g w |
773 |
|
Move to a week specified in the ISO commercial calendar |
774 |
|
(@code{calendar-goto-iso-week}). |
775 |
@item g j |
@item g j |
776 |
Move to a date specified in the Julian calendar |
Move to a date specified in the Julian calendar |
777 |
(@code{calendar-goto-julian-date}). |
(@code{calendar-goto-julian-date}). |
1384 |
list without affecting your diary file. You delete entries from the |
list without affecting your diary file. You delete entries from the |
1385 |
appointment list with @kbd{M-x appt-delete}. |
appointment list with @kbd{M-x appt-delete}. |
1386 |
|
|
1387 |
|
@node iCalendar |
1388 |
|
@section iCalendar |
1389 |
|
@cindex iCalendar support |
1390 |
|
|
1391 |
|
The icalendar package aims at providing an implementation of the |
1392 |
|
iCalendar standard, as defined in ``RFC 2445 -- Internet Calendaring and |
1393 |
|
Scheduling Core Object Specification (iCalendar)''. It provides a means |
1394 |
|
for importing iCalendar (and the earlier vCalendar format) data into |
1395 |
|
Emacs diary files and vice versa. |
1396 |
|
|
1397 |
|
Importing works for ``ordinary'' (i.e. non-recurring) events, but (at |
1398 |
|
present) may not work correctly (if at all) for recurring events. |
1399 |
|
Exporting of diary files into iCalendar files should work correctly for |
1400 |
|
most diary entries. Please note that @file{icalendar.el} is work in |
1401 |
|
progress, so usage may evolve in future. |
1402 |
|
|
1403 |
|
To activate the package, use @code{(require 'icalendar)}. |
1404 |
|
|
1405 |
|
@findex icalendar-extract-ical-from-buffer |
1406 |
|
The command @code{icalendar-extract-ical-from-buffer} extracts |
1407 |
|
iCalendar data from the current buffer and adds it to your (default) |
1408 |
|
diary file. This function is also suitable for automatic extraction of |
1409 |
|
iCalendar data; for example with the Rmail mail client one could use: |
1410 |
|
|
1411 |
|
@example |
1412 |
|
(add-hook 'rmail-show-message-hook 'icalendar-extract-ical-from-buffer) |
1413 |
|
@end example |
1414 |
|
|
1415 |
|
@findex icalendar-import-file |
1416 |
|
The command @code{icalendar-import-file} imports an iCalendar file. |
1417 |
|
@strong{Caution:} the contents of the target diary file are |
1418 |
|
@emph{deleted} by default! It is highly recommended to use a dedicated |
1419 |
|
diary file for importing. For example: |
1420 |
|
|
1421 |
|
@example |
1422 |
|
(icalendar-import-file "/here/is/calendar.ics" "/there/goes/ical-diary") |
1423 |
|
@end example |
1424 |
|
|
1425 |
|
@noindent |
1426 |
|
You can use an @code{#include} directive to add the import file contents |
1427 |
|
to the diary. @xref{Fancy Diary Display,,, elisp, The Emacs Lisp |
1428 |
|
Reference Manual}. |
1429 |
|
|
1430 |
|
@findex icalendar-convert-diary-to-ical |
1431 |
|
The command @code{icalendar-convert-diary-to-ical} exports an Emacs |
1432 |
|
diary file to iCalendar format. @strong{Caution:} the contents of the |
1433 |
|
target file are @emph{deleted} by default! |
1434 |
|
|
1435 |
|
|
1436 |
@node Daylight Savings |
@node Daylight Savings |
1437 |
@section Daylight Savings Time |
@section Daylight Savings Time |
1438 |
@cindex daylight savings time |
@cindex daylight savings time |