编辑“︁ICalendar”︁（章节）

== 技術標準 ==

=== 核心對象 ===

iCalendar中的頂級元素是日曆和計劃核心對象，一組日曆和計劃信息。通常情況下，這些信息應該只包含單一的iCalendar對象。但可以聲明一個組包含多個iCalendar對象。

第一行必須是"BEGIN:VCALENDER"，最後一行必須是"END:VCALENDER"；兩行之間數據稱之為"icalbody"。

icalbody由一系列日曆屬性和一個以上的日曆組件組成。日曆屬性被應用於整個日曆。日曆組件則是由若干日曆屬性描述成的一個日曆語義。比如，日曆組件可以指定一個事件、一個待辦事項列表、一個旅行事項、時區信息、繁忙/空閒時間信息，或者一個警報。在許多協議實現（比如Google Calendar）中不允許出現空行。

下在是一個簡單的iCalendar對象示例，它描述了[[法国国庆日]]，即從1997年七月14日 17:00到1997年七月15日 03:59:59的[[巴士底日]]。

 BEGIN:VCALENDAR
 VERSION:2.0
 PRODID:-//hacksw/handcal//NONSGML v1.0//EN
 BEGIN:VEVENT
 UID:uid1@example.com
 DTSTAMP:19970714T170000Z
 ORGANIZER;CN=<nowiki>John Doe:MAILTO:john.doe@example.com</nowiki>
 DTSTART:19970714T170000Z
 DTEND:19970715T035959Z
 SUMMARY:Bastille Day Party
 END:VEVENT
 END:VCALENDAR

=== 事件（VEVENT） ===
VEVENT描述一個事件，在日曆上一系列計劃好的時間點。通常，當用戶接受一個日曆事件，這將導致在那個時間裡，用戶被認為是忙碌的。VEVENT可以包含一個VALARM對象來允許一個警報。事件應該有一個DTSTART來描述事件的開始時間，和一個DTEND來描述事件的結束時間。如果事件是循環的，則DTSTART應該設置第一個事件的開始時間。

VEVENT同樣可以應用在沒有特定時間的日曆事件上，比如周年紀念日、每日提醒。

如果你需要發送取消事件的請求。那麼在請求中事件組件中，UID屬性應該與原事件一致並且，下面這些屬性應該設置成cancel。

 METHOD:CANCEL
 STATUS:CANCELLED

為了發送事件的更新請求，除了設置UID和其它更新屬性值外。還需要設置新序列值

 SEQUENCE:<新序列值>

比如，第一個更新版本

 SEQUENCE:1

在Microsoft Outlook中，SUMMARY屬性應當與"Appointment"中的"Subject"項一致，DESCRIPTION 屬性緊跟著SUBJECT屬性。另外，Outlook 2003要求指定UID和DTSTAMP屬性。

=== 待辦事項（VTODO） ===
VTODO描述一條待辦事項。

下面的例子描述了一個應於1998年四月15日的待辦事項。屆時一個響鈴將會響起。在待辦事項完成前，將會一小時提醒一次，共提醒四次。SEQUENCE屬性顯示這條提醒在創建之後，還被修改了兩次。

 BEGIN:VCALENDAR
 VERSION:2.0
 PRODID:-//ABC Corporation//NONSGML My Product//EN
 BEGIN:VTODO
 DTSTAMP:19980130T134500Z
 SEQUENCE:2
 UID:uid4@host1.com
 ACTION:AUDIO
 TRIGGER:19980403T120000
 ATTACH;FMTTYPE=<nowiki>audio/basic:http://example.com/pub/audio-</nowiki>
     files/ssbanner.aud
 REPEAT:4
 DURATION:PT1H
 END:VTODO
 END:VCALENDAR

