Redigerer ICalendar (avsnitt)

=== Kjerneobjekt ===
Toppnivå-elementet i iCalendar heter Calendaring and Scheduling Core Object, og er en samling av kalender- og planleggingsinformasjon. Vanligvis vil denne informasjonen bestå av et enkelt iCalendar-objekt, men imidlertid kan også flere iCalendar-objekter grupperes sammen.

Den første linjen må være <code>BEGIN:VCALENDAR</code>, og den siste linjen må være <code>END:VCALENDAR</code>. Innholdet mellom disse linjene kalles "icalbody" (kroppen). Kroppen må inneholde kalenderegenskapene "PRODID" og "VERSION". I tillegg må den inneholde minst én kalenderkomponent. Merk også at mens denne artikkelen ofte bruker en e-poststilen <code>UID</code> (unik identifikator) så anses dette nå som dårlig praksis, og en [[universell unik identifikator]] (UUID) bør brukes istedet.

<code>VERSION</code> er 2.0 for gjeldende iCalendar-format per 2016. <code>VERSION: 1.0</code> ble brukt til å spesifisere at dataene er i det gamle vCalendar-formatet.

Kroppen til iCalendar-objektet (icalbody) inneholder enkeltlinjers ''Calendar Properties'' ("kalenderegenskaper") som gjelder for hele kalenderen, samt en eller flere blokker med flere linjer som hver definerer en ''Calendar Component'' ("kalenderkomponent") som for eksempel en hendelse, journaloppføring, alarm eller en av de andre typene som beskrevet nedenfor. Her følger er et enkelt eksempel på et iCalendar-objekt med én enkelt kalender som inneholder én enkelt  ''Calendar Component'', et arrangement kalt "Fest i anledning den [[Frankrikes nasjonaldag|franske nasjonaldag]]" som starter 1997 juli den 14. klokken 17:00 og slutter klokken 16:00 neste morgen.<pre>
BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//hacksw/handcal//NONSGML v1.0//EN
BEGIN:VEVENT
UID:uid1@example.com
DTSTAMP:19970714T170000Z
ORGANIZER;CN=Kari Nordmann:MAILTO:kari.nordmann@example.com
DTSTART:19970714T170000Z
DTEND:19970715T040000Z
SUMMARY:Fest i anledning den franske nasjonaldagen
GEO:59.9130;10.7400
END:VEVENT
END:VCALENDAR
</pre>{{Refn|From RFC 2445|group=nb|name="From RFC 2445"}}

==== Dato- og tidsformat ====
{{se også|Koordinert universaltid|ISO 8601}}
Den vanligste representasjonen av dato og klokkeslett er et ''tz-tidsstempel'', for eksempel <code>20010911T124640Z</code> med formatet <code><nowiki><år (4 sifre)><måned (2)><dag (2)>T<time (2)><minutt (2)><sekund (2)>Z</nowiki></code> for en total fast lengde på 16 tegn. ''Z'' indikerer her bruk av [[Koordinert universaltid|UTC]] (som i sin tid refererte til "zulu-tidssonen"). Når man bruker <code>DTSTART</code> og <code>DTEND</code> -egenskapene er starttider [[Intervall (matematikk)|inkluderende]], mens sluttider ikke er det. Dette muliggjør at en sluttiden til en hendelse kan være den samme som starten av en påfølgende hendelses uten at disse hendelsene overlapper hverandre og potensielt skaper (falske) planleggingskonflikter.

==== Hendelser (VEVENT) ====
<code>VEVENT</code> beskriver en hendelse som har en planlagt tidsperiode i en kalender. Vanligvis når en bruker godtar kalenderhendelsen vil dette føre til at tiden blir ansett som opptatt.{{Refn|But an event can be set to be "TRANSPARENT" to change this interpretation.|group=nb}} En <code>VEVENT</code> kan inkludere en <code>VALARM</code> som tillater en alarm. Slike hendelser har en <code>DTSTART</code> som setter en starttid, og en <code>DTEND</code> som setter en sluttid. Dersom kalenderhendelsen gjentar seg vil <code>DTSTART</code> sette opp starttidspunktet for den første hendelsen.

