Variable: org-icalendar-ttl

org-icalendar-ttl is a customizable variable defined in ox-icalendar.el.gz.

Value

nil

Documentation

Time to live for the exported calendar.

Subscribing clients to the exported ics file can derive the time interval to read the file again from the server. One example of such client is Nextcloud calendar, which respects the setting of X-PUBLISHED-TTL in ICS files. Setting org-icalendar-ttl to "PT1H" would advise a server to reload the file every hour.

See https://icalendar.org/iCalendar-RFC-5545/3-8-2-5-duration.html for a complete description of possible specifications of this option. For example, "PT1H" stands for 1 hour and
"PT0H27M34S" stands for 0 hours, 27 minutes and 34 seconds.

The default value is nil, which means no such option is set in the ICS file. This option can also be set on a per-document basis with the ICAL-TTL export keyword.

This variable was added, or its default value changed, in Org version
9.7.

Source Code

;; Defined in /usr/src/emacs/lisp/org/ox-icalendar.el.gz
(defcustom org-icalendar-ttl nil
  "Time to live for the exported calendar.

Subscribing clients to the exported ics file can derive the time
interval to read the file again from the server.  One example of such
client is Nextcloud calendar, which respects the setting of
X-PUBLISHED-TTL in ICS files.  Setting `org-icalendar-ttl' to \"PT1H\"
would advise a server to reload the file every hour.

See https://icalendar.org/iCalendar-RFC-5545/3-8-2-5-duration.html
for a complete description of possible specifications of this
option.  For example, \"PT1H\" stands for 1 hour and
\"PT0H27M34S\" stands for 0 hours, 27 minutes and 34 seconds.

The default value is nil, which means no such option is set in
the ICS file. This option can also be set on a per-document basis
with the ICAL-TTL export keyword."
  :group 'org-export-icalendar
  :type '(choice
          (const :tag "No refresh period" nil)
          (const :tag "One hour" "PT1H")
          (const :tag "One day" "PT1D")
          (const :tag "One week" "PT7D")
          (string :tag "Other"))
  :package-version '(Org . "9.7"))