=== 旅行事項（VJOURNAL） ===
VJOURNAL是一個旅行事項。它們將一段描述文字關聯一個詳細的日曆日期上，這可以被用戶記錄活動和成長日誌，或者描述待辦事項的進展。VJOURNAL日曆組件不會影響日曆上的時間狀況，所以不會對空閒和繁忙狀態有任何影響。在實踐上，有很少的程序支持VJOURNAL項，不過也有存在一些實現。比如：Plum Canary's Chirp軟件將VJOURNAL和VTODO一起使用。KDE中的[[KOrganizer]]也支持VJOURNAL。

下面就是旅行事項的例子
 BEGIN:VCALENDAR
 VERSION:2.0
 PRODID:-//ABC Corporation//NONSGML My Product//EN
 BEGIN:VJOURNAL
 DTSTAMP:19970324T120000Z
 UID:uid5@host1.com
 ORGANIZER:<nowiki>MAILTO:jsmith@example.com</nowiki>
 STATUS:DRAFT
 CLASS:PUBLIC
 CATEGORIES:Project Report, XYZ, Weekly Meeting
 DESCRIPTION:Project xyz Review Meeting Minutes\n
     Agenda\n1. Review of project version 1.0 requirements.\n2.
     Definition
     of project processes.\n3. Review of project schedule.\n
      Participants: John Smith, Jane Doe, Jim Dandy\n-It was
       decided that the requirements need to be signed off by
       product marketing.\n-Project processes were accepted.\n
      -Project schedule needs to account for scheduled holidays
       and employee vacation time. Check with HR for specific
       dates.\n-New schedule will be distributed by Friday.\n-
      Next weeks meeting is cancelled. No meeting until 3/23.
 END:VJOURNAL
 END:VCALENDAR

'''注意''': 这个例子中来自于[http://tools.ietf.org/html/rfc2445| RFC 2445] {{Wayback|url=http://tools.ietf.org/html/rfc2445%7C |date=20191017103324 }}。在这里将原文中的CATEGORY修正为CATEGORIES，这是原文中的一个错误。

=== 空闲/繁忙时间（VFREEBUSY） ===
VFREEBUSY被用在 空闲/繁忙时间 设置请求，这种请求的回应，以及繁忙时间的发布中。
下面就是一个系统时间发布的例子。

 BEGIN:VCALENDAR
 VERSION:2.0
 PRODID:-//RDU Software//NONSGML HandCal//EN
 BEGIN:VFREEBUSY
 ORGANIZER:<nowiki>MAILTO:jsmith@example.com</nowiki>
 DTSTART:19980313T141711Z
 DTEND:19980410T141711Z
 FREEBUSY:19980314T233000Z/19980315T003000Z
 FREEBUSY:19980316T153000Z/19980316T163000Z
 FREEBUSY:19980318T030000Z/19980318T040000Z
 URL:<nowiki>http://www.example.com/calendar/busytime/jsmith.ifb</nowiki>
 END:VFREEBUSY
 END:VCALENDAR

=== 其它组件类型 ===
其它组件类型还有'''VTIMEZONE'''（时区）和'''VALARM'''（警报）。还有一些组件允许包含其它组件（VALARM通常被包含于其它组件）。

=== 发布更新 ===
当计划事件更改，UID字段将发布更新。首先事件创建时会生成一个[[UUID|全局唯一标识符]]作为UID。之后当有一个事件跟随这个UID发布，则认为这是早先事件的修改版本，并替换掉它。

=== 日历扩展 ===
iCalendar支持私有扩展，即在属性名前冠以"X-"前缀。

比如：
* X-RECURRENCE-ID
* X-EPOCAGENDAENTRYTYPE
* X-FUNAMBOL-AALARMOPTIONS
* X-FUNAMBOL-ALLDAY
* X-MICROSOFT-CDO-ALLDAYEVENT
* X-MICROSOFT-CDO-BUSYSTATUS
* X-WR-CALNAME
* X-WR-CALDESC
* X-WR-RELCALID
* X-WR-TIMEZONE
* X-PUBLISHED-TTL

[[Category:文件格式]]
[[Category:日程管理軟體]]