Eksempel på en VALARM-kode (påminnelse 1 dag før):
<pre>
BEGIN:VALARM
TRIGGER:-PT1440M
ACTION:DISPLAY
DESCRIPTION:Reminder
END:VALARM
</pre><code>VEVENT</code> brukes også til kalenderhendelser uten en bestemt tid, som for eksempel jubileer og daglige påminnelser.{{Refn|These events would have a <code>DATE</code> value type for the <code>DTSTART</code> property instead of the default <code>DATE-TIME</code>, and need not include a <code>DTEND</code> property.|group=nb}} Dersom brukeren må sende inn en avbestilling for en hendelse skal UID være den samme som den opprinnelige hendelsen, og komponentegenskapene skal settes til avbryt.
<pre>
METHOD:CANCEL
STATUS:CANCELLED
</pre>

For å sende en <code>UPDATE</code> (oppdatering) for et arrangement bør <code>UID</code> samsvare med den originale <code>UID</code>-en. Den andre komponentegenskapen som skal settes er:
<pre>SEQUENCE:<Num of Update></pre>For den første oppdateringen vil dermed:<pre>SEQUENCE:1</pre>I Microsoft Outlook tilsvarer <code>SUMMARY</code> med "emne"-oppføringen i "avtaleskjemaet", og <code>DESCRIPTION</code> til den beskrivende teksten under den. I tillegg krevde Outlook 2002 og Outlook 2003 en <code>UID</code> og en <code>DTSTAMP</code>.

==== Gjøremål (VTODO) ====
VTODO beskriver et gjøremål, altså et handlingselement eller en oppgave.

Ikke alle kalenderprogrammer anerkjenner VTODO-elementer. Spesifikt vil ikke Outlook eksportere oppgaver som VTODO-elementer, og ignorerer VTODO-elementer i importerte kalendere.<ref>{{Kilde www|url=https://msdn.microsoft.com/en-us/library/ee624464%28v=exchg.80%29.aspx|tittel=[RFC5546] Section 3.4 Methods for VTODO Components|besøksdato=7. august 2015}}</ref>

Følgende er et eksempel på en oppgave som forfaller 1998 april 15.{{Refn|group=nb|name="From RFC 2445"}} En lydalarm er spesifisert for å minne kalenderbrukeren ved middagstid (kl. 12:00) dagen før oppgaven forventes å være fullført, og gjenta hver time opptil fire ganger til. SEQUENCE-elementet viser at denne oppgaven har blitt endret to ganger siden den ble opprettet.
<pre>
BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//ABC Corporation//NONSGML My Product//EN
BEGIN:VTODO
DTSTAMP:19980130T134500Z
SEQUENCE:2
UID:uid4@example.com
DUE:19980415T235959
STATUS:NEEDS-ACTION
SUMMARY:Sende inn skattemelding
BEGIN:VALARM
ACTION:AUDIO
TRIGGER:19980414T120000
ATTACH;FMTTYPE=audio/basic:http://example.com/pub/audio-
 files/ssbanner.aud
REPEAT:4
DURATION:PT1H
END:VALARM
END:VTODO
END:VCALENDAR
</pre>

==== Journalføring (VJOURNAL) ====
VJOURNAL er en journaloppføring. De legger ved en beskrivende tekst til en bestemt kalenderdato, og kan brukes til å registrere en daglig oversikt over aktiviteter eller prestasjoner, eller beskrive fremgang relatert til en gjøremålsoppføring. En "VJOURNAL"-kalenderkomponent tar ikke opp tid på en kalender, og har dermed ingen effekt på ledig eller opptatt tid (akkurat som TRANSPARENT-oppføringer). I praksis er det få programmer som støtter VJOURNAL-oppføringer, men det finnes eksempler: Plum Canary sin Chirp-programvare bruker VTODO og VJOURNAL sammen. VJOURNAL støttes også av [[Kontact|KOrganizer]] fra KDE Desktop og [[Novell Evolution|Evolution]] fra [[GNOME]] desktop.

Følgende er et eksempel på en journaloppføring:{{Refn|group=nb|name="From RFC 2445"}}
<pre>
BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//ABC Corporation//NONSGML My Product//EN
BEGIN:VJOURNAL
DTSTAMP:19970324T120000Z
UID:uid5@example.com
ORGANIZER:MAILTO:jsmith@example.com
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
</pre>(Merk: Dette eksemplet er hentet fra RFC 2445 med korreksjonen at ordet CATEGORIES ble endret fra CATEGORY som var en feil i den opprinnelige RFC-en.)

==== Ledig/opptatt tid (VFREEBUSY) ====
VFREEBUSY kan enten være en forespørsel om ledig eller opptatt tid, et svar på en forespørsel, eller en publisert mengde med opptatt tid.{{Refn|As described in RFC 2445:

<blockquote>When used to request free/busy time information, the "ATTENDEE" property specifies the calendar users whose free/busy time is being requested; the "ORGANIZER" property specifies the calendar user who is requesting the free/busy time; the "DTSTART" and "DTEND" properties specify the window of time for which the free/busy time is being requested; the "UID" and "DTSTAMP" properties are specified to assist in proper sequencing of multiple free/busy time requests.</blockquote>

<blockquote>When used to reply to a request for free/busy time, the "ATTENDEE" property specifies the calendar user responding to the free/busy time request; the "ORGANIZER" property specifies the calendar user that originally requested the free/busy time; the "FREEBUSY" property specifies the free/busy time information (if it exists); and the "UID" and "DTSTAMP" properties are specified to assist in proper sequencing of multiple free/busy time replies.</blockquote>

<blockquote>When used to publish busy time, the "ORGANIZER" property specifies the calendar user associated with the published busy time; the "DTSTART" and "DTEND" properties specify an inclusive time window that surrounds the busy time information; the "FREEBUSY" property specifies the published busy time information; and the "DTSTAMP" property specifies the date/time that iCalendar object was created.</blockquote>|group=nb}}

Følgende er et eksempel på publisert informasjon om opptatt tid:{{Refn|From RFC 2445 The
iCalendar object might be placed at some URL with the extension ".ifb"|group=nb}}
<pre>
BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//RDU Software//NONSGML HandCal//EN
BEGIN:VFREEBUSY
DTSTAMP:20151013T080000Z
UID:uid6@example.com
ORGANIZER:MAILTO:jsmith@example.com
DTSTART:19980313T141711Z
DTEND:19980410T141711Z
FREEBUSY:19980314T233000Z/19980315T003000Z
FREEBUSY:19980316T153000Z/19980316T163000Z
FREEBUSY:19980318T030000Z/19980318T040000Z
URL:http://www.example.com/calendar/busytime/jsmith.ifb
END:VFREEBUSY
END:VCALENDAR
</pre>

==== Andre komponenttyper ====
Andre komponenttyper inkluderer '''VAVAILABILITY''', '''VTIMEZONE''' (tidssone) og '''VALARM''' (alarm). Enkelte komponenter kan inneholde andre komponenter (VALARM er ofte inkludert i andre komponenter).{{Refn|Some components are often defined to support other components defined after them (VTIMEZONE is often used this way).{{Clarify|date=December 2008}}|group=nb}}

==== Distribuering av oppdateringer ====
UID-feltet distribuerer oppdateringer når en planlagt hendelse endres. Når hendelsen først genereres opprettes en [[Universell unik identifikator|globalt unikt]] identifikator. Hvis en senere hendelse distribueres med samme UID erstatter den nye den opprinnelige.{{Refn|An example UID might be "Y2007S2C131M5@example.edu", for the 5th meeting of class 131 in semester 2 at a hypothetical college.|group=nb}}