isimplify the output so its readable, parseable, easy to write - ics2txt - convert icalendar .ics file to plain text Err bitreich.org 70 hgit clone git://bitreich.org/ics2txt git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/ics2txt URL:git://bitreich.org/ics2txt git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/ics2txt bitreich.org 70 1Log /scm/ics2txt/log.gph bitreich.org 70 1Files /scm/ics2txt/files.gph bitreich.org 70 1Refs /scm/ics2txt/refs.gph bitreich.org 70 1Tags /scm/ics2txt/tag bitreich.org 70 1README /scm/ics2txt/file/README.md.gph bitreich.org 70 i--- Err bitreich.org 70 1commit 7ef52e239bfc8757d45f3d868920dba32dcb5b61 /scm/ics2txt/commit/7ef52e239bfc8757d45f3d868920dba32dcb5b61.gph bitreich.org 70 1parent 31dd5e1db68625ddd31ab25ce43877ca77df927f /scm/ics2txt/commit/31dd5e1db68625ddd31ab25ce43877ca77df927f.gph bitreich.org 70 hAuthor: Josuah Demangeon URL:mailto:mail@josuah.net bitreich.org 70 iDate: Sun, 7 Jul 2019 21:50:43 +0200 Err bitreich.org 70 i Err bitreich.org 70 isimplify the output so its readable, parseable, easy to write Err bitreich.org 70 i Err bitreich.org 70 iDiffstat: Err bitreich.org 70 i M Makefile | 4 ++-- Err bitreich.org 70 i M README | 109 ++++++++++++++++++++----------- Err bitreich.org 70 i D doc/rfc5545.txt | 9411 ------------------------------- Err bitreich.org 70 i M ics2txt | 183 ++++++++++++++----------------- Err bitreich.org 70 i M ics2txt.1 | 44 +++---------------------------- Err bitreich.org 70 i D txt2ics | 93 ------------------------------- Err bitreich.org 70 i D txt2ics.1 | 51 ------------------------------- Err bitreich.org 70 i Err bitreich.org 70 i7 files changed, 156 insertions(+), 9739 deletions(-) Err bitreich.org 70 i--- Err bitreich.org 70 1diff --git a/Makefile b/Makefile /scm/ics2txt/file/Makefile.gph bitreich.org 70 i@@ -1,5 +1,5 @@ Err bitreich.org 70 i-BIN = ics2txt txt2ics Err bitreich.org 70 i-MAN1 = ics2txt.1 txt2ics.1 Err bitreich.org 70 i+BIN = ics2txt Err bitreich.org 70 i+MAN1 = ics2txt.1 Err bitreich.org 70 i Err bitreich.org 70 i all: Err bitreich.org 70 i Err bitreich.org 70 1diff --git a/README b/README /scm/ics2txt/file/README.gph bitreich.org 70 i@@ -1,52 +1,83 @@ Err bitreich.org 70 i-agenda Err bitreich.org 70 i-================================================================================ Err bitreich.org 70 i+ics2txt Err bitreich.org 70 i+======= Err bitreich.org 70 i Err bitreich.org 70 i-*agenda* is an awk scripts to deal with iCal [1] format to publish, Err bitreich.org 70 i+*ics2txt* is an awk scripts to deal with iCal [1] format to publish, Err bitreich.org 70 i display and convert *.ics files. Err bitreich.org 70 i Err bitreich.org 70 i-It is still a work in progress and should be released soon. In the meantime, Err bitreich.org 70 i-example output from l'agenda du libre [2]: Err bitreich.org 70 i+[1]: https://tools.ietf.org/rfc/rfc5545.txt Err bitreich.org 70 i Err bitreich.org 70 i- [2017/04] Err bitreich.org 70 i+Sample output: Err bitreich.org 70 i Err bitreich.org 70 i- 19 16:00 Linux et les Logiciels Libres Err bitreich.org 70 i- 19:00 château Goerg, Callian, Provence-Alpes-Côte d'Azur, France Err bitreich.org 70 i- Venez découvrir Linux et les logiciels libres, mais aussi vous Err bitreich.org 70 i- faire aider avec votre matériel informatique quel qu’il soit, Err bitreich.org 70 i- imprimante, box, tablette, smartphone y compris. Err bitreich.org 70 i+2019-02-02 Err bitreich.org 70 i Err bitreich.org 70 i- 16:30 Permanence GNU/Linux - Les Quatre Libertés Err bitreich.org 70 i- 18:30 10 rue François Henry d’Harcourt, Montpellier, Occitanie, France Err bitreich.org 70 i+07:30 Welcome to FOSDEM 2019 Err bitreich.org 70 i+07:55 Janson Err bitreich.org 70 i+ FOSDEM welcome and opening talk. Err bitreich.org 70 i Err bitreich.org 70 i- 17:00 Atelier artiste - hacker Err bitreich.org 70 i- 19:00 62 rue Fiéffé, Bordeaux, Nouvelle-Aquitaine, France Err bitreich.org 70 i- Ateliers-cours à la fabrique-pola - L@bx Err bitreich.org 70 i+08:30 The State of Go Err bitreich.org 70 i+09:00 UD2.120 (Chavanne) Err bitreich.org 70 i+ Go 1.12 is planned to be released in February 2019 and this talk Err bitreich.org 70 i+ covers what's coming up with it.We'll talk about Go Modules, the Err bitreich.org 70 i+ proposals for Go 2, and all of the new things you might have missed. Err bitreich.org 70 i Err bitreich.org 70 i- 17:00 Introduction à la programmation de jeux Err bitreich.org 70 i- 19:00 55 rue de Vincennes, Montreuil, Île-de-France, France Err bitreich.org 70 i+09:30 HTTP/3 Err bitreich.org 70 i+10:30 UD2.208 (Decroly) Err bitreich.org 70 i+ HTTP/3 is the next coming HTTP version. This time TCP is replaced by Err bitreich.org 70 i+ the new transport protocol QUIC and things are different yet again! Err bitreich.org 70 i Err bitreich.org 70 i- 17:30 SGEG Err bitreich.org 70 i- 20:00 8 rue Colary, Carnac, Bretagne, France Err bitreich.org 70 i- Le SGEG (Sansten GNU Easy Group) vous invite tous les Err bitreich.org 70 i- 3e mercredi de chaque mois au SGEG Meeting pour discuter de Err bitreich.org 70 i- Logiciel Libre, boire un verre, manger un morceau et surtout se Err bitreich.org 70 i- rencontrer ! Err bitreich.org 70 i+10:05 Minimalism matters Err bitreich.org 70 i+10:25 K.4.201 Err bitreich.org 70 i+ Minimalism matters in computing. To trust systems we need to be able Err bitreich.org 70 i+ to understand them completely. Openssl heartbleed disaster was caused Err bitreich.org 70 i+ by code no longer being minimalistic, even if it is free and open Err bitreich.org 70 i+ source software. Hardware manfucturers and proprietary closed source Err bitreich.org 70 i+ solutions make things even worse with expectations of intrusion to Err bitreich.org 70 i+ privacy and backdoors if we don't aim for free hardware, software and Err bitreich.org 70 i+ minimalism. In this talk I will discuss minimalism in a broad context Err bitreich.org 70 i+ and narrow down on what the free software community can aim for. Err bitreich.org 70 i Err bitreich.org 70 i- 17:30 Rencontre Logiciels Libres Err bitreich.org 70 i- 20:30 17 rue Bellegarde, Toulouse, Occitanie, France Err bitreich.org 70 i- L’association Toulibre organise une rencontre autour des Err bitreich.org 70 i- Logiciels Libres le mercredi 19 avril 2017, de 19h30 à 22h30 au Err bitreich.org 70 i- Centre Culturel Bellegarde, 17 rue Bellegarde à Toulouse. Err bitreich.org 70 i+2019-02-03 Err bitreich.org 70 i Err bitreich.org 70 i- 19:00 Rencontre Tetalab Err bitreich.org 70 i- 21:00 12 rue Ferdinand Lassalle, Toulouse, Occitanie, France Err bitreich.org 70 i- Rencontre hebdomadaire des hackers et artistes libristes Err bitreich.org 70 i- Toulousains. Err bitreich.org 70 i+07:55 Microkernel virtualization under one roof Err bitreich.org 70 i+08:30 AW1.121 Err bitreich.org 70 i+ Today's off-the-shell virtualization solution is ridden with Err bitreich.org 70 i+ complexity. Application of virtualization call for trustworthy Err bitreich.org 70 i+ solutions. Complexity defeats trust.Microkernels with virtualization Err bitreich.org 70 i+ extensions and user-level VMMs on top are a approach to mitigate Err bitreich.org 70 i+ complexity. Modern microkernels like seL4, the NOVA microhypervisor, Err bitreich.org 70 i+ Genode's -hw- kernel or Fiasco.OC are such promising candidates. Err bitreich.org 70 i+ Fortunately and unfortunately, the diversity come with fragmentation Err bitreich.org 70 i+ of the small microkernel community. There are several VMMs for each Err bitreich.org 70 i+ platform tight to a specific microkernel, rendering it unusable Err bitreich.org 70 i+ across various kernels.Genode supports several kernels already, so Err bitreich.org 70 i+ that unification of virtualization interfaces for VMMs across kernels Err bitreich.org 70 i+ seem to come into reach. Does it ? The talk will cover the venture Err bitreich.org 70 i+ and current state of harmonization hardware-assisted virtualization Err bitreich.org 70 i+ interfaces to fit into the Genode OS framework. Err bitreich.org 70 i Err bitreich.org 70 i- 20 16:00 Soirée Cozy Cloud Err bitreich.org 70 i- 18:00 123 boulevard Louis Blanc, La Roche-sur-Yon, Pays de la Loire, France Err bitreich.org 70 i- Le 20 Avril 2017, K’ Rément Libre et LabOuest vous proposent Err bitreich.org 70 i- de venir découvrir Cozy. Err bitreich.org 70 i+14:40 FOSDEM infrastructure review Err bitreich.org 70 i+14:55 H.2215 (Ferrer) Err bitreich.org 70 i+ Informational and fun. Err bitreich.org 70 i+ Err bitreich.org 70 i+15:00 2019 - Fifty years of Unix and Linux advances Err bitreich.org 70 i+15:50 Janson Err bitreich.org 70 i+ 2019 marks the fiftieth anniversary of Unix, but it is also the Err bitreich.org 70 i+ fiftieth anniversary of the ArpaNet/Internet, and people walking on Err bitreich.org 70 i+ the moon. It marks the 50th anniversary of Woodstock, the beginning Err bitreich.org 70 i+ of America's LGBTQ movement at the Stonewall Inn in New York City, Err bitreich.org 70 i+ and maddog wrote his first program fifty years ago. It was also in Err bitreich.org 70 i+ 1969 that he shaved for the last time.2019 marks the 30th year of the Err bitreich.org 70 i+ World Wide Web, the 25th anniversary of V1.0 of the Linux kernel, and Err bitreich.org 70 i+ of many GNU/Linux distributions starting. 2019 also marks the Err bitreich.org 70 i+ twentieth anniversary of the Linux Professional Institute.All of Err bitreich.org 70 i+ these years, and anniversaries.....but why has Unix (and its younger Err bitreich.org 70 i+ offspring Linux) lasted so long? What was different about Unix that Err bitreich.org 70 i+ caused it to survive and flourish? Why is it important today, and Err bitreich.org 70 i+ how can we take it further? How should we celebrate 2019? While Err bitreich.org 70 i+ maddog does not have all the answers, he tries to make the answers he Err bitreich.org 70 i+ does have interesting and fun to know. Err bitreich.org 70 i+ Err bitreich.org 70 i+15:55 Closing FOSDEM 2019 Err bitreich.org 70 i+16:00 Janson Err bitreich.org 70 i+ Some closing words. Don't miss it! Err bitreich.org 70 i Err bitreich.org 70 i-[1]: https://tools.ietf.org/rfc/rfc5545.txt Err bitreich.org 70 i-[2]: https://www.agendadulibre.org Err bitreich.org 70 1diff --git a/doc/rfc5545.txt b/doc/rfc5545.txt /scm/ics2txt/file/doc/rfc5545.txt.gph bitreich.org 70 i@@ -1,9411 +0,0 @@ Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Network Working Group B. Desruisseaux, Ed. Err bitreich.org 70 i-Request for Comments: 5545 Oracle Err bitreich.org 70 i-Obsoletes: 2445 September 2009 Err bitreich.org 70 i-Category: Standards Track Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Internet Calendaring and Scheduling Core Object Specification Err bitreich.org 70 i- (iCalendar) Err bitreich.org 70 i- Err bitreich.org 70 i-Abstract Err bitreich.org 70 i- Err bitreich.org 70 i-This document defines the iCalendar data format for representing and Err bitreich.org 70 i-exchanging calendaring and scheduling information such as events, Err bitreich.org 70 i-to-dos, journal entries, and free/busy information, independent of any Err bitreich.org 70 i-particular calendar service or protocol. Err bitreich.org 70 i- Err bitreich.org 70 i-Status of This Memo Err bitreich.org 70 i- Err bitreich.org 70 i- This document specifies an Internet standards track protocol for the Err bitreich.org 70 i- Internet community, and requests discussion and suggestions for Err bitreich.org 70 i- improvements. Please refer to the current edition of the "Internet Err bitreich.org 70 i- Official Protocol Standards" (STD 1) for the standardization state Err bitreich.org 70 i- and status of this protocol. Distribution of this memo is unlimited. Err bitreich.org 70 i- Err bitreich.org 70 i-Copyright and License Notice Err bitreich.org 70 i- Err bitreich.org 70 i- Copyright (c) 2009 IETF Trust and the persons identified as the Err bitreich.org 70 i- document authors. All rights reserved. Err bitreich.org 70 i- Err bitreich.org 70 i- This document is subject to BCP 78 and the IETF Trust's Legal Err bitreich.org 70 i- Provisions Relating to IETF Documents Err bitreich.org 70 i- (http://trustee.ietf.org/license-info) in effect on the date of Err bitreich.org 70 i- publication of this document. Please review these documents Err bitreich.org 70 i- carefully, as they describe your rights and restrictions with respect Err bitreich.org 70 i- to this document. Code Components extracted from this document must Err bitreich.org 70 i- include Simplified BSD License text as described in Section 4.e of Err bitreich.org 70 i- the Trust Legal Provisions and are provided without warranty as Err bitreich.org 70 i- described in the BSD License. Err bitreich.org 70 i- Err bitreich.org 70 i- This document may contain material from IETF Documents or IETF Err bitreich.org 70 i- Contributions published or made publicly available before November Err bitreich.org 70 i- 10, 2008. The person(s) controlling the copyright in some of this Err bitreich.org 70 i- material may not have granted the IETF Trust the right to allow Err bitreich.org 70 i- modifications of such material outside the IETF Standards Process. Err bitreich.org 70 i- Without obtaining an adequate license from the person(s) controlling Err bitreich.org 70 i- the copyright in such materials, this document may not be modified Err bitreich.org 70 i- outside the IETF Standards Process, and derivative works of it may Err bitreich.org 70 i- not be created outside the IETF Standards Process, except to format Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 1] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- it for publication as an RFC or to translate it into languages other Err bitreich.org 70 i- than English. Err bitreich.org 70 i- Err bitreich.org 70 i-Table of Contents Err bitreich.org 70 i- Err bitreich.org 70 i- 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 5 Err bitreich.org 70 i- 2. Basic Grammar and Conventions . . . . . . . . . . . . . . . . 6 Err bitreich.org 70 i- 2.1. Formatting Conventions . . . . . . . . . . . . . . . . . 6 Err bitreich.org 70 i- 2.2. Related Memos . . . . . . . . . . . . . . . . . . . . . . 7 Err bitreich.org 70 i- 3. iCalendar Object Specification . . . . . . . . . . . . . . . 8 Err bitreich.org 70 i- 3.1. Content Lines . . . . . . . . . . . . . . . . . . . . . . 8 Err bitreich.org 70 i- 3.1.1. List and Field Separators . . . . . . . . . . . . . . 11 Err bitreich.org 70 i- 3.1.2. Multiple Values . . . . . . . . . . . . . . . . . . . 11 Err bitreich.org 70 i- 3.1.3. Binary Content . . . . . . . . . . . . . . . . . . . 11 Err bitreich.org 70 i- 3.1.4. Character Set . . . . . . . . . . . . . . . . . . . . 12 Err bitreich.org 70 i- 3.2. Property Parameters . . . . . . . . . . . . . . . . . . . 12 Err bitreich.org 70 i- 3.2.1. Alternate Text Representation . . . . . . . . . . . . 13 Err bitreich.org 70 i- 3.2.2. Common Name . . . . . . . . . . . . . . . . . . . . . 15 Err bitreich.org 70 i- 3.2.3. Calendar User Type . . . . . . . . . . . . . . . . . 15 Err bitreich.org 70 i- 3.2.4. Delegators . . . . . . . . . . . . . . . . . . . . . 16 Err bitreich.org 70 i- 3.2.5. Delegatees . . . . . . . . . . . . . . . . . . . . . 16 Err bitreich.org 70 i- 3.2.6. Directory Entry Reference . . . . . . . . . . . . . . 17 Err bitreich.org 70 i- 3.2.7. Inline Encoding . . . . . . . . . . . . . . . . . . . 17 Err bitreich.org 70 i- 3.2.8. Format Type . . . . . . . . . . . . . . . . . . . . . 18 Err bitreich.org 70 i- 3.2.9. Free/Busy Time Type . . . . . . . . . . . . . . . . . 19 Err bitreich.org 70 i- 3.2.10. Language . . . . . . . . . . . . . . . . . . . . . . 20 Err bitreich.org 70 i- 3.2.11. Group or List Membership . . . . . . . . . . . . . . 20 Err bitreich.org 70 i- 3.2.12. Participation Status . . . . . . . . . . . . . . . . 21 Err bitreich.org 70 i- 3.2.13. Recurrence Identifier Range . . . . . . . . . . . . . 22 Err bitreich.org 70 i- 3.2.14. Alarm Trigger Relationship . . . . . . . . . . . . . 23 Err bitreich.org 70 i- 3.2.15. Relationship Type . . . . . . . . . . . . . . . . . . 24 Err bitreich.org 70 i- 3.2.16. Participation Role . . . . . . . . . . . . . . . . . 25 Err bitreich.org 70 i- 3.2.17. RSVP Expectation . . . . . . . . . . . . . . . . . . 25 Err bitreich.org 70 i- 3.2.18. Sent By . . . . . . . . . . . . . . . . . . . . . . . 26 Err bitreich.org 70 i- 3.2.19. Time Zone Identifier . . . . . . . . . . . . . . . . 26 Err bitreich.org 70 i- 3.2.20. Value Data Types . . . . . . . . . . . . . . . . . . 28 Err bitreich.org 70 i- 3.3. Property Value Data Types . . . . . . . . . . . . . . . . 29 Err bitreich.org 70 i- 3.3.1. Binary . . . . . . . . . . . . . . . . . . . . . . . 29 Err bitreich.org 70 i- 3.3.2. Boolean . . . . . . . . . . . . . . . . . . . . . . . 30 Err bitreich.org 70 i- 3.3.3. Calendar User Address . . . . . . . . . . . . . . . . 30 Err bitreich.org 70 i- 3.3.4. Date . . . . . . . . . . . . . . . . . . . . . . . . 31 Err bitreich.org 70 i- 3.3.5. Date-Time . . . . . . . . . . . . . . . . . . . . . . 31 Err bitreich.org 70 i- 3.3.6. Duration . . . . . . . . . . . . . . . . . . . . . . 34 Err bitreich.org 70 i- 3.3.7. Float . . . . . . . . . . . . . . . . . . . . . . . . 35 Err bitreich.org 70 i- 3.3.8. Integer . . . . . . . . . . . . . . . . . . . . . . . 35 Err bitreich.org 70 i- 3.3.9. Period of Time . . . . . . . . . . . . . . . . . . . 36 Err bitreich.org 70 i- 3.3.10. Recurrence Rule . . . . . . . . . . . . . . . . . . . 37 Err bitreich.org 70 i- 3.3.11. Text . . . . . . . . . . . . . . . . . . . . . . . . 45 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 2] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- 3.3.12. Time . . . . . . . . . . . . . . . . . . . . . . . . 46 Err bitreich.org 70 i- 3.3.13. URI . . . . . . . . . . . . . . . . . . . . . . . . . 48 Err bitreich.org 70 i- 3.3.14. UTC Offset . . . . . . . . . . . . . . . . . . . . . 49 Err bitreich.org 70 i- 3.4. iCalendar Object . . . . . . . . . . . . . . . . . . . . 49 Err bitreich.org 70 i- 3.5. Property . . . . . . . . . . . . . . . . . . . . . . . . 50 Err bitreich.org 70 i- 3.6. Calendar Components . . . . . . . . . . . . . . . . . . . 50 Err bitreich.org 70 i- 3.6.1. Event Component . . . . . . . . . . . . . . . . . . . 52 Err bitreich.org 70 i- 3.6.2. To-Do Component . . . . . . . . . . . . . . . . . . . 56 Err bitreich.org 70 i- 3.6.3. Journal Component . . . . . . . . . . . . . . . . . . 58 Err bitreich.org 70 i- 3.6.4. Free/Busy Component . . . . . . . . . . . . . . . . . 60 Err bitreich.org 70 i- 3.6.5. Time Zone Component . . . . . . . . . . . . . . . . . 63 Err bitreich.org 70 i- 3.6.6. Alarm Component . . . . . . . . . . . . . . . . . . . 72 Err bitreich.org 70 i- 3.7. Calendar Properties . . . . . . . . . . . . . . . . . . . 77 Err bitreich.org 70 i- 3.7.1. Calendar Scale . . . . . . . . . . . . . . . . . . . 77 Err bitreich.org 70 i- 3.7.2. Method . . . . . . . . . . . . . . . . . . . . . . . 78 Err bitreich.org 70 i- 3.7.3. Product Identifier . . . . . . . . . . . . . . . . . 79 Err bitreich.org 70 i- 3.7.4. Version . . . . . . . . . . . . . . . . . . . . . . . 80 Err bitreich.org 70 i- 3.8. Component Properties . . . . . . . . . . . . . . . . . . 81 Err bitreich.org 70 i- 3.8.1. Descriptive Component Properties . . . . . . . . . . 81 Err bitreich.org 70 i- 3.8.1.1. Attachment . . . . . . . . . . . . . . . . . . . 81 Err bitreich.org 70 i- 3.8.1.2. Categories . . . . . . . . . . . . . . . . . . . 82 Err bitreich.org 70 i- 3.8.1.3. Classification . . . . . . . . . . . . . . . . . 83 Err bitreich.org 70 i- 3.8.1.4. Comment . . . . . . . . . . . . . . . . . . . . . 84 Err bitreich.org 70 i- 3.8.1.5. Description . . . . . . . . . . . . . . . . . . . 85 Err bitreich.org 70 i- 3.8.1.6. Geographic Position . . . . . . . . . . . . . . . 87 Err bitreich.org 70 i- 3.8.1.7. Location . . . . . . . . . . . . . . . . . . . . 88 Err bitreich.org 70 i- 3.8.1.8. Percent Complete . . . . . . . . . . . . . . . . 89 Err bitreich.org 70 i- 3.8.1.9. Priority . . . . . . . . . . . . . . . . . . . . 90 Err bitreich.org 70 i- 3.8.1.10. Resources . . . . . . . . . . . . . . . . . . . . 92 Err bitreich.org 70 i- 3.8.1.11. Status . . . . . . . . . . . . . . . . . . . . . 93 Err bitreich.org 70 i- 3.8.1.12. Summary . . . . . . . . . . . . . . . . . . . . . 94 Err bitreich.org 70 i- 3.8.2. Date and Time Component Properties . . . . . . . . . 95 Err bitreich.org 70 i- 3.8.2.1. Date-Time Completed . . . . . . . . . . . . . . . 95 Err bitreich.org 70 i- 3.8.2.2. Date-Time End . . . . . . . . . . . . . . . . . . 96 Err bitreich.org 70 i- 3.8.2.3. Date-Time Due . . . . . . . . . . . . . . . . . . 97 Err bitreich.org 70 i- 3.8.2.4. Date-Time Start . . . . . . . . . . . . . . . . . 99 Err bitreich.org 70 i- 3.8.2.5. Duration . . . . . . . . . . . . . . . . . . . . 100 Err bitreich.org 70 i- 3.8.2.6. Free/Busy Time . . . . . . . . . . . . . . . . . 101 Err bitreich.org 70 i- 3.8.2.7. Time Transparency . . . . . . . . . . . . . . . . 102 Err bitreich.org 70 i- 3.8.3. Time Zone Component Properties . . . . . . . . . . . 103 Err bitreich.org 70 i- 3.8.3.1. Time Zone Identifier . . . . . . . . . . . . . . 103 Err bitreich.org 70 i- 3.8.3.2. Time Zone Name . . . . . . . . . . . . . . . . . 105 Err bitreich.org 70 i- 3.8.3.3. Time Zone Offset From . . . . . . . . . . . . . . 106 Err bitreich.org 70 i- 3.8.3.4. Time Zone Offset To . . . . . . . . . . . . . . . 106 Err bitreich.org 70 i- 3.8.3.5. Time Zone URL . . . . . . . . . . . . . . . . . . 107 Err bitreich.org 70 i- 3.8.4. Relationship Component Properties . . . . . . . . . . 108 Err bitreich.org 70 i- 3.8.4.1. Attendee . . . . . . . . . . . . . . . . . . . . 108 Err bitreich.org 70 i- 3.8.4.2. Contact . . . . . . . . . . . . . . . . . . . . . 111 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 3] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- 3.8.4.3. Organizer . . . . . . . . . . . . . . . . . . . . 113 Err bitreich.org 70 i- 3.8.4.4. Recurrence ID . . . . . . . . . . . . . . . . . . 114 Err bitreich.org 70 i- 3.8.4.5. Related To . . . . . . . . . . . . . . . . . . . 117 Err bitreich.org 70 i- 3.8.4.6. Uniform Resource Locator . . . . . . . . . . . . 118 Err bitreich.org 70 i- 3.8.4.7. Unique Identifier . . . . . . . . . . . . . . . . 119 Err bitreich.org 70 i- 3.8.5. Recurrence Component Properties . . . . . . . . . . . 120 Err bitreich.org 70 i- 3.8.5.1. Exception Date-Times . . . . . . . . . . . . . . 120 Err bitreich.org 70 i- 3.8.5.2. Recurrence Date-Times . . . . . . . . . . . . . . 122 Err bitreich.org 70 i- 3.8.5.3. Recurrence Rule . . . . . . . . . . . . . . . . . 124 Err bitreich.org 70 i- 3.8.6. Alarm Component Properties . . . . . . . . . . . . . 134 Err bitreich.org 70 i- 3.8.6.1. Action . . . . . . . . . . . . . . . . . . . . . 134 Err bitreich.org 70 i- 3.8.6.2. Repeat Count . . . . . . . . . . . . . . . . . . 135 Err bitreich.org 70 i- 3.8.6.3. Trigger . . . . . . . . . . . . . . . . . . . . . 135 Err bitreich.org 70 i- 3.8.7. Change Management Component Properties . . . . . . . 138 Err bitreich.org 70 i- 3.8.7.1. Date-Time Created . . . . . . . . . . . . . . . . 138 Err bitreich.org 70 i- 3.8.7.2. Date-Time Stamp . . . . . . . . . . . . . . . . . 139 Err bitreich.org 70 i- 3.8.7.3. Last Modified . . . . . . . . . . . . . . . . . . 140 Err bitreich.org 70 i- 3.8.7.4. Sequence Number . . . . . . . . . . . . . . . . . 141 Err bitreich.org 70 i- 3.8.8. Miscellaneous Component Properties . . . . . . . . . 142 Err bitreich.org 70 i- 3.8.8.1. IANA Properties . . . . . . . . . . . . . . . . . 142 Err bitreich.org 70 i- 3.8.8.2. Non-Standard Properties . . . . . . . . . . . . . 142 Err bitreich.org 70 i- 3.8.8.3. Request Status . . . . . . . . . . . . . . . . . 144 Err bitreich.org 70 i- 4. iCalendar Object Examples . . . . . . . . . . . . . . . . . . 146 Err bitreich.org 70 i- 5. Recommended Practices . . . . . . . . . . . . . . . . . . . . 150 Err bitreich.org 70 i- 6. Internationalization Considerations . . . . . . . . . . . . . 151 Err bitreich.org 70 i- 7. Security Considerations . . . . . . . . . . . . . . . . . . . 151 Err bitreich.org 70 i- 8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 151 Err bitreich.org 70 i- 8.1. iCalendar Media Type Registration . . . . . . . . . . . . 151 Err bitreich.org 70 i- 8.2. New iCalendar Elements Registration . . . . . . . . . . . 155 Err bitreich.org 70 i- 8.2.1. iCalendar Elements Registration Procedure . . . . . . 155 Err bitreich.org 70 i- 8.2.2. Registration Template for Components . . . . . . . . 155 Err bitreich.org 70 i- 8.2.3. Registration Template for Properties . . . . . . . . 156 Err bitreich.org 70 i- 8.2.4. Registration Template for Parameters . . . . . . . . 156 Err bitreich.org 70 i- 8.2.5. Registration Template for Value Data Types . . . . . 157 Err bitreich.org 70 i- 8.2.6. Registration Template for Values . . . . . . . . . . 157 Err bitreich.org 70 i- 8.3. Initial iCalendar Elements Registries . . . . . . . . . . 158 Err bitreich.org 70 i- 8.3.1. Components Registry . . . . . . . . . . . . . . . . . 158 Err bitreich.org 70 i- 8.3.2. Properties Registry . . . . . . . . . . . . . . . . . 158 Err bitreich.org 70 i- 8.3.3. Parameters Registry . . . . . . . . . . . . . . . . . 161 Err bitreich.org 70 i- 8.3.4. Value Data Types Registry . . . . . . . . . . . . . . 162 Err bitreich.org 70 i- 8.3.5. Calendar User Types Registry . . . . . . . . . . . . 162 Err bitreich.org 70 i- 8.3.6. Free/Busy Time Types Registry . . . . . . . . . . . . 163 Err bitreich.org 70 i- 8.3.7. Participation Statuses Registry . . . . . . . . . . . 163 Err bitreich.org 70 i- 8.3.8. Relationship Types Registry . . . . . . . . . . . . . 164 Err bitreich.org 70 i- 8.3.9. Participation Roles Registry . . . . . . . . . . . . 164 Err bitreich.org 70 i- 8.3.10. Actions Registry . . . . . . . . . . . . . . . . . . 165 Err bitreich.org 70 i- 8.3.11. Classifications Registry . . . . . . . . . . . . . . 165 Err bitreich.org 70 i- 8.3.12. Methods Registry . . . . . . . . . . . . . . . . . . 165 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 4] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- 9. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 165 Err bitreich.org 70 i- 10. References . . . . . . . . . . . . . . . . . . . . . . . . . 166 Err bitreich.org 70 i- 10.1. Normative References . . . . . . . . . . . . . . . . . . 166 Err bitreich.org 70 i- 10.2. Informative References . . . . . . . . . . . . . . . . . 167 Err bitreich.org 70 i- Appendix A. Differences from RFC 2445 . . . . . . . . . . . . . 169 Err bitreich.org 70 i- A.1. New Restrictions . . . . . . . . . . . . . . . . . . . . 169 Err bitreich.org 70 i- A.2. Restrictions Removed . . . . . . . . . . . . . . . . . . 169 Err bitreich.org 70 i- A.3. Deprecated Features . . . . . . . . . . . . . . . . . . . 169 Err bitreich.org 70 i- Err bitreich.org 70 i-1. Introduction Err bitreich.org 70 i- Err bitreich.org 70 i- The use of calendaring and scheduling has grown considerably in the Err bitreich.org 70 i- last decade. Enterprise and inter-enterprise business has become Err bitreich.org 70 i- dependent on rapid scheduling of events and actions using this Err bitreich.org 70 i- information technology. This memo is intended to progress the level Err bitreich.org 70 i- of interoperability possible between dissimilar calendaring and Err bitreich.org 70 i- scheduling applications. This memo defines a MIME content type for Err bitreich.org 70 i- exchanging electronic calendaring and scheduling information. The Err bitreich.org 70 i- Internet Calendaring and Scheduling Core Object Specification, or Err bitreich.org 70 i- iCalendar, allows for the capture and exchange of information Err bitreich.org 70 i- normally stored within a calendaring and scheduling application; such Err bitreich.org 70 i- as a Personal Information Manager (PIM) or a Group-Scheduling Err bitreich.org 70 i- product. Err bitreich.org 70 i- Err bitreich.org 70 i- The iCalendar format is suitable as an exchange format between Err bitreich.org 70 i- applications or systems. The format is defined in terms of a MIME Err bitreich.org 70 i- content type. This will enable the object to be exchanged using Err bitreich.org 70 i- several transports, including but not limited to SMTP, HTTP, a file Err bitreich.org 70 i- system, desktop interactive protocols such as the use of a memory- Err bitreich.org 70 i- based clipboard or drag/drop interactions, point-to-point Err bitreich.org 70 i- asynchronous communication, wired-network transport, or some form of Err bitreich.org 70 i- unwired transport such as infrared. Err bitreich.org 70 i- Err bitreich.org 70 i- The memo also provides for the definition of iCalendar object methods Err bitreich.org 70 i- that will map this content type to a set of messages for supporting Err bitreich.org 70 i- calendaring and scheduling operations such as requesting, replying Err bitreich.org 70 i- to, modifying, and canceling meetings or appointments, to-dos, and Err bitreich.org 70 i- journal entries. The iCalendar object methods can be used to define Err bitreich.org 70 i- other calendaring and scheduling operations such as requesting for Err bitreich.org 70 i- and replying with free/busy time data. Such a scheduling protocol is Err bitreich.org 70 i- defined in the iCalendar Transport-independent Interoperability Err bitreich.org 70 i- Protocol (iTIP) defined in [2446bis]. Err bitreich.org 70 i- Err bitreich.org 70 i- The memo also includes a formal grammar for the content type based on Err bitreich.org 70 i- the Internet ABNF defined in [RFC5234]. This ABNF is required for Err bitreich.org 70 i- the implementation of parsers and to serve as the definitive Err bitreich.org 70 i- reference when ambiguities or questions arise in interpreting the Err bitreich.org 70 i- descriptive prose definition of the memo. Additional restrictions Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 5] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- that could not easily be expressed with the ABNF syntax are specified Err bitreich.org 70 i- as comments in the ABNF. Comments with normative statements should Err bitreich.org 70 i- be treated as such. Err bitreich.org 70 i- Err bitreich.org 70 i-2. Basic Grammar and Conventions Err bitreich.org 70 i- Err bitreich.org 70 i- The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", Err bitreich.org 70 i- "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this Err bitreich.org 70 i- document are to be interpreted as described in [RFC2119]. Err bitreich.org 70 i- Err bitreich.org 70 i- This memo makes use of both a descriptive prose and a more formal Err bitreich.org 70 i- notation for defining the calendaring and scheduling format. Err bitreich.org 70 i- Err bitreich.org 70 i- The notation used in this memo is the ABNF notation of [RFC5234]. Err bitreich.org 70 i- Readers intending on implementing the format defined in this memo Err bitreich.org 70 i- should be familiar with this notation in order to properly interpret Err bitreich.org 70 i- the specifications of this memo. Err bitreich.org 70 i- Err bitreich.org 70 i- All numeric values used in this memo are given in decimal notation. Err bitreich.org 70 i- Err bitreich.org 70 i- All names of properties, property parameters, enumerated property Err bitreich.org 70 i- values, and property parameter values are case-insensitive. However, Err bitreich.org 70 i- all other property values are case-sensitive, unless otherwise Err bitreich.org 70 i- stated. Err bitreich.org 70 i- Err bitreich.org 70 i- Note: All indented editorial notes, such as this one, are intended Err bitreich.org 70 i- to provide the reader with additional information. The Err bitreich.org 70 i- information is not essential to the building of an implementation Err bitreich.org 70 i- conformant with this memo. The information is provided to Err bitreich.org 70 i- highlight a particular feature or characteristic of the memo. Err bitreich.org 70 i- Err bitreich.org 70 i- The format for the iCalendar object is based on the syntax of the Err bitreich.org 70 i- text/directory media type [RFC2425]. While the iCalendar object is Err bitreich.org 70 i- not a profile of the text/directory media type [RFC2425], it does Err bitreich.org 70 i- reuse a number of the elements from the [RFC2425] specification. Err bitreich.org 70 i- Err bitreich.org 70 i-2.1. Formatting Conventions Err bitreich.org 70 i- Err bitreich.org 70 i- The elements defined in this memo are defined in prose. Many of the Err bitreich.org 70 i- terms used to describe these have common usage that is different than Err bitreich.org 70 i- the standards usage of this memo. In order to reference, within this Err bitreich.org 70 i- memo, elements of the calendaring and scheduling model, core object Err bitreich.org 70 i- (this memo), or interoperability protocol [2446bis] some formatting Err bitreich.org 70 i- conventions have been used. Calendaring and scheduling roles are Err bitreich.org 70 i- referred to in quoted-strings of text with the first character of Err bitreich.org 70 i- each word in uppercase. For example, "Organizer" refers to a role of Err bitreich.org 70 i- a "Calendar User" within the scheduling protocol defined by Err bitreich.org 70 i- [2446bis]. Calendar components defined by this memo are referred to Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 6] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- with capitalized, quoted-strings of text. All calendar components Err bitreich.org 70 i- start with the letter "V". For example, "VEVENT" refers to the event Err bitreich.org 70 i- calendar component, "VTODO" refers to the to-do calendar component, Err bitreich.org 70 i- and "VJOURNAL" refers to the daily journal calendar component. Err bitreich.org 70 i- Scheduling methods defined by iTIP [2446bis] are referred to with Err bitreich.org 70 i- capitalized, quoted-strings of text. For example, "REQUEST" refers Err bitreich.org 70 i- to the method for requesting a scheduling calendar component be Err bitreich.org 70 i- created or modified, and "REPLY" refers to the method a recipient of Err bitreich.org 70 i- a request uses to update their status with the "Organizer" of the Err bitreich.org 70 i- calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- The properties defined by this memo are referred to with capitalized, Err bitreich.org 70 i- quoted-strings of text, followed by the word "property". For Err bitreich.org 70 i- example, "ATTENDEE" property refers to the iCalendar property used to Err bitreich.org 70 i- convey the calendar address of a calendar user. Property parameters Err bitreich.org 70 i- defined by this memo are referred to with lowercase, quoted-strings Err bitreich.org 70 i- of text, followed by the word "parameter". For example, "value" Err bitreich.org 70 i- parameter refers to the iCalendar property parameter used to override Err bitreich.org 70 i- the default value type for a property value. Enumerated values Err bitreich.org 70 i- defined by this memo are referred to with capitalized text, either Err bitreich.org 70 i- alone or followed by the word "value". For example, the "MINUTELY" Err bitreich.org 70 i- value can be used with the "FREQ" component of the "RECUR" value type Err bitreich.org 70 i- to specify repeating components based on an interval of one minute or Err bitreich.org 70 i- more. Err bitreich.org 70 i- Err bitreich.org 70 i- The following table lists the different characters from the Err bitreich.org 70 i- [US-ASCII] character set that is referenced in this document. For Err bitreich.org 70 i- each character, the table specifies the character name used Err bitreich.org 70 i- throughout this document, along with its US-ASCII decimal codepoint. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 7] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- +------------------------+-------------------+ Err bitreich.org 70 i- | Character name | Decimal codepoint | Err bitreich.org 70 i- +------------------------+-------------------+ Err bitreich.org 70 i- | HTAB | 9 | Err bitreich.org 70 i- | LF | 10 | Err bitreich.org 70 i- | CR | 13 | Err bitreich.org 70 i- | DQUOTE | 22 | Err bitreich.org 70 i- | SPACE | 32 | Err bitreich.org 70 i- | PLUS SIGN | 43 | Err bitreich.org 70 i- | COMMA | 44 | Err bitreich.org 70 i- | HYPHEN-MINUS | 45 | Err bitreich.org 70 i- | PERIOD | 46 | Err bitreich.org 70 i- | SOLIDUS | 47 | Err bitreich.org 70 i- | COLON | 58 | Err bitreich.org 70 i- | SEMICOLON | 59 | Err bitreich.org 70 i- | LATIN CAPITAL LETTER N | 78 | Err bitreich.org 70 i- | LATIN CAPITAL LETTER T | 84 | Err bitreich.org 70 i- | LATIN CAPITAL LETTER X | 88 | Err bitreich.org 70 i- | LATIN CAPITAL LETTER Z | 90 | Err bitreich.org 70 i- | BACKSLASH | 92 | Err bitreich.org 70 i- | LATIN SMALL LETTER N | 110 | Err bitreich.org 70 i- +------------------------+-------------------+ Err bitreich.org 70 i- Err bitreich.org 70 i-2.2. Related Memos Err bitreich.org 70 i- Err bitreich.org 70 i- Implementers will need to be familiar with several other memos that, Err bitreich.org 70 i- along with this memo, form a framework for Internet calendaring and Err bitreich.org 70 i- scheduling standards. This memo specifies a core specification of Err bitreich.org 70 i- objects, value types, properties, and property parameters. Err bitreich.org 70 i- Err bitreich.org 70 i- o iTIP [2446bis] specifies an interoperability protocol for Err bitreich.org 70 i- scheduling between different implementations; Err bitreich.org 70 i- Err bitreich.org 70 i- o iCalendar Message-Based Interoperability Protocol (iMIP) [2447bis] Err bitreich.org 70 i- specifies an Internet email binding for [2446bis]. Err bitreich.org 70 i- Err bitreich.org 70 i- This memo does not attempt to repeat the specification of concepts or Err bitreich.org 70 i- definitions from these other memos. Where possible, references are Err bitreich.org 70 i- made to the memo that provides for the specification of these Err bitreich.org 70 i- concepts or definitions. Err bitreich.org 70 i- Err bitreich.org 70 i-3. iCalendar Object Specification Err bitreich.org 70 i- Err bitreich.org 70 i- The following sections define the details of a Calendaring and Err bitreich.org 70 i- Scheduling Core Object Specification. The Calendaring and Scheduling Err bitreich.org 70 i- Core Object is a collection of calendaring and scheduling Err bitreich.org 70 i- information. Typically, this information will consist of an Err bitreich.org 70 i- iCalendar stream with one or more iCalendar objects. The body of the Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 8] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- iCalendar object consists of a sequence of calendar properties and Err bitreich.org 70 i- one or more calendar components. Err bitreich.org 70 i- Err bitreich.org 70 i- Section 3.1 defines the content line format; Section 3.2 defines the Err bitreich.org 70 i- property parameter format; Section 3.3 defines the data types for Err bitreich.org 70 i- property values; Section 3.4 defines the iCalendar object format; Err bitreich.org 70 i- Section 3.5 defines the iCalendar property format; Section 3.6 Err bitreich.org 70 i- defines the calendar component format; Section 3.7 defines calendar Err bitreich.org 70 i- properties; and Section 3.8 defines calendar component properties. Err bitreich.org 70 i- Err bitreich.org 70 i- This information is intended to be an integral part of the MIME Err bitreich.org 70 i- content type registration. In addition, this information can be used Err bitreich.org 70 i- independent of such content registration. In particular, this memo Err bitreich.org 70 i- has direct applicability for use as a calendaring and scheduling Err bitreich.org 70 i- exchange format in file-, memory-, or network-based transport Err bitreich.org 70 i- mechanisms. Err bitreich.org 70 i- Err bitreich.org 70 i-3.1. Content Lines Err bitreich.org 70 i- Err bitreich.org 70 i- The iCalendar object is organized into individual lines of text, Err bitreich.org 70 i- called content lines. Content lines are delimited by a line break, Err bitreich.org 70 i- which is a CRLF sequence (CR character followed by LF character). Err bitreich.org 70 i- Err bitreich.org 70 i- Lines of text SHOULD NOT be longer than 75 octets, excluding the line Err bitreich.org 70 i- break. Long content lines SHOULD be split into a multiple line Err bitreich.org 70 i- representations using a line "folding" technique. That is, a long Err bitreich.org 70 i- line can be split between any two characters by inserting a CRLF Err bitreich.org 70 i- immediately followed by a single linear white-space character (i.e., Err bitreich.org 70 i- SPACE or HTAB). Any sequence of CRLF followed immediately by a Err bitreich.org 70 i- single linear white-space character is ignored (i.e., removed) when Err bitreich.org 70 i- processing the content type. Err bitreich.org 70 i- Err bitreich.org 70 i- For example, the line: Err bitreich.org 70 i- Err bitreich.org 70 i- DESCRIPTION:This is a long description that exists on a long line. Err bitreich.org 70 i- Err bitreich.org 70 i- Can be represented as: Err bitreich.org 70 i- Err bitreich.org 70 i- DESCRIPTION:This is a lo Err bitreich.org 70 i- ng description Err bitreich.org 70 i- that exists on a long line. Err bitreich.org 70 i- Err bitreich.org 70 i- The process of moving from this folded multiple-line representation Err bitreich.org 70 i- to its single-line representation is called "unfolding". Unfolding Err bitreich.org 70 i- is accomplished by removing the CRLF and the linear white-space Err bitreich.org 70 i- character that immediately follows. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 9] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- When parsing a content line, folded lines MUST first be unfolded Err bitreich.org 70 i- according to the unfolding procedure described above. Err bitreich.org 70 i- Err bitreich.org 70 i- Note: It is possible for very simple implementations to generate Err bitreich.org 70 i- improperly folded lines in the middle of a UTF-8 multi-octet Err bitreich.org 70 i- sequence. For this reason, implementations need to unfold lines Err bitreich.org 70 i- in such a way to properly restore the original sequence. Err bitreich.org 70 i- Err bitreich.org 70 i- The content information associated with an iCalendar object is Err bitreich.org 70 i- formatted using a syntax similar to that defined by [RFC2425]. That Err bitreich.org 70 i- is, the content information consists of CRLF-separated content lines. Err bitreich.org 70 i- Err bitreich.org 70 i- The following notation defines the lines of content in an iCalendar Err bitreich.org 70 i- object: Err bitreich.org 70 i- Err bitreich.org 70 i- contentline = name *(";" param ) ":" value CRLF Err bitreich.org 70 i- ; This ABNF is just a general definition for an initial parsing Err bitreich.org 70 i- ; of the content line into its property name, parameter list, Err bitreich.org 70 i- ; and value string Err bitreich.org 70 i- Err bitreich.org 70 i- ; When parsing a content line, folded lines MUST first Err bitreich.org 70 i- ; be unfolded according to the unfolding procedure Err bitreich.org 70 i- ; described above. When generating a content line, lines Err bitreich.org 70 i- ; longer than 75 octets SHOULD be folded according to Err bitreich.org 70 i- ; the folding procedure described above. Err bitreich.org 70 i- Err bitreich.org 70 i- name = iana-token / x-name Err bitreich.org 70 i- Err bitreich.org 70 i- iana-token = 1*(ALPHA / DIGIT / "-") Err bitreich.org 70 i- ; iCalendar identifier registered with IANA Err bitreich.org 70 i- Err bitreich.org 70 i- x-name = "X-" [vendorid "-"] 1*(ALPHA / DIGIT / "-") Err bitreich.org 70 i- ; Reserved for experimental use. Err bitreich.org 70 i- Err bitreich.org 70 i- vendorid = 3*(ALPHA / DIGIT) Err bitreich.org 70 i- ; Vendor identification Err bitreich.org 70 i- Err bitreich.org 70 i- param = param-name "=" param-value *("," param-value) Err bitreich.org 70 i- ; Each property defines the specific ABNF for the parameters Err bitreich.org 70 i- ; allowed on the property. Refer to specific properties for Err bitreich.org 70 i- ; precise parameter ABNF. Err bitreich.org 70 i- Err bitreich.org 70 i- param-name = iana-token / x-name Err bitreich.org 70 i- Err bitreich.org 70 i- param-value = paramtext / quoted-string Err bitreich.org 70 i- Err bitreich.org 70 i- paramtext = *SAFE-CHAR Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 10] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- value = *VALUE-CHAR Err bitreich.org 70 i- Err bitreich.org 70 i- quoted-string = DQUOTE *QSAFE-CHAR DQUOTE Err bitreich.org 70 i- Err bitreich.org 70 i- QSAFE-CHAR = WSP / %x21 / %x23-7E / NON-US-ASCII Err bitreich.org 70 i- ; Any character except CONTROL and DQUOTE Err bitreich.org 70 i- Err bitreich.org 70 i- SAFE-CHAR = WSP / %x21 / %x23-2B / %x2D-39 / %x3C-7E Err bitreich.org 70 i- / NON-US-ASCII Err bitreich.org 70 i- ; Any character except CONTROL, DQUOTE, ";", ":", "," Err bitreich.org 70 i- Err bitreich.org 70 i- VALUE-CHAR = WSP / %x21-7E / NON-US-ASCII Err bitreich.org 70 i- ; Any textual character Err bitreich.org 70 i- Err bitreich.org 70 i- NON-US-ASCII = UTF8-2 / UTF8-3 / UTF8-4 Err bitreich.org 70 i- ; UTF8-2, UTF8-3, and UTF8-4 are defined in [RFC3629] Err bitreich.org 70 i- Err bitreich.org 70 i- CONTROL = %x00-08 / %x0A-1F / %x7F Err bitreich.org 70 i- ; All the controls except HTAB Err bitreich.org 70 i- Err bitreich.org 70 i- The property value component of a content line has a format that is Err bitreich.org 70 i- property specific. Refer to the section describing each property for Err bitreich.org 70 i- a definition of this format. Err bitreich.org 70 i- Err bitreich.org 70 i- All names of properties, property parameters, enumerated property Err bitreich.org 70 i- values and property parameter values are case-insensitive. However, Err bitreich.org 70 i- all other property values are case-sensitive, unless otherwise Err bitreich.org 70 i- stated. Err bitreich.org 70 i- Err bitreich.org 70 i-3.1.1. List and Field Separators Err bitreich.org 70 i- Err bitreich.org 70 i- Some properties and parameters allow a list of values. Values in a Err bitreich.org 70 i- list of values MUST be separated by a COMMA character. There is no Err bitreich.org 70 i- significance to the order of values in a list. For those parameter Err bitreich.org 70 i- values (such as those that specify URI values) that are specified in Err bitreich.org 70 i- quoted-strings, the individual quoted-strings are separated by a Err bitreich.org 70 i- COMMA character. Err bitreich.org 70 i- Err bitreich.org 70 i- Some property values are defined in terms of multiple parts. These Err bitreich.org 70 i- structured property values MUST have their value parts separated by a Err bitreich.org 70 i- SEMICOLON character. Err bitreich.org 70 i- Err bitreich.org 70 i- Some properties allow a list of parameters. Each property parameter Err bitreich.org 70 i- in a list of property parameters MUST be separated by a SEMICOLON Err bitreich.org 70 i- character. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 11] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Property parameters with values containing a COLON character, a Err bitreich.org 70 i- SEMICOLON character or a COMMA character MUST be placed in quoted Err bitreich.org 70 i- text. Err bitreich.org 70 i- Err bitreich.org 70 i- For example, in the following properties, a SEMICOLON is used to Err bitreich.org 70 i- separate property parameters from each other and a COMMA character is Err bitreich.org 70 i- used to separate property values in a value list. Err bitreich.org 70 i- Err bitreich.org 70 i- ATTENDEE;RSVP=TRUE;ROLE=REQ-PARTICIPANT:mailto: Err bitreich.org 70 i- jsmith@example.com Err bitreich.org 70 i- Err bitreich.org 70 i- RDATE;VALUE=DATE:19970304,19970504,19970704,19970904 Err bitreich.org 70 i- Err bitreich.org 70 i-3.1.2. Multiple Values Err bitreich.org 70 i- Err bitreich.org 70 i- Some properties defined in the iCalendar object can have multiple Err bitreich.org 70 i- values. The general rule for encoding multi-valued items is to Err bitreich.org 70 i- simply create a new content line for each value, including the Err bitreich.org 70 i- property name. However, it should be noted that some properties Err bitreich.org 70 i- support encoding multiple values in a single property by separating Err bitreich.org 70 i- the values with a COMMA character. Individual property definitions Err bitreich.org 70 i- should be consulted for determining whether a specific property Err bitreich.org 70 i- allows multiple values and in which of these two forms. Multi-valued Err bitreich.org 70 i- properties MUST NOT be used to specify multiple language variants of Err bitreich.org 70 i- the same value. Calendar applications SHOULD display all values. Err bitreich.org 70 i- Err bitreich.org 70 i-3.1.3. Binary Content Err bitreich.org 70 i- Err bitreich.org 70 i- Binary content information in an iCalendar object SHOULD be Err bitreich.org 70 i- referenced using a URI within a property value. That is, the binary Err bitreich.org 70 i- content information SHOULD be placed in an external MIME entity that Err bitreich.org 70 i- can be referenced by a URI from within the iCalendar object. In Err bitreich.org 70 i- applications where this is not feasible, binary content information Err bitreich.org 70 i- can be included within an iCalendar object, but only after first Err bitreich.org 70 i- encoding it into text using the "BASE64" encoding method defined in Err bitreich.org 70 i- [RFC4648]. Inline binary content SHOULD only be used in applications Err bitreich.org 70 i- whose special circumstances demand that an iCalendar object be Err bitreich.org 70 i- expressed as a single entity. A property containing inline binary Err bitreich.org 70 i- content information MUST specify the "ENCODING" property parameter. Err bitreich.org 70 i- Binary content information placed external to the iCalendar object Err bitreich.org 70 i- MUST be referenced by a uniform resource identifier (URI). Err bitreich.org 70 i- Err bitreich.org 70 i- The following example specifies an "ATTACH" property that references Err bitreich.org 70 i- an attachment external to the iCalendar object with a URI reference: Err bitreich.org 70 i- Err bitreich.org 70 i- ATTACH:http://example.com/public/quarterly-report.doc Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 12] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- The following example specifies an "ATTACH" property with inline Err bitreich.org 70 i- binary encoded content information: Err bitreich.org 70 i- Err bitreich.org 70 i- ATTACH;FMTTYPE=text/plain;ENCODING=BASE64;VALUE=BINARY:VGhlIH Err bitreich.org 70 i- F1aWNrIGJyb3duIGZveCBqdW1wcyBvdmVyIHRoZSBsYXp5IGRvZy4 Err bitreich.org 70 i- Err bitreich.org 70 i-3.1.4. Character Set Err bitreich.org 70 i- Err bitreich.org 70 i- There is not a property parameter to declare the charset used in a Err bitreich.org 70 i- property value. The default charset for an iCalendar stream is UTF-8 Err bitreich.org 70 i- as defined in [RFC3629]. Err bitreich.org 70 i- Err bitreich.org 70 i- The "charset" Content-Type parameter MUST be used in MIME transports Err bitreich.org 70 i- to specify the charset being used. Err bitreich.org 70 i- Err bitreich.org 70 i-3.2. Property Parameters Err bitreich.org 70 i- Err bitreich.org 70 i- A property can have attributes with which it is associated. These Err bitreich.org 70 i- "property parameters" contain meta-information about the property or Err bitreich.org 70 i- the property value. Property parameters are provided to specify such Err bitreich.org 70 i- information as the location of an alternate text representation for a Err bitreich.org 70 i- property value, the language of a text property value, the value type Err bitreich.org 70 i- of the property value, and other attributes. Err bitreich.org 70 i- Err bitreich.org 70 i- Property parameter values that contain the COLON, SEMICOLON, or COMMA Err bitreich.org 70 i- character separators MUST be specified as quoted-string text values. Err bitreich.org 70 i- Property parameter values MUST NOT contain the DQUOTE character. The Err bitreich.org 70 i- DQUOTE character is used as a delimiter for parameter values that Err bitreich.org 70 i- contain restricted characters or URI text. For example: Err bitreich.org 70 i- Err bitreich.org 70 i- DESCRIPTION;ALTREP="cid:part1.0001@example.org":The Fall'98 Wild Err bitreich.org 70 i- Wizards Conference - - Las Vegas\, NV\, USA Err bitreich.org 70 i- Err bitreich.org 70 i- Property parameter values that are not in quoted-strings are case- Err bitreich.org 70 i- insensitive. Err bitreich.org 70 i- Err bitreich.org 70 i- The general property parameters defined by this memo are defined by Err bitreich.org 70 i- the following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 13] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- icalparameter = altrepparam ; Alternate text representation Err bitreich.org 70 i- / cnparam ; Common name Err bitreich.org 70 i- / cutypeparam ; Calendar user type Err bitreich.org 70 i- / delfromparam ; Delegator Err bitreich.org 70 i- / deltoparam ; Delegatee Err bitreich.org 70 i- / dirparam ; Directory entry Err bitreich.org 70 i- / encodingparam ; Inline encoding Err bitreich.org 70 i- / fmttypeparam ; Format type Err bitreich.org 70 i- / fbtypeparam ; Free/busy time type Err bitreich.org 70 i- / languageparam ; Language for text Err bitreich.org 70 i- / memberparam ; Group or list membership Err bitreich.org 70 i- / partstatparam ; Participation status Err bitreich.org 70 i- / rangeparam ; Recurrence identifier range Err bitreich.org 70 i- / trigrelparam ; Alarm trigger relationship Err bitreich.org 70 i- / reltypeparam ; Relationship type Err bitreich.org 70 i- / roleparam ; Participation role Err bitreich.org 70 i- / rsvpparam ; RSVP expectation Err bitreich.org 70 i- / sentbyparam ; Sent by Err bitreich.org 70 i- / tzidparam ; Reference to time zone object Err bitreich.org 70 i- / valuetypeparam ; Property value data type Err bitreich.org 70 i- / other-param Err bitreich.org 70 i- Err bitreich.org 70 i- other-param = (iana-param / x-param) Err bitreich.org 70 i- Err bitreich.org 70 i- iana-param = iana-token "=" param-value *("," param-value) Err bitreich.org 70 i- ; Some other IANA-registered iCalendar parameter. Err bitreich.org 70 i- Err bitreich.org 70 i- x-param = x-name "=" param-value *("," param-value) Err bitreich.org 70 i- ; A non-standard, experimental parameter. Err bitreich.org 70 i- Err bitreich.org 70 i- Applications MUST ignore x-param and iana-param values they don't Err bitreich.org 70 i- recognize. Err bitreich.org 70 i- Err bitreich.org 70 i-3.2.1. Alternate Text Representation Err bitreich.org 70 i- Err bitreich.org 70 i- Parameter Name: ALTREP Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: To specify an alternate text representation for the Err bitreich.org 70 i- property value. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property parameter is defined by the Err bitreich.org 70 i- following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- altrepparam = "ALTREP" "=" DQUOTE uri DQUOTE Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This parameter specifies a URI that points to an Err bitreich.org 70 i- alternate representation for a textual property value. A property Err bitreich.org 70 i- specifying this parameter MUST also include a value that reflects Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 14] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- the default representation of the text value. The URI parameter Err bitreich.org 70 i- value MUST be specified in a quoted-string. Err bitreich.org 70 i- Err bitreich.org 70 i- Note: While there is no restriction imposed on the URI schemes Err bitreich.org 70 i- allowed for this parameter, Content Identifier (CID) [RFC2392], Err bitreich.org 70 i- HTTP [RFC2616], and HTTPS [RFC2818] are the URI schemes most Err bitreich.org 70 i- commonly used by current implementations. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: Err bitreich.org 70 i- Err bitreich.org 70 i- DESCRIPTION;ALTREP="CID:part3.msg.970415T083000@example.com": Err bitreich.org 70 i- Project XYZ Review Meeting will include the following agenda Err bitreich.org 70 i- items: (a) Market Overview\, (b) Finances\, (c) Project Man Err bitreich.org 70 i- agement Err bitreich.org 70 i- Err bitreich.org 70 i- The "ALTREP" property parameter value might point to a "text/html" Err bitreich.org 70 i- content portion. Err bitreich.org 70 i- Err bitreich.org 70 i- Content-Type:text/html Err bitreich.org 70 i- Content-Id: Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-

Err bitreich.org 70 i- Project XYZ Review Meeting will include Err bitreich.org 70 i- the following agenda items: Err bitreich.org 70 i-

    Err bitreich.org 70 i-
  1. Market Overview
    2. Err bitreich.org 70 i-
  2. Finances
    3. Err bitreich.org 70 i-
  3. Project Management
    4. Err bitreich.org 70 i-
Err bitreich.org 70 i-

Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-3.2.2. Common Name Err bitreich.org 70 i- Err bitreich.org 70 i- Parameter Name: CN Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: To specify the common name to be associated with the Err bitreich.org 70 i- calendar user specified by the property. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property parameter is defined by the Err bitreich.org 70 i- following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 15] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- cnparam = "CN" "=" param-value Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This parameter can be specified on properties with a Err bitreich.org 70 i- CAL-ADDRESS value type. The parameter specifies the common name Err bitreich.org 70 i- to be associated with the calendar user specified by the property. Err bitreich.org 70 i- The parameter value is text. The parameter value can be used for Err bitreich.org 70 i- display text to be associated with the calendar address specified Err bitreich.org 70 i- by the property. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: Err bitreich.org 70 i- Err bitreich.org 70 i- ORGANIZER;CN="John Smith":mailto:jsmith@example.com Err bitreich.org 70 i- Err bitreich.org 70 i-3.2.3. Calendar User Type Err bitreich.org 70 i- Err bitreich.org 70 i- Parameter Name: CUTYPE Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: To identify the type of calendar user specified by the Err bitreich.org 70 i- property. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property parameter is defined by the Err bitreich.org 70 i- following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- cutypeparam = "CUTYPE" "=" Err bitreich.org 70 i- ("INDIVIDUAL" ; An individual Err bitreich.org 70 i- / "GROUP" ; A group of individuals Err bitreich.org 70 i- / "RESOURCE" ; A physical resource Err bitreich.org 70 i- / "ROOM" ; A room resource Err bitreich.org 70 i- / "UNKNOWN" ; Otherwise not known Err bitreich.org 70 i- / x-name ; Experimental type Err bitreich.org 70 i- / iana-token) ; Other IANA-registered Err bitreich.org 70 i- ; type Err bitreich.org 70 i- ; Default is INDIVIDUAL Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This parameter can be specified on properties with a Err bitreich.org 70 i- CAL-ADDRESS value type. The parameter identifies the type of Err bitreich.org 70 i- calendar user specified by the property. If not specified on a Err bitreich.org 70 i- property that allows this parameter, the default is INDIVIDUAL. Err bitreich.org 70 i- Applications MUST treat x-name and iana-token values they don't Err bitreich.org 70 i- recognize the same way as they would the UNKNOWN value. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: Err bitreich.org 70 i- Err bitreich.org 70 i- ATTENDEE;CUTYPE=GROUP:mailto:ietf-calsch@example.org Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 16] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-3.2.4. Delegators Err bitreich.org 70 i- Err bitreich.org 70 i- Parameter Name: DELEGATED-FROM Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: To specify the calendar users that have delegated their Err bitreich.org 70 i- participation to the calendar user specified by the property. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property parameter is defined by the Err bitreich.org 70 i- following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- delfromparam = "DELEGATED-FROM" "=" DQUOTE cal-address Err bitreich.org 70 i- DQUOTE *("," DQUOTE cal-address DQUOTE) Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This parameter can be specified on properties with a Err bitreich.org 70 i- CAL-ADDRESS value type. This parameter specifies those calendar Err bitreich.org 70 i- users that have delegated their participation in a group-scheduled Err bitreich.org 70 i- event or to-do to the calendar user specified by the property. Err bitreich.org 70 i- The individual calendar address parameter values MUST each be Err bitreich.org 70 i- specified in a quoted-string. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: Err bitreich.org 70 i- Err bitreich.org 70 i- ATTENDEE;DELEGATED-FROM="mailto:jsmith@example.com":mailto: Err bitreich.org 70 i- jdoe@example.com Err bitreich.org 70 i- Err bitreich.org 70 i-3.2.5. Delegatees Err bitreich.org 70 i- Err bitreich.org 70 i- Parameter Name: DELEGATED-TO Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: To specify the calendar users to whom the calendar user Err bitreich.org 70 i- specified by the property has delegated participation. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property parameter is defined by the Err bitreich.org 70 i- following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- deltoparam = "DELEGATED-TO" "=" DQUOTE cal-address DQUOTE Err bitreich.org 70 i- *("," DQUOTE cal-address DQUOTE) Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This parameter can be specified on properties with a Err bitreich.org 70 i- CAL-ADDRESS value type. This parameter specifies those calendar Err bitreich.org 70 i- users whom have been delegated participation in a group-scheduled Err bitreich.org 70 i- event or to-do by the calendar user specified by the property. Err bitreich.org 70 i- The individual calendar address parameter values MUST each be Err bitreich.org 70 i- specified in a quoted-string. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 17] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Example: Err bitreich.org 70 i- Err bitreich.org 70 i- ATTENDEE;DELEGATED-TO="mailto:jdoe@example.com","mailto:jqpublic Err bitreich.org 70 i- @example.com":mailto:jsmith@example.com Err bitreich.org 70 i- Err bitreich.org 70 i-3.2.6. Directory Entry Reference Err bitreich.org 70 i- Err bitreich.org 70 i- Parameter Name: DIR Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: To specify reference to a directory entry associated with Err bitreich.org 70 i- the calendar user specified by the property. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property parameter is defined by the Err bitreich.org 70 i- following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- dirparam = "DIR" "=" DQUOTE uri DQUOTE Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This parameter can be specified on properties with a Err bitreich.org 70 i- CAL-ADDRESS value type. The parameter specifies a reference to Err bitreich.org 70 i- the directory entry associated with the calendar user specified by Err bitreich.org 70 i- the property. The parameter value is a URI. The URI parameter Err bitreich.org 70 i- value MUST be specified in a quoted-string. Err bitreich.org 70 i- Err bitreich.org 70 i- Note: While there is no restriction imposed on the URI schemes Err bitreich.org 70 i- allowed for this parameter, CID [RFC2392], DATA [RFC2397], FILE Err bitreich.org 70 i- [RFC1738], FTP [RFC1738], HTTP [RFC2616], HTTPS [RFC2818], LDAP Err bitreich.org 70 i- [RFC4516], and MID [RFC2392] are the URI schemes most commonly Err bitreich.org 70 i- used by current implementations. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: Err bitreich.org 70 i- Err bitreich.org 70 i- ORGANIZER;DIR="ldap://example.com:6666/o=ABC%20Industries, Err bitreich.org 70 i- c=US???(cn=Jim%20Dolittle)":mailto:jimdo@example.com Err bitreich.org 70 i- Err bitreich.org 70 i-3.2.7. Inline Encoding Err bitreich.org 70 i- Err bitreich.org 70 i- Parameter Name: ENCODING Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: To specify an alternate inline encoding for the property Err bitreich.org 70 i- value. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property parameter is defined by the Err bitreich.org 70 i- following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 18] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- encodingparam = "ENCODING" "=" Err bitreich.org 70 i- ( "8BIT" Err bitreich.org 70 i- ; "8bit" text encoding is defined in [RFC2045] Err bitreich.org 70 i- / "BASE64" Err bitreich.org 70 i- ; "BASE64" binary encoding format is defined in [RFC4648] Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This property parameter identifies the inline encoding Err bitreich.org 70 i- used in a property value. The default encoding is "8BIT", Err bitreich.org 70 i- corresponding to a property value consisting of text. The Err bitreich.org 70 i- "BASE64" encoding type corresponds to a property value encoded Err bitreich.org 70 i- using the "BASE64" encoding defined in [RFC2045]. Err bitreich.org 70 i- Err bitreich.org 70 i- If the value type parameter is ";VALUE=BINARY", then the inline Err bitreich.org 70 i- encoding parameter MUST be specified with the value Err bitreich.org 70 i- ";ENCODING=BASE64". Err bitreich.org 70 i- Err bitreich.org 70 i- Example: Err bitreich.org 70 i- Err bitreich.org 70 i- ATTACH;FMTTYPE=text/plain;ENCODING=BASE64;VALUE=BINARY:TG9yZW Err bitreich.org 70 i- 0gaXBzdW0gZG9sb3Igc2l0IGFtZXQsIGNvbnNlY3RldHVyIGFkaXBpc2ljaW Err bitreich.org 70 i- 5nIGVsaXQsIHNlZCBkbyBlaXVzbW9kIHRlbXBvciBpbmNpZGlkdW50IHV0IG Err bitreich.org 70 i- xhYm9yZSBldCBkb2xvcmUgbWFnbmEgYWxpcXVhLiBVdCBlbmltIGFkIG1pbm Err bitreich.org 70 i- ltIHZlbmlhbSwgcXVpcyBub3N0cnVkIGV4ZXJjaXRhdGlvbiB1bGxhbWNvIG Err bitreich.org 70 i- xhYm9yaXMgbmlzaSB1dCBhbGlxdWlwIGV4IGVhIGNvbW1vZG8gY29uc2VxdW Err bitreich.org 70 i- F0LiBEdWlzIGF1dGUgaXJ1cmUgZG9sb3IgaW4gcmVwcmVoZW5kZXJpdCBpbi Err bitreich.org 70 i- B2b2x1cHRhdGUgdmVsaXQgZXNzZSBjaWxsdW0gZG9sb3JlIGV1IGZ1Z2lhdC Err bitreich.org 70 i- BudWxsYSBwYXJpYXR1ci4gRXhjZXB0ZXVyIHNpbnQgb2NjYWVjYXQgY3VwaW Err bitreich.org 70 i- RhdGF0IG5vbiBwcm9pZGVudCwgc3VudCBpbiBjdWxwYSBxdWkgb2ZmaWNpYS Err bitreich.org 70 i- BkZXNlcnVudCBtb2xsaXQgYW5pbSBpZCBlc3QgbGFib3J1bS4= Err bitreich.org 70 i- Err bitreich.org 70 i-3.2.8. Format Type Err bitreich.org 70 i- Err bitreich.org 70 i- Parameter Name: FMTTYPE Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: To specify the content type of a referenced object. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property parameter is defined by the Err bitreich.org 70 i- following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- fmttypeparam = "FMTTYPE" "=" type-name "/" subtype-name Err bitreich.org 70 i- ; Where "type-name" and "subtype-name" are Err bitreich.org 70 i- ; defined in Section 4.2 of [RFC4288]. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This parameter can be specified on properties that are Err bitreich.org 70 i- used to reference an object. The parameter specifies the media Err bitreich.org 70 i- type [RFC4288] of the referenced object. For example, on the Err bitreich.org 70 i- "ATTACH" property, an FTP type URI value does not, by itself, Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 19] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- necessarily convey the type of content associated with the Err bitreich.org 70 i- resource. The parameter value MUST be the text for either an Err bitreich.org 70 i- IANA-registered media type or a non-standard media type. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: Err bitreich.org 70 i- Err bitreich.org 70 i- ATTACH;FMTTYPE=application/msword:ftp://example.com/pub/docs/ Err bitreich.org 70 i- agenda.doc Err bitreich.org 70 i- Err bitreich.org 70 i-3.2.9. Free/Busy Time Type Err bitreich.org 70 i- Err bitreich.org 70 i- Parameter Name: FBTYPE Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: To specify the free or busy time type. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property parameter is defined by the Err bitreich.org 70 i- following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- fbtypeparam = "FBTYPE" "=" ("FREE" / "BUSY" Err bitreich.org 70 i- / "BUSY-UNAVAILABLE" / "BUSY-TENTATIVE" Err bitreich.org 70 i- / x-name Err bitreich.org 70 i- ; Some experimental iCalendar free/busy type. Err bitreich.org 70 i- / iana-token) Err bitreich.org 70 i- ; Some other IANA-registered iCalendar free/busy type. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This parameter specifies the free or busy time type. Err bitreich.org 70 i- The value FREE indicates that the time interval is free for Err bitreich.org 70 i- scheduling. The value BUSY indicates that the time interval is Err bitreich.org 70 i- busy because one or more events have been scheduled for that Err bitreich.org 70 i- interval. The value BUSY-UNAVAILABLE indicates that the time Err bitreich.org 70 i- interval is busy and that the interval can not be scheduled. The Err bitreich.org 70 i- value BUSY-TENTATIVE indicates that the time interval is busy Err bitreich.org 70 i- because one or more events have been tentatively scheduled for Err bitreich.org 70 i- that interval. If not specified on a property that allows this Err bitreich.org 70 i- parameter, the default is BUSY. Applications MUST treat x-name Err bitreich.org 70 i- and iana-token values they don't recognize the same way as they Err bitreich.org 70 i- would the BUSY value. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this parameter on a Err bitreich.org 70 i- "FREEBUSY" property. Err bitreich.org 70 i- Err bitreich.org 70 i- FREEBUSY;FBTYPE=BUSY:19980415T133000Z/19980415T170000Z Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 20] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-3.2.10. Language Err bitreich.org 70 i- Err bitreich.org 70 i- Parameter Name: LANGUAGE Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: To specify the language for text values in a property or Err bitreich.org 70 i- property parameter. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property parameter is defined by the Err bitreich.org 70 i- following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- languageparam = "LANGUAGE" "=" language Err bitreich.org 70 i- Err bitreich.org 70 i- language = Language-Tag Err bitreich.org 70 i- ; As defined in [RFC5646]. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This parameter identifies the language of the text in Err bitreich.org 70 i- the property value and of all property parameter values of the Err bitreich.org 70 i- property. The value of the "LANGUAGE" property parameter is that Err bitreich.org 70 i- defined in [RFC5646]. Err bitreich.org 70 i- Err bitreich.org 70 i- For transport in a MIME entity, the Content-Language header field Err bitreich.org 70 i- can be used to set the default language for the entire body part. Err bitreich.org 70 i- Otherwise, no default language is assumed. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following are examples of this parameter on the Err bitreich.org 70 i- "SUMMARY" and "LOCATION" properties: Err bitreich.org 70 i- Err bitreich.org 70 i- SUMMARY;LANGUAGE=en-US:Company Holiday Party Err bitreich.org 70 i- Err bitreich.org 70 i- LOCATION;LANGUAGE=en:Germany Err bitreich.org 70 i- Err bitreich.org 70 i- LOCATION;LANGUAGE=no:Tyskland Err bitreich.org 70 i- Err bitreich.org 70 i-3.2.11. Group or List Membership Err bitreich.org 70 i- Err bitreich.org 70 i- Parameter Name: MEMBER Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: To specify the group or list membership of the calendar Err bitreich.org 70 i- user specified by the property. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property parameter is defined by the Err bitreich.org 70 i- following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- memberparam = "MEMBER" "=" DQUOTE cal-address DQUOTE Err bitreich.org 70 i- *("," DQUOTE cal-address DQUOTE) Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 21] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This parameter can be specified on properties with a Err bitreich.org 70 i- CAL-ADDRESS value type. The parameter identifies the groups or Err bitreich.org 70 i- list membership for the calendar user specified by the property. Err bitreich.org 70 i- The parameter value is either a single calendar address in a Err bitreich.org 70 i- quoted-string or a COMMA-separated list of calendar addresses, Err bitreich.org 70 i- each in a quoted-string. The individual calendar address Err bitreich.org 70 i- parameter values MUST each be specified in a quoted-string. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: Err bitreich.org 70 i- Err bitreich.org 70 i- ATTENDEE;MEMBER="mailto:ietf-calsch@example.org":mailto: Err bitreich.org 70 i- jsmith@example.com Err bitreich.org 70 i- Err bitreich.org 70 i- ATTENDEE;MEMBER="mailto:projectA@example.com","mailto:pr Err bitreich.org 70 i- ojectB@example.com":mailto:janedoe@example.com Err bitreich.org 70 i- Err bitreich.org 70 i-3.2.12. Participation Status Err bitreich.org 70 i- Err bitreich.org 70 i- Parameter Name: PARTSTAT Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: To specify the participation status for the calendar user Err bitreich.org 70 i- specified by the property. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property parameter is defined by the Err bitreich.org 70 i- following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- partstatparam = "PARTSTAT" "=" Err bitreich.org 70 i- (partstat-event Err bitreich.org 70 i- / partstat-todo Err bitreich.org 70 i- / partstat-jour) Err bitreich.org 70 i- Err bitreich.org 70 i- partstat-event = ("NEEDS-ACTION" ; Event needs action Err bitreich.org 70 i- / "ACCEPTED" ; Event accepted Err bitreich.org 70 i- / "DECLINED" ; Event declined Err bitreich.org 70 i- / "TENTATIVE" ; Event tentatively Err bitreich.org 70 i- ; accepted Err bitreich.org 70 i- / "DELEGATED" ; Event delegated Err bitreich.org 70 i- / x-name ; Experimental status Err bitreich.org 70 i- / iana-token) ; Other IANA-registered Err bitreich.org 70 i- ; status Err bitreich.org 70 i- ; These are the participation statuses for a "VEVENT". Err bitreich.org 70 i- ; Default is NEEDS-ACTION. Err bitreich.org 70 i- Err bitreich.org 70 i- partstat-todo = ("NEEDS-ACTION" ; To-do needs action Err bitreich.org 70 i- / "ACCEPTED" ; To-do accepted Err bitreich.org 70 i- / "DECLINED" ; To-do declined Err bitreich.org 70 i- / "TENTATIVE" ; To-do tentatively Err bitreich.org 70 i- ; accepted Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 22] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- / "DELEGATED" ; To-do delegated Err bitreich.org 70 i- / "COMPLETED" ; To-do completed Err bitreich.org 70 i- ; COMPLETED property has Err bitreich.org 70 i- ; DATE-TIME completed Err bitreich.org 70 i- / "IN-PROCESS" ; To-do in process of Err bitreich.org 70 i- ; being completed Err bitreich.org 70 i- / x-name ; Experimental status Err bitreich.org 70 i- / iana-token) ; Other IANA-registered Err bitreich.org 70 i- ; status Err bitreich.org 70 i- ; These are the participation statuses for a "VTODO". Err bitreich.org 70 i- ; Default is NEEDS-ACTION. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- partstat-jour = ("NEEDS-ACTION" ; Journal needs action Err bitreich.org 70 i- / "ACCEPTED" ; Journal accepted Err bitreich.org 70 i- / "DECLINED" ; Journal declined Err bitreich.org 70 i- / x-name ; Experimental status Err bitreich.org 70 i- / iana-token) ; Other IANA-registered Err bitreich.org 70 i- ; status Err bitreich.org 70 i- ; These are the participation statuses for a "VJOURNAL". Err bitreich.org 70 i- ; Default is NEEDS-ACTION. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This parameter can be specified on properties with a Err bitreich.org 70 i- CAL-ADDRESS value type. The parameter identifies the Err bitreich.org 70 i- participation status for the calendar user specified by the Err bitreich.org 70 i- property value. The parameter values differ depending on whether Err bitreich.org 70 i- they are associated with a group-scheduled "VEVENT", "VTODO", or Err bitreich.org 70 i- "VJOURNAL". The values MUST match one of the values allowed for Err bitreich.org 70 i- the given calendar component. If not specified on a property that Err bitreich.org 70 i- allows this parameter, the default value is NEEDS-ACTION. Err bitreich.org 70 i- Applications MUST treat x-name and iana-token values they don't Err bitreich.org 70 i- recognize the same way as they would the NEEDS-ACTION value. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: Err bitreich.org 70 i- Err bitreich.org 70 i- ATTENDEE;PARTSTAT=DECLINED:mailto:jsmith@example.com Err bitreich.org 70 i- Err bitreich.org 70 i-3.2.13. Recurrence Identifier Range Err bitreich.org 70 i- Err bitreich.org 70 i- Parameter Name: RANGE Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: To specify the effective range of recurrence instances from Err bitreich.org 70 i- the instance specified by the recurrence identifier specified by Err bitreich.org 70 i- the property. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property parameter is defined by the Err bitreich.org 70 i- following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 23] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- rangeparam = "RANGE" "=" "THISANDFUTURE" Err bitreich.org 70 i- ; To specify the instance specified by the recurrence identifier Err bitreich.org 70 i- ; and all subsequent recurrence instances. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This parameter can be specified on a property that Err bitreich.org 70 i- specifies a recurrence identifier. The parameter specifies the Err bitreich.org 70 i- effective range of recurrence instances that is specified by the Err bitreich.org 70 i- property. The effective range is from the recurrence identifier Err bitreich.org 70 i- specified by the property. If this parameter is not specified on Err bitreich.org 70 i- an allowed property, then the default range is the single instance Err bitreich.org 70 i- specified by the recurrence identifier value of the property. The Err bitreich.org 70 i- parameter value can only be "THISANDFUTURE" to indicate a range Err bitreich.org 70 i- defined by the recurrence identifier and all subsequent instances. Err bitreich.org 70 i- The value "THISANDPRIOR" is deprecated by this revision of Err bitreich.org 70 i- iCalendar and MUST NOT be generated by applications. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: Err bitreich.org 70 i- Err bitreich.org 70 i- RECURRENCE-ID;RANGE=THISANDFUTURE:19980401T133000Z Err bitreich.org 70 i- Err bitreich.org 70 i-3.2.14. Alarm Trigger Relationship Err bitreich.org 70 i- Err bitreich.org 70 i- Parameter Name: RELATED Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: To specify the relationship of the alarm trigger with Err bitreich.org 70 i- respect to the start or end of the calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property parameter is defined by the Err bitreich.org 70 i- following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- trigrelparam = "RELATED" "=" Err bitreich.org 70 i- ("START" ; Trigger off of start Err bitreich.org 70 i- / "END") ; Trigger off of end Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This parameter can be specified on properties that Err bitreich.org 70 i- specify an alarm trigger with a "DURATION" value type. The Err bitreich.org 70 i- parameter specifies whether the alarm will trigger relative to the Err bitreich.org 70 i- start or end of the calendar component. The parameter value START Err bitreich.org 70 i- will set the alarm to trigger off the start of the calendar Err bitreich.org 70 i- component; the parameter value END will set the alarm to trigger Err bitreich.org 70 i- off the end of the calendar component. If the parameter is not Err bitreich.org 70 i- specified on an allowable property, then the default is START. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: Err bitreich.org 70 i- Err bitreich.org 70 i- TRIGGER;RELATED=END:PT5M Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 24] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-3.2.15. Relationship Type Err bitreich.org 70 i- Err bitreich.org 70 i- Parameter Name: RELTYPE Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: To specify the type of hierarchical relationship associated Err bitreich.org 70 i- with the calendar component specified by the property. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property parameter is defined by the Err bitreich.org 70 i- following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- reltypeparam = "RELTYPE" "=" Err bitreich.org 70 i- ("PARENT" ; Parent relationship - Default Err bitreich.org 70 i- / "CHILD" ; Child relationship Err bitreich.org 70 i- / "SIBLING" ; Sibling relationship Err bitreich.org 70 i- / iana-token ; Some other IANA-registered Err bitreich.org 70 i- ; iCalendar relationship type Err bitreich.org 70 i- / x-name) ; A non-standard, experimental Err bitreich.org 70 i- ; relationship type Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This parameter can be specified on a property that Err bitreich.org 70 i- references another related calendar. The parameter specifies the Err bitreich.org 70 i- hierarchical relationship type of the calendar component Err bitreich.org 70 i- referenced by the property. The parameter value can be PARENT, to Err bitreich.org 70 i- indicate that the referenced calendar component is a superior of Err bitreich.org 70 i- calendar component; CHILD to indicate that the referenced calendar Err bitreich.org 70 i- component is a subordinate of the calendar component; or SIBLING Err bitreich.org 70 i- to indicate that the referenced calendar component is a peer of Err bitreich.org 70 i- the calendar component. If this parameter is not specified on an Err bitreich.org 70 i- allowable property, the default relationship type is PARENT. Err bitreich.org 70 i- Applications MUST treat x-name and iana-token values they don't Err bitreich.org 70 i- recognize the same way as they would the PARENT value. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: Err bitreich.org 70 i- Err bitreich.org 70 i- RELATED-TO;RELTYPE=SIBLING:19960401-080045-4000F192713@ Err bitreich.org 70 i- example.com Err bitreich.org 70 i- Err bitreich.org 70 i-3.2.16. Participation Role Err bitreich.org 70 i- Err bitreich.org 70 i- Parameter Name: ROLE Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: To specify the participation role for the calendar user Err bitreich.org 70 i- specified by the property. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property parameter is defined by the Err bitreich.org 70 i- following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 25] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- roleparam = "ROLE" "=" Err bitreich.org 70 i- ("CHAIR" ; Indicates chair of the Err bitreich.org 70 i- ; calendar entity Err bitreich.org 70 i- / "REQ-PARTICIPANT" ; Indicates a participant whose Err bitreich.org 70 i- ; participation is required Err bitreich.org 70 i- / "OPT-PARTICIPANT" ; Indicates a participant whose Err bitreich.org 70 i- ; participation is optional Err bitreich.org 70 i- / "NON-PARTICIPANT" ; Indicates a participant who Err bitreich.org 70 i- ; is copied for information Err bitreich.org 70 i- ; purposes only Err bitreich.org 70 i- / x-name ; Experimental role Err bitreich.org 70 i- / iana-token) ; Other IANA role Err bitreich.org 70 i- ; Default is REQ-PARTICIPANT Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This parameter can be specified on properties with a Err bitreich.org 70 i- CAL-ADDRESS value type. The parameter specifies the participation Err bitreich.org 70 i- role for the calendar user specified by the property in the group Err bitreich.org 70 i- schedule calendar component. If not specified on a property that Err bitreich.org 70 i- allows this parameter, the default value is REQ-PARTICIPANT. Err bitreich.org 70 i- Applications MUST treat x-name and iana-token values they don't Err bitreich.org 70 i- recognize the same way as they would the REQ-PARTICIPANT value. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: Err bitreich.org 70 i- Err bitreich.org 70 i- ATTENDEE;ROLE=CHAIR:mailto:mrbig@example.com Err bitreich.org 70 i- Err bitreich.org 70 i-3.2.17. RSVP Expectation Err bitreich.org 70 i- Err bitreich.org 70 i- Parameter Name: RSVP Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: To specify whether there is an expectation of a favor of a Err bitreich.org 70 i- reply from the calendar user specified by the property value. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property parameter is defined by the Err bitreich.org 70 i- following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- rsvpparam = "RSVP" "=" ("TRUE" / "FALSE") Err bitreich.org 70 i- ; Default is FALSE Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This parameter can be specified on properties with a Err bitreich.org 70 i- CAL-ADDRESS value type. The parameter identifies the expectation Err bitreich.org 70 i- of a reply from the calendar user specified by the property value. Err bitreich.org 70 i- This parameter is used by the "Organizer" to request a Err bitreich.org 70 i- participation status reply from an "Attendee" of a group-scheduled Err bitreich.org 70 i- event or to-do. If not specified on a property that allows this Err bitreich.org 70 i- parameter, the default value is FALSE. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 26] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Example: Err bitreich.org 70 i- Err bitreich.org 70 i- ATTENDEE;RSVP=TRUE:mailto:jsmith@example.com Err bitreich.org 70 i- Err bitreich.org 70 i-3.2.18. Sent By Err bitreich.org 70 i- Err bitreich.org 70 i- Parameter Name: SENT-BY Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: To specify the calendar user that is acting on behalf of Err bitreich.org 70 i- the calendar user specified by the property. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property parameter is defined by the Err bitreich.org 70 i- following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- sentbyparam = "SENT-BY" "=" DQUOTE cal-address DQUOTE Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This parameter can be specified on properties with a Err bitreich.org 70 i- CAL-ADDRESS value type. The parameter specifies the calendar user Err bitreich.org 70 i- that is acting on behalf of the calendar user specified by the Err bitreich.org 70 i- property. The parameter value MUST be a mailto URI as defined in Err bitreich.org 70 i- [RFC2368]. The individual calendar address parameter values MUST Err bitreich.org 70 i- each be specified in a quoted-string. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: Err bitreich.org 70 i- Err bitreich.org 70 i- ORGANIZER;SENT-BY="mailto:sray@example.com":mailto: Err bitreich.org 70 i- jsmith@example.com Err bitreich.org 70 i- Err bitreich.org 70 i-3.2.19. Time Zone Identifier Err bitreich.org 70 i- Err bitreich.org 70 i- Parameter Name: TZID Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: To specify the identifier for the time zone definition for Err bitreich.org 70 i- a time component in the property value. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property parameter is defined by the Err bitreich.org 70 i- following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- tzidparam = "TZID" "=" [tzidprefix] paramtext Err bitreich.org 70 i- Err bitreich.org 70 i- tzidprefix = "/" Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This parameter MUST be specified on the "DTSTART", Err bitreich.org 70 i- "DTEND", "DUE", "EXDATE", and "RDATE" properties when either a Err bitreich.org 70 i- DATE-TIME or TIME value type is specified and when the value is Err bitreich.org 70 i- neither a UTC or a "floating" time. Refer to the DATE-TIME or Err bitreich.org 70 i- TIME value type definition for a description of UTC and "floating Err bitreich.org 70 i- time" formats. This property parameter specifies a text value Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 27] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- that uniquely identifies the "VTIMEZONE" calendar component to be Err bitreich.org 70 i- used when evaluating the time portion of the property. The value Err bitreich.org 70 i- of the "TZID" property parameter will be equal to the value of the Err bitreich.org 70 i- "TZID" property for the matching time zone definition. An Err bitreich.org 70 i- individual "VTIMEZONE" calendar component MUST be specified for Err bitreich.org 70 i- each unique "TZID" parameter value specified in the iCalendar Err bitreich.org 70 i- object. Err bitreich.org 70 i- Err bitreich.org 70 i- The parameter MUST be specified on properties with a DATE-TIME Err bitreich.org 70 i- value if the DATE-TIME is not either a UTC or a "floating" time. Err bitreich.org 70 i- Failure to include and follow VTIMEZONE definitions in iCalendar Err bitreich.org 70 i- objects may lead to inconsistent understanding of the local time Err bitreich.org 70 i- at any given location. Err bitreich.org 70 i- Err bitreich.org 70 i- The presence of the SOLIDUS character as a prefix, indicates that Err bitreich.org 70 i- this "TZID" represents a unique ID in a globally defined time zone Err bitreich.org 70 i- registry (when such registry is defined). Err bitreich.org 70 i- Err bitreich.org 70 i- Note: This document does not define a naming convention for Err bitreich.org 70 i- time zone identifiers. Implementers may want to use the naming Err bitreich.org 70 i- conventions defined in existing time zone specifications such Err bitreich.org 70 i- as the public-domain TZ database [TZDB]. The specification of Err bitreich.org 70 i- globally unique time zone identifiers is not addressed by this Err bitreich.org 70 i- document and is left for future study. Err bitreich.org 70 i- Err bitreich.org 70 i- The following are examples of this property parameter: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19980119T020000 Err bitreich.org 70 i- Err bitreich.org 70 i- DTEND;TZID=America/New_York:19980119T030000 Err bitreich.org 70 i- Err bitreich.org 70 i- The "TZID" property parameter MUST NOT be applied to DATE Err bitreich.org 70 i- properties and DATE-TIME or TIME properties whose time values are Err bitreich.org 70 i- specified in UTC. Err bitreich.org 70 i- Err bitreich.org 70 i- The use of local time in a DATE-TIME or TIME value without the Err bitreich.org 70 i- "TZID" property parameter is to be interpreted as floating time, Err bitreich.org 70 i- regardless of the existence of "VTIMEZONE" calendar components in Err bitreich.org 70 i- the iCalendar object. Err bitreich.org 70 i- Err bitreich.org 70 i- For more information, see the sections on the value types DATE- Err bitreich.org 70 i- TIME and TIME. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 28] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-3.2.20. Value Data Types Err bitreich.org 70 i- Err bitreich.org 70 i- Parameter Name: VALUE Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: To explicitly specify the value type format for a property Err bitreich.org 70 i- value. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property parameter is defined by the Err bitreich.org 70 i- following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- valuetypeparam = "VALUE" "=" valuetype Err bitreich.org 70 i- Err bitreich.org 70 i- valuetype = ("BINARY" Err bitreich.org 70 i- / "BOOLEAN" Err bitreich.org 70 i- / "CAL-ADDRESS" Err bitreich.org 70 i- / "DATE" Err bitreich.org 70 i- / "DATE-TIME" Err bitreich.org 70 i- / "DURATION" Err bitreich.org 70 i- / "FLOAT" Err bitreich.org 70 i- / "INTEGER" Err bitreich.org 70 i- / "PERIOD" Err bitreich.org 70 i- / "RECUR" Err bitreich.org 70 i- / "TEXT" Err bitreich.org 70 i- / "TIME" Err bitreich.org 70 i- / "URI" Err bitreich.org 70 i- / "UTC-OFFSET" Err bitreich.org 70 i- / x-name Err bitreich.org 70 i- ; Some experimental iCalendar value type. Err bitreich.org 70 i- / iana-token) Err bitreich.org 70 i- ; Some other IANA-registered iCalendar value type. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This parameter specifies the value type and format of Err bitreich.org 70 i- the property value. The property values MUST be of a single value Err bitreich.org 70 i- type. For example, a "RDATE" property cannot have a combination Err bitreich.org 70 i- of DATE-TIME and TIME value types. Err bitreich.org 70 i- Err bitreich.org 70 i- If the property's value is the default value type, then this Err bitreich.org 70 i- parameter need not be specified. However, if the property's Err bitreich.org 70 i- default value type is overridden by some other allowable value Err bitreich.org 70 i- type, then this parameter MUST be specified. Err bitreich.org 70 i- Err bitreich.org 70 i- Applications MUST preserve the value data for x-name and iana- Err bitreich.org 70 i- token values that they don't recognize without attempting to Err bitreich.org 70 i- interpret or parse the value data. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 29] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-3.3. Property Value Data Types Err bitreich.org 70 i- Err bitreich.org 70 i- The properties in an iCalendar object are strongly typed. The Err bitreich.org 70 i- definition of each property restricts the value to be one of the Err bitreich.org 70 i- value data types, or simply value types, defined in this section. Err bitreich.org 70 i- The value type for a property will either be specified implicitly as Err bitreich.org 70 i- the default value type or will be explicitly specified with the Err bitreich.org 70 i- "VALUE" parameter. If the value type of a property is one of the Err bitreich.org 70 i- alternate valid types, then it MUST be explicitly specified with the Err bitreich.org 70 i- "VALUE" parameter. Err bitreich.org 70 i- Err bitreich.org 70 i-3.3.1. Binary Err bitreich.org 70 i- Err bitreich.org 70 i- Value Name: BINARY Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This value type is used to identify properties that contain Err bitreich.org 70 i- a character encoding of inline binary data. For example, an Err bitreich.org 70 i- inline attachment of a document might be included in an iCalendar Err bitreich.org 70 i- object. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This value type is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- binary = *(4b-char) [b-end] Err bitreich.org 70 i- ; A "BASE64" encoded character string, as defined by [RFC4648]. Err bitreich.org 70 i- Err bitreich.org 70 i- b-end = (2b-char "==") / (3b-char "=") Err bitreich.org 70 i- Err bitreich.org 70 i- b-char = ALPHA / DIGIT / "+" / "/" Err bitreich.org 70 i- Err bitreich.org 70 i- Description: Property values with this value type MUST also include Err bitreich.org 70 i- the inline encoding parameter sequence of ";ENCODING=BASE64". Err bitreich.org 70 i- That is, all inline binary data MUST first be character encoded Err bitreich.org 70 i- using the "BASE64" encoding method defined in [RFC2045]. No Err bitreich.org 70 i- additional content value encoding (i.e., BACKSLASH character Err bitreich.org 70 i- encoding, see Section 3.3.11) is defined for this value type. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 30] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of a "BASE64" encoded binary Err bitreich.org 70 i- value data: Err bitreich.org 70 i- Err bitreich.org 70 i- ATTACH;FMTTYPE=image/vnd.microsoft.icon;ENCODING=BASE64;VALUE Err bitreich.org 70 i- =BINARY:AAABAAEAEBAQAAEABAAoAQAAFgAAACgAAAAQAAAAIAAAAAEABAAA Err bitreich.org 70 i- AAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAAAAAgIAAAICAgADAwMAA////AAAA Err bitreich.org 70 i- AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA Err bitreich.org 70 i- AAAAAAAAAAAAAAAAAAAAAAMwAAAAAAABNEMQAAAAAAAkQgAAAAAAJEREQgAA Err bitreich.org 70 i- ACECQ0QgEgAAQxQzM0E0AABERCRCREQAADRDJEJEQwAAAhA0QwEQAAAAAERE Err bitreich.org 70 i- AAAAAAAAREQAAAAAAAAkQgAAAAAAAAMgAAAAAAAAAAAAAAAAAAAAAAAAAAAA Err bitreich.org 70 i- AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA Err bitreich.org 70 i- AAAAAAAAAAAA Err bitreich.org 70 i- Err bitreich.org 70 i-3.3.2. Boolean Err bitreich.org 70 i- Err bitreich.org 70 i- Value Name: BOOLEAN Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This value type is used to identify properties that contain Err bitreich.org 70 i- either a "TRUE" or "FALSE" Boolean value. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This value type is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- boolean = "TRUE" / "FALSE" Err bitreich.org 70 i- Err bitreich.org 70 i- Description: These values are case-insensitive text. No additional Err bitreich.org 70 i- content value encoding (i.e., BACKSLASH character encoding, see Err bitreich.org 70 i- Section 3.3.11) is defined for this value type. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of a hypothetical property that Err bitreich.org 70 i- has a BOOLEAN value type: Err bitreich.org 70 i- Err bitreich.org 70 i- TRUE Err bitreich.org 70 i- Err bitreich.org 70 i-3.3.3. Calendar User Address Err bitreich.org 70 i- Err bitreich.org 70 i- Value Name: CAL-ADDRESS Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This value type is used to identify properties that contain Err bitreich.org 70 i- a calendar user address. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This value type is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- cal-address = uri Err bitreich.org 70 i- Err bitreich.org 70 i- Description: The value is a URI as defined by [RFC3986] or any other Err bitreich.org 70 i- IANA-registered form for a URI. When used to address an Internet Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 31] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- email transport address for a calendar user, the value MUST be a Err bitreich.org 70 i- mailto URI, as defined by [RFC2368]. No additional content value Err bitreich.org 70 i- encoding (i.e., BACKSLASH character encoding, see Section 3.3.11) Err bitreich.org 70 i- is defined for this value type. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: Err bitreich.org 70 i- Err bitreich.org 70 i- mailto:jane_doe@example.com Err bitreich.org 70 i- Err bitreich.org 70 i-3.3.4. Date Err bitreich.org 70 i- Err bitreich.org 70 i- Value Name: DATE Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This value type is used to identify values that contain a Err bitreich.org 70 i- calendar date. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This value type is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- date = date-value Err bitreich.org 70 i- Err bitreich.org 70 i- date-value = date-fullyear date-month date-mday Err bitreich.org 70 i- date-fullyear = 4DIGIT Err bitreich.org 70 i- date-month = 2DIGIT ;01-12 Err bitreich.org 70 i- date-mday = 2DIGIT ;01-28, 01-29, 01-30, 01-31 Err bitreich.org 70 i- ;based on month/year Err bitreich.org 70 i- Err bitreich.org 70 i- Description: If the property permits, multiple "date" values are Err bitreich.org 70 i- specified as a COMMA-separated list of values. The format for the Err bitreich.org 70 i- value type is based on the [ISO.8601.2004] complete Err bitreich.org 70 i- representation, basic format for a calendar date. The textual Err bitreich.org 70 i- format specifies a four-digit year, two-digit month, and two-digit Err bitreich.org 70 i- day of the month. There are no separator characters between the Err bitreich.org 70 i- year, month, and day component text. Err bitreich.org 70 i- Err bitreich.org 70 i- No additional content value encoding (i.e., BACKSLASH character Err bitreich.org 70 i- encoding, see Section 3.3.11) is defined for this value type. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following represents July 14, 1997: Err bitreich.org 70 i- Err bitreich.org 70 i- 19970714 Err bitreich.org 70 i- Err bitreich.org 70 i-3.3.5. Date-Time Err bitreich.org 70 i- Err bitreich.org 70 i- Value Name: DATE-TIME Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This value type is used to identify values that specify a Err bitreich.org 70 i- precise calendar date and time of day. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 32] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This value type is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- date-time = date "T" time ;As specified in the DATE and TIME Err bitreich.org 70 i- ;value definitions Err bitreich.org 70 i- Err bitreich.org 70 i- Description: If the property permits, multiple "DATE-TIME" values Err bitreich.org 70 i- are specified as a COMMA-separated list of values. No additional Err bitreich.org 70 i- content value encoding (i.e., BACKSLASH character encoding, see Err bitreich.org 70 i- Section 3.3.11) is defined for this value type. Err bitreich.org 70 i- Err bitreich.org 70 i- The "DATE-TIME" value type is used to identify values that contain Err bitreich.org 70 i- a precise calendar date and time of day. The format is based on Err bitreich.org 70 i- the [ISO.8601.2004] complete representation, basic format for a Err bitreich.org 70 i- calendar date and time of day. The text format is a concatenation Err bitreich.org 70 i- of the "date", followed by the LATIN CAPITAL LETTER T character, Err bitreich.org 70 i- the time designator, followed by the "time" format. Err bitreich.org 70 i- Err bitreich.org 70 i- The "DATE-TIME" value type expresses time values in three forms: Err bitreich.org 70 i- Err bitreich.org 70 i- The form of date and time with UTC offset MUST NOT be used. For Err bitreich.org 70 i- example, the following is not valid for a DATE-TIME value: Err bitreich.org 70 i- Err bitreich.org 70 i- 19980119T230000-0800 ;Invalid time format Err bitreich.org 70 i- Err bitreich.org 70 i- FORM #1: DATE WITH LOCAL TIME Err bitreich.org 70 i- Err bitreich.org 70 i- The date with local time form is simply a DATE-TIME value that Err bitreich.org 70 i- does not contain the UTC designator nor does it reference a time Err bitreich.org 70 i- zone. For example, the following represents January 18, 1998, at Err bitreich.org 70 i- 11 PM: Err bitreich.org 70 i- Err bitreich.org 70 i- 19980118T230000 Err bitreich.org 70 i- Err bitreich.org 70 i- DATE-TIME values of this type are said to be "floating" and are Err bitreich.org 70 i- not bound to any time zone in particular. They are used to Err bitreich.org 70 i- represent the same hour, minute, and second value regardless of Err bitreich.org 70 i- which time zone is currently being observed. For example, an Err bitreich.org 70 i- event can be defined that indicates that an individual will be Err bitreich.org 70 i- busy from 11:00 AM to 1:00 PM every day, no matter which time zone Err bitreich.org 70 i- the person is in. In these cases, a local time can be specified. Err bitreich.org 70 i- The recipient of an iCalendar object with a property value Err bitreich.org 70 i- consisting of a local time, without any relative time zone Err bitreich.org 70 i- information, SHOULD interpret the value as being fixed to whatever Err bitreich.org 70 i- time zone the "ATTENDEE" is in at any given moment. This means Err bitreich.org 70 i- that two "Attendees", in different time zones, receiving the same Err bitreich.org 70 i- event definition as a floating time, may be participating in the Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 33] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- event at different actual times. Floating time SHOULD only be Err bitreich.org 70 i- used where that is the reasonable behavior. Err bitreich.org 70 i- Err bitreich.org 70 i- In most cases, a fixed time is desired. To properly communicate a Err bitreich.org 70 i- fixed time in a property value, either UTC time or local time with Err bitreich.org 70 i- time zone reference MUST be specified. Err bitreich.org 70 i- Err bitreich.org 70 i- The use of local time in a DATE-TIME value without the "TZID" Err bitreich.org 70 i- property parameter is to be interpreted as floating time, Err bitreich.org 70 i- regardless of the existence of "VTIMEZONE" calendar components in Err bitreich.org 70 i- the iCalendar object. Err bitreich.org 70 i- Err bitreich.org 70 i- FORM #2: DATE WITH UTC TIME Err bitreich.org 70 i- Err bitreich.org 70 i- The date with UTC time, or absolute time, is identified by a LATIN Err bitreich.org 70 i- CAPITAL LETTER Z suffix character, the UTC designator, appended to Err bitreich.org 70 i- the time value. For example, the following represents January 19, Err bitreich.org 70 i- 1998, at 0700 UTC: Err bitreich.org 70 i- Err bitreich.org 70 i- 19980119T070000Z Err bitreich.org 70 i- Err bitreich.org 70 i- The "TZID" property parameter MUST NOT be applied to DATE-TIME Err bitreich.org 70 i- properties whose time values are specified in UTC. Err bitreich.org 70 i- Err bitreich.org 70 i- FORM #3: DATE WITH LOCAL TIME AND TIME ZONE REFERENCE Err bitreich.org 70 i- Err bitreich.org 70 i- The date and local time with reference to time zone information is Err bitreich.org 70 i- identified by the use the "TZID" property parameter to reference Err bitreich.org 70 i- the appropriate time zone definition. "TZID" is discussed in Err bitreich.org 70 i- detail in Section 3.2.19. For example, the following represents Err bitreich.org 70 i- 2:00 A.M. in New York on January 19, 1998: Err bitreich.org 70 i- Err bitreich.org 70 i- TZID=America/New_York:19980119T020000 Err bitreich.org 70 i- Err bitreich.org 70 i- If, based on the definition of the referenced time zone, the local Err bitreich.org 70 i- time described occurs more than once (when changing from daylight Err bitreich.org 70 i- to standard time), the DATE-TIME value refers to the first Err bitreich.org 70 i- occurrence of the referenced time. Thus, TZID=America/ Err bitreich.org 70 i- New_York:20071104T013000 indicates November 4, 2007 at 1:30 A.M. Err bitreich.org 70 i- EDT (UTC-04:00). If the local time described does not occur (when Err bitreich.org 70 i- changing from standard to daylight time), the DATE-TIME value is Err bitreich.org 70 i- interpreted using the UTC offset before the gap in local times. Err bitreich.org 70 i- Thus, TZID=America/New_York:20070311T023000 indicates March 11, Err bitreich.org 70 i- 2007 at 3:30 A.M. EDT (UTC-04:00), one hour after 1:30 A.M. EST Err bitreich.org 70 i- (UTC-05:00). Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 34] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- A time value MUST only specify the second 60 when specifying a Err bitreich.org 70 i- positive leap second. For example: Err bitreich.org 70 i- Err bitreich.org 70 i- 19970630T235960Z Err bitreich.org 70 i- Err bitreich.org 70 i- Implementations that do not support leap seconds SHOULD interpret Err bitreich.org 70 i- the second 60 as equivalent to the second 59. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following represents July 14, 1997, at 1:30 PM in New Err bitreich.org 70 i- York City in each of the three time formats, using the "DTSTART" Err bitreich.org 70 i- property. Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART:19970714T133000 ; Local time Err bitreich.org 70 i- DTSTART:19970714T173000Z ; UTC time Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970714T133000 Err bitreich.org 70 i- ; Local time and time Err bitreich.org 70 i- ; zone reference Err bitreich.org 70 i- Err bitreich.org 70 i-3.3.6. Duration Err bitreich.org 70 i- Err bitreich.org 70 i- Value Name: DURATION Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This value type is used to identify properties that contain Err bitreich.org 70 i- a duration of time. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This value type is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- dur-value = (["+"] / "-") "P" (dur-date / dur-time / dur-week) Err bitreich.org 70 i- Err bitreich.org 70 i- dur-date = dur-day [dur-time] Err bitreich.org 70 i- dur-time = "T" (dur-hour / dur-minute / dur-second) Err bitreich.org 70 i- dur-week = 1*DIGIT "W" Err bitreich.org 70 i- dur-hour = 1*DIGIT "H" [dur-minute] Err bitreich.org 70 i- dur-minute = 1*DIGIT "M" [dur-second] Err bitreich.org 70 i- dur-second = 1*DIGIT "S" Err bitreich.org 70 i- dur-day = 1*DIGIT "D" Err bitreich.org 70 i- Err bitreich.org 70 i- Description: If the property permits, multiple "duration" values are Err bitreich.org 70 i- specified by a COMMA-separated list of values. The format is Err bitreich.org 70 i- based on the [ISO.8601.2004] complete representation basic format Err bitreich.org 70 i- with designators for the duration of time. The format can Err bitreich.org 70 i- represent nominal durations (weeks and days) and accurate Err bitreich.org 70 i- durations (hours, minutes, and seconds). Note that unlike Err bitreich.org 70 i- [ISO.8601.2004], this value type doesn't support the "Y" and "M" Err bitreich.org 70 i- designators to specify durations in terms of years and months. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 35] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- The duration of a week or a day depends on its position in the Err bitreich.org 70 i- calendar. In the case of discontinuities in the time scale, such Err bitreich.org 70 i- as the change from standard time to daylight time and back, the Err bitreich.org 70 i- computation of the exact duration requires the subtraction or Err bitreich.org 70 i- addition of the change of duration of the discontinuity. Leap Err bitreich.org 70 i- seconds MUST NOT be considered when computing an exact duration. Err bitreich.org 70 i- When computing an exact duration, the greatest order time Err bitreich.org 70 i- components MUST be added first, that is, the number of days MUST Err bitreich.org 70 i- be added first, followed by the number of hours, number of Err bitreich.org 70 i- minutes, and number of seconds. Err bitreich.org 70 i- Err bitreich.org 70 i- Negative durations are typically used to schedule an alarm to Err bitreich.org 70 i- trigger before an associated time (see Section 3.8.6.3). Err bitreich.org 70 i- Err bitreich.org 70 i- No additional content value encoding (i.e., BACKSLASH character Err bitreich.org 70 i- encoding, see Section 3.3.11) are defined for this value type. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: A duration of 15 days, 5 hours, and 20 seconds would be: Err bitreich.org 70 i- Err bitreich.org 70 i- P15DT5H0M20S Err bitreich.org 70 i- Err bitreich.org 70 i- A duration of 7 weeks would be: Err bitreich.org 70 i- Err bitreich.org 70 i- P7W Err bitreich.org 70 i- Err bitreich.org 70 i-3.3.7. Float Err bitreich.org 70 i- Err bitreich.org 70 i- Value Name: FLOAT Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This value type is used to identify properties that contain Err bitreich.org 70 i- a real-number value. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This value type is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- float = (["+"] / "-") 1*DIGIT ["." 1*DIGIT] Err bitreich.org 70 i- Err bitreich.org 70 i- Description: If the property permits, multiple "float" values are Err bitreich.org 70 i- specified by a COMMA-separated list of values. Err bitreich.org 70 i- Err bitreich.org 70 i- No additional content value encoding (i.e., BACKSLASH character Err bitreich.org 70 i- encoding, see Section 3.3.11) is defined for this value type. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: Err bitreich.org 70 i- Err bitreich.org 70 i- 1000000.0000001 Err bitreich.org 70 i- 1.333 Err bitreich.org 70 i- -3.14 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 36] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-3.3.8. Integer Err bitreich.org 70 i- Err bitreich.org 70 i- Value Name: INTEGER Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This value type is used to identify properties that contain Err bitreich.org 70 i- a signed integer value. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This value type is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- integer = (["+"] / "-") 1*DIGIT Err bitreich.org 70 i- Err bitreich.org 70 i- Description: If the property permits, multiple "integer" values are Err bitreich.org 70 i- specified by a COMMA-separated list of values. The valid range Err bitreich.org 70 i- for "integer" is -2147483648 to 2147483647. If the sign is not Err bitreich.org 70 i- specified, then the value is assumed to be positive. Err bitreich.org 70 i- Err bitreich.org 70 i- No additional content value encoding (i.e., BACKSLASH character Err bitreich.org 70 i- encoding, see Section 3.3.11) is defined for this value type. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: Err bitreich.org 70 i- Err bitreich.org 70 i- 1234567890 Err bitreich.org 70 i- -1234567890 Err bitreich.org 70 i- +1234567890 Err bitreich.org 70 i- 432109876 Err bitreich.org 70 i- Err bitreich.org 70 i-3.3.9. Period of Time Err bitreich.org 70 i- Err bitreich.org 70 i- Value Name: PERIOD Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This value type is used to identify values that contain a Err bitreich.org 70 i- precise period of time. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This value type is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- period = period-explicit / period-start Err bitreich.org 70 i- Err bitreich.org 70 i- period-explicit = date-time "/" date-time Err bitreich.org 70 i- ; [ISO.8601.2004] complete representation basic format for a Err bitreich.org 70 i- ; period of time consisting of a start and end. The start MUST Err bitreich.org 70 i- ; be before the end. Err bitreich.org 70 i- Err bitreich.org 70 i- period-start = date-time "/" dur-value Err bitreich.org 70 i- ; [ISO.8601.2004] complete representation basic format for a Err bitreich.org 70 i- ; period of time consisting of a start and positive duration Err bitreich.org 70 i- ; of time. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 37] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Description: If the property permits, multiple "period" values are Err bitreich.org 70 i- specified by a COMMA-separated list of values. There are two Err bitreich.org 70 i- forms of a period of time. First, a period of time is identified Err bitreich.org 70 i- by its start and its end. This format is based on the Err bitreich.org 70 i- [ISO.8601.2004] complete representation, basic format for "DATE- Err bitreich.org 70 i- TIME" start of the period, followed by a SOLIDUS character Err bitreich.org 70 i- followed by the "DATE-TIME" of the end of the period. The start Err bitreich.org 70 i- of the period MUST be before the end of the period. Second, a Err bitreich.org 70 i- period of time can also be defined by a start and a positive Err bitreich.org 70 i- duration of time. The format is based on the [ISO.8601.2004] Err bitreich.org 70 i- complete representation, basic format for the "DATE-TIME" start of Err bitreich.org 70 i- the period, followed by a SOLIDUS character, followed by the Err bitreich.org 70 i- [ISO.8601.2004] basic format for "DURATION" of the period. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The period starting at 18:00:00 UTC, on January 1, 1997 and Err bitreich.org 70 i- ending at 07:00:00 UTC on January 2, 1997 would be: Err bitreich.org 70 i- Err bitreich.org 70 i- 19970101T180000Z/19970102T070000Z Err bitreich.org 70 i- Err bitreich.org 70 i- The period start at 18:00:00 on January 1, 1997 and lasting 5 Err bitreich.org 70 i- hours and 30 minutes would be: Err bitreich.org 70 i- Err bitreich.org 70 i- 19970101T180000Z/PT5H30M Err bitreich.org 70 i- Err bitreich.org 70 i- No additional content value encoding (i.e., BACKSLASH character Err bitreich.org 70 i- encoding, see Section 3.3.11) is defined for this value type. Err bitreich.org 70 i- Err bitreich.org 70 i-3.3.10. Recurrence Rule Err bitreich.org 70 i- Err bitreich.org 70 i- Value Name: RECUR Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This value type is used to identify properties that contain Err bitreich.org 70 i- a recurrence rule specification. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This value type is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- recur = recur-rule-part *( ";" recur-rule-part ) Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The rule parts are not ordered in any Err bitreich.org 70 i- ; particular sequence. Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The FREQ rule part is REQUIRED, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The UNTIL or COUNT rule parts are OPTIONAL, Err bitreich.org 70 i- ; but they MUST NOT occur in the same 'recur'. Err bitreich.org 70 i- ; Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 38] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- ; The other rule parts are OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- Err bitreich.org 70 i- recur-rule-part = ( "FREQ" "=" freq ) Err bitreich.org 70 i- / ( "UNTIL" "=" enddate ) Err bitreich.org 70 i- / ( "COUNT" "=" 1*DIGIT ) Err bitreich.org 70 i- / ( "INTERVAL" "=" 1*DIGIT ) Err bitreich.org 70 i- / ( "BYSECOND" "=" byseclist ) Err bitreich.org 70 i- / ( "BYMINUTE" "=" byminlist ) Err bitreich.org 70 i- / ( "BYHOUR" "=" byhrlist ) Err bitreich.org 70 i- / ( "BYDAY" "=" bywdaylist ) Err bitreich.org 70 i- / ( "BYMONTHDAY" "=" bymodaylist ) Err bitreich.org 70 i- / ( "BYYEARDAY" "=" byyrdaylist ) Err bitreich.org 70 i- / ( "BYWEEKNO" "=" bywknolist ) Err bitreich.org 70 i- / ( "BYMONTH" "=" bymolist ) Err bitreich.org 70 i- / ( "BYSETPOS" "=" bysplist ) Err bitreich.org 70 i- / ( "WKST" "=" weekday ) Err bitreich.org 70 i- Err bitreich.org 70 i- freq = "SECONDLY" / "MINUTELY" / "HOURLY" / "DAILY" Err bitreich.org 70 i- / "WEEKLY" / "MONTHLY" / "YEARLY" Err bitreich.org 70 i- Err bitreich.org 70 i- enddate = date / date-time Err bitreich.org 70 i- Err bitreich.org 70 i- byseclist = ( seconds *("," seconds) ) Err bitreich.org 70 i- Err bitreich.org 70 i- seconds = 1*2DIGIT ;0 to 60 Err bitreich.org 70 i- Err bitreich.org 70 i- byminlist = ( minutes *("," minutes) ) Err bitreich.org 70 i- Err bitreich.org 70 i- minutes = 1*2DIGIT ;0 to 59 Err bitreich.org 70 i- Err bitreich.org 70 i- byhrlist = ( hour *("," hour) ) Err bitreich.org 70 i- Err bitreich.org 70 i- hour = 1*2DIGIT ;0 to 23 Err bitreich.org 70 i- Err bitreich.org 70 i- bywdaylist = ( weekdaynum *("," weekdaynum) ) Err bitreich.org 70 i- Err bitreich.org 70 i- weekdaynum = [[plus / minus] ordwk] weekday Err bitreich.org 70 i- Err bitreich.org 70 i- plus = "+" Err bitreich.org 70 i- Err bitreich.org 70 i- minus = "-" Err bitreich.org 70 i- Err bitreich.org 70 i- ordwk = 1*2DIGIT ;1 to 53 Err bitreich.org 70 i- Err bitreich.org 70 i- weekday = "SU" / "MO" / "TU" / "WE" / "TH" / "FR" / "SA" Err bitreich.org 70 i- ;Corresponding to SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, Err bitreich.org 70 i- ;FRIDAY, and SATURDAY days of the week. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 39] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- bymodaylist = ( monthdaynum *("," monthdaynum) ) Err bitreich.org 70 i- Err bitreich.org 70 i- monthdaynum = [plus / minus] ordmoday Err bitreich.org 70 i- Err bitreich.org 70 i- ordmoday = 1*2DIGIT ;1 to 31 Err bitreich.org 70 i- Err bitreich.org 70 i- byyrdaylist = ( yeardaynum *("," yeardaynum) ) Err bitreich.org 70 i- Err bitreich.org 70 i- yeardaynum = [plus / minus] ordyrday Err bitreich.org 70 i- Err bitreich.org 70 i- ordyrday = 1*3DIGIT ;1 to 366 Err bitreich.org 70 i- Err bitreich.org 70 i- bywknolist = ( weeknum *("," weeknum) ) Err bitreich.org 70 i- Err bitreich.org 70 i- weeknum = [plus / minus] ordwk Err bitreich.org 70 i- Err bitreich.org 70 i- bymolist = ( monthnum *("," monthnum) ) Err bitreich.org 70 i- Err bitreich.org 70 i- monthnum = 1*2DIGIT ;1 to 12 Err bitreich.org 70 i- Err bitreich.org 70 i- bysplist = ( setposday *("," setposday) ) Err bitreich.org 70 i- Err bitreich.org 70 i- setposday = yeardaynum Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This value type is a structured value consisting of a Err bitreich.org 70 i- list of one or more recurrence grammar parts. Each rule part is Err bitreich.org 70 i- defined by a NAME=VALUE pair. The rule parts are separated from Err bitreich.org 70 i- each other by the SEMICOLON character. The rule parts are not Err bitreich.org 70 i- ordered in any particular sequence. Individual rule parts MUST Err bitreich.org 70 i- only be specified once. Compliant applications MUST accept rule Err bitreich.org 70 i- parts ordered in any sequence, but to ensure backward Err bitreich.org 70 i- compatibility with applications that pre-date this revision of Err bitreich.org 70 i- iCalendar the FREQ rule part MUST be the first rule part specified Err bitreich.org 70 i- in a RECUR value. Err bitreich.org 70 i- Err bitreich.org 70 i- The FREQ rule part identifies the type of recurrence rule. This Err bitreich.org 70 i- rule part MUST be specified in the recurrence rule. Valid values Err bitreich.org 70 i- include SECONDLY, to specify repeating events based on an interval Err bitreich.org 70 i- of a second or more; MINUTELY, to specify repeating events based Err bitreich.org 70 i- on an interval of a minute or more; HOURLY, to specify repeating Err bitreich.org 70 i- events based on an interval of an hour or more; DAILY, to specify Err bitreich.org 70 i- repeating events based on an interval of a day or more; WEEKLY, to Err bitreich.org 70 i- specify repeating events based on an interval of a week or more; Err bitreich.org 70 i- MONTHLY, to specify repeating events based on an interval of a Err bitreich.org 70 i- month or more; and YEARLY, to specify repeating events based on an Err bitreich.org 70 i- interval of a year or more. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 40] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- The INTERVAL rule part contains a positive integer representing at Err bitreich.org 70 i- which intervals the recurrence rule repeats. The default value is Err bitreich.org 70 i- "1", meaning every second for a SECONDLY rule, every minute for a Err bitreich.org 70 i- MINUTELY rule, every hour for an HOURLY rule, every day for a Err bitreich.org 70 i- DAILY rule, every week for a WEEKLY rule, every month for a Err bitreich.org 70 i- MONTHLY rule, and every year for a YEARLY rule. For example, Err bitreich.org 70 i- within a DAILY rule, a value of "8" means every eight days. Err bitreich.org 70 i- Err bitreich.org 70 i- The UNTIL rule part defines a DATE or DATE-TIME value that bounds Err bitreich.org 70 i- the recurrence rule in an inclusive manner. If the value Err bitreich.org 70 i- specified by UNTIL is synchronized with the specified recurrence, Err bitreich.org 70 i- this DATE or DATE-TIME becomes the last instance of the Err bitreich.org 70 i- recurrence. The value of the UNTIL rule part MUST have the same Err bitreich.org 70 i- value type as the "DTSTART" property. Furthermore, if the Err bitreich.org 70 i- "DTSTART" property is specified as a date with local time, then Err bitreich.org 70 i- the UNTIL rule part MUST also be specified as a date with local Err bitreich.org 70 i- time. If the "DTSTART" property is specified as a date with UTC Err bitreich.org 70 i- time or a date with local time and time zone reference, then the Err bitreich.org 70 i- UNTIL rule part MUST be specified as a date with UTC time. In the Err bitreich.org 70 i- case of the "STANDARD" and "DAYLIGHT" sub-components the UNTIL Err bitreich.org 70 i- rule part MUST always be specified as a date with UTC time. If Err bitreich.org 70 i- specified as a DATE-TIME value, then it MUST be specified in a UTC Err bitreich.org 70 i- time format. If not present, and the COUNT rule part is also not Err bitreich.org 70 i- present, the "RRULE" is considered to repeat forever. Err bitreich.org 70 i- Err bitreich.org 70 i- The COUNT rule part defines the number of occurrences at which to Err bitreich.org 70 i- range-bound the recurrence. The "DTSTART" property value always Err bitreich.org 70 i- counts as the first occurrence. Err bitreich.org 70 i- Err bitreich.org 70 i- The BYSECOND rule part specifies a COMMA-separated list of seconds Err bitreich.org 70 i- within a minute. Valid values are 0 to 60. The BYMINUTE rule Err bitreich.org 70 i- part specifies a COMMA-separated list of minutes within an hour. Err bitreich.org 70 i- Valid values are 0 to 59. The BYHOUR rule part specifies a COMMA- Err bitreich.org 70 i- separated list of hours of the day. Valid values are 0 to 23. Err bitreich.org 70 i- The BYSECOND, BYMINUTE and BYHOUR rule parts MUST NOT be specified Err bitreich.org 70 i- when the associated "DTSTART" property has a DATE value type. Err bitreich.org 70 i- These rule parts MUST be ignored in RECUR value that violate the Err bitreich.org 70 i- above requirement (e.g., generated by applications that pre-date Err bitreich.org 70 i- this revision of iCalendar). Err bitreich.org 70 i- Err bitreich.org 70 i- The BYDAY rule part specifies a COMMA-separated list of days of Err bitreich.org 70 i- the week; SU indicates Sunday; MO indicates Monday; TU indicates Err bitreich.org 70 i- Tuesday; WE indicates Wednesday; TH indicates Thursday; FR Err bitreich.org 70 i- indicates Friday; and SA indicates Saturday. Err bitreich.org 70 i- Err bitreich.org 70 i- Each BYDAY value can also be preceded by a positive (+n) or Err bitreich.org 70 i- negative (-n) integer. If present, this indicates the nth Err bitreich.org 70 i- occurrence of a specific day within the MONTHLY or YEARLY "RRULE". Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 41] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- For example, within a MONTHLY rule, +1MO (or simply 1MO) Err bitreich.org 70 i- represents the first Monday within the month, whereas -1MO Err bitreich.org 70 i- represents the last Monday of the month. The numeric value in a Err bitreich.org 70 i- BYDAY rule part with the FREQ rule part set to YEARLY corresponds Err bitreich.org 70 i- to an offset within the month when the BYMONTH rule part is Err bitreich.org 70 i- present, and corresponds to an offset within the year when the Err bitreich.org 70 i- BYWEEKNO or BYMONTH rule parts are present. If an integer Err bitreich.org 70 i- modifier is not present, it means all days of this type within the Err bitreich.org 70 i- specified frequency. For example, within a MONTHLY rule, MO Err bitreich.org 70 i- represents all Mondays within the month. The BYDAY rule part MUST Err bitreich.org 70 i- NOT be specified with a numeric value when the FREQ rule part is Err bitreich.org 70 i- not set to MONTHLY or YEARLY. Furthermore, the BYDAY rule part Err bitreich.org 70 i- MUST NOT be specified with a numeric value with the FREQ rule part Err bitreich.org 70 i- set to YEARLY when the BYWEEKNO rule part is specified. Err bitreich.org 70 i- Err bitreich.org 70 i- The BYMONTHDAY rule part specifies a COMMA-separated list of days Err bitreich.org 70 i- of the month. Valid values are 1 to 31 or -31 to -1. For Err bitreich.org 70 i- example, -10 represents the tenth to the last day of the month. Err bitreich.org 70 i- The BYMONTHDAY rule part MUST NOT be specified when the FREQ rule Err bitreich.org 70 i- part is set to WEEKLY. Err bitreich.org 70 i- Err bitreich.org 70 i- The BYYEARDAY rule part specifies a COMMA-separated list of days Err bitreich.org 70 i- of the year. Valid values are 1 to 366 or -366 to -1. For Err bitreich.org 70 i- example, -1 represents the last day of the year (December 31st) Err bitreich.org 70 i- and -306 represents the 306th to the last day of the year (March Err bitreich.org 70 i- 1st). The BYYEARDAY rule part MUST NOT be specified when the FREQ Err bitreich.org 70 i- rule part is set to DAILY, WEEKLY, or MONTHLY. Err bitreich.org 70 i- Err bitreich.org 70 i- The BYWEEKNO rule part specifies a COMMA-separated list of Err bitreich.org 70 i- ordinals specifying weeks of the year. Valid values are 1 to 53 Err bitreich.org 70 i- or -53 to -1. This corresponds to weeks according to week Err bitreich.org 70 i- numbering as defined in [ISO.8601.2004]. A week is defined as a Err bitreich.org 70 i- seven day period, starting on the day of the week defined to be Err bitreich.org 70 i- the week start (see WKST). Week number one of the calendar year Err bitreich.org 70 i- is the first week that contains at least four (4) days in that Err bitreich.org 70 i- calendar year. This rule part MUST NOT be used when the FREQ rule Err bitreich.org 70 i- part is set to anything other than YEARLY. For example, 3 Err bitreich.org 70 i- represents the third week of the year. Err bitreich.org 70 i- Err bitreich.org 70 i- Note: Assuming a Monday week start, week 53 can only occur when Err bitreich.org 70 i- Thursday is January 1 or if it is a leap year and Wednesday is Err bitreich.org 70 i- January 1. Err bitreich.org 70 i- Err bitreich.org 70 i- The BYMONTH rule part specifies a COMMA-separated list of months Err bitreich.org 70 i- of the year. Valid values are 1 to 12. Err bitreich.org 70 i- Err bitreich.org 70 i- The WKST rule part specifies the day on which the workweek starts. Err bitreich.org 70 i- Valid values are MO, TU, WE, TH, FR, SA, and SU. This is Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 42] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- significant when a WEEKLY "RRULE" has an interval greater than 1, Err bitreich.org 70 i- and a BYDAY rule part is specified. This is also significant when Err bitreich.org 70 i- in a YEARLY "RRULE" when a BYWEEKNO rule part is specified. The Err bitreich.org 70 i- default value is MO. Err bitreich.org 70 i- Err bitreich.org 70 i- The BYSETPOS rule part specifies a COMMA-separated list of values Err bitreich.org 70 i- that corresponds to the nth occurrence within the set of Err bitreich.org 70 i- recurrence instances specified by the rule. BYSETPOS operates on Err bitreich.org 70 i- a set of recurrence instances in one interval of the recurrence Err bitreich.org 70 i- rule. For example, in a WEEKLY rule, the interval would be one Err bitreich.org 70 i- week A set of recurrence instances starts at the beginning of the Err bitreich.org 70 i- interval defined by the FREQ rule part. Valid values are 1 to 366 Err bitreich.org 70 i- or -366 to -1. It MUST only be used in conjunction with another Err bitreich.org 70 i- BYxxx rule part. For example "the last work day of the month" Err bitreich.org 70 i- could be represented as: Err bitreich.org 70 i- Err bitreich.org 70 i- FREQ=MONTHLY;BYDAY=MO,TU,WE,TH,FR;BYSETPOS=-1 Err bitreich.org 70 i- Err bitreich.org 70 i- Each BYSETPOS value can include a positive (+n) or negative (-n) Err bitreich.org 70 i- integer. If present, this indicates the nth occurrence of the Err bitreich.org 70 i- specific occurrence within the set of occurrences specified by the Err bitreich.org 70 i- rule. Err bitreich.org 70 i- Err bitreich.org 70 i- Recurrence rules may generate recurrence instances with an invalid Err bitreich.org 70 i- date (e.g., February 30) or nonexistent local time (e.g., 1:30 AM Err bitreich.org 70 i- on a day where the local time is moved forward by an hour at 1:00 Err bitreich.org 70 i- AM). Such recurrence instances MUST be ignored and MUST NOT be Err bitreich.org 70 i- counted as part of the recurrence set. Err bitreich.org 70 i- Err bitreich.org 70 i- Information, not contained in the rule, necessary to determine the Err bitreich.org 70 i- various recurrence instance start time and dates are derived from Err bitreich.org 70 i- the Start Time ("DTSTART") component attribute. For example, Err bitreich.org 70 i- "FREQ=YEARLY;BYMONTH=1" doesn't specify a specific day within the Err bitreich.org 70 i- month or a time. This information would be the same as what is Err bitreich.org 70 i- specified for "DTSTART". Err bitreich.org 70 i- Err bitreich.org 70 i- BYxxx rule parts modify the recurrence in some manner. BYxxx rule Err bitreich.org 70 i- parts for a period of time that is the same or greater than the Err bitreich.org 70 i- frequency generally reduce or limit the number of occurrences of Err bitreich.org 70 i- the recurrence generated. For example, "FREQ=DAILY;BYMONTH=1" Err bitreich.org 70 i- reduces the number of recurrence instances from all days (if Err bitreich.org 70 i- BYMONTH rule part is not present) to all days in January. BYxxx Err bitreich.org 70 i- rule parts for a period of time less than the frequency generally Err bitreich.org 70 i- increase or expand the number of occurrences of the recurrence. Err bitreich.org 70 i- For example, "FREQ=YEARLY;BYMONTH=1,2" increases the number of Err bitreich.org 70 i- days within the yearly recurrence set from 1 (if BYMONTH rule part Err bitreich.org 70 i- is not present) to 2. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 43] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- If multiple BYxxx rule parts are specified, then after evaluating Err bitreich.org 70 i- the specified FREQ and INTERVAL rule parts, the BYxxx rule parts Err bitreich.org 70 i- are applied to the current set of evaluated occurrences in the Err bitreich.org 70 i- following order: BYMONTH, BYWEEKNO, BYYEARDAY, BYMONTHDAY, BYDAY, Err bitreich.org 70 i- BYHOUR, BYMINUTE, BYSECOND and BYSETPOS; then COUNT and UNTIL are Err bitreich.org 70 i- evaluated. Err bitreich.org 70 i- Err bitreich.org 70 i- The table below summarizes the dependency of BYxxx rule part Err bitreich.org 70 i- expand or limit behavior on the FREQ rule part value. Err bitreich.org 70 i- Err bitreich.org 70 i- The term "N/A" means that the corresponding BYxxx rule part MUST Err bitreich.org 70 i- NOT be used with the corresponding FREQ value. Err bitreich.org 70 i- Err bitreich.org 70 i- BYDAY has some special behavior depending on the FREQ value and Err bitreich.org 70 i- this is described in separate notes below the table. Err bitreich.org 70 i- Err bitreich.org 70 i- +----------+--------+--------+-------+-------+------+-------+------+ Err bitreich.org 70 i- | |SECONDLY|MINUTELY|HOURLY |DAILY |WEEKLY|MONTHLY|YEARLY| Err bitreich.org 70 i- +----------+--------+--------+-------+-------+------+-------+------+ Err bitreich.org 70 i- |BYMONTH |Limit |Limit |Limit |Limit |Limit |Limit |Expand| Err bitreich.org 70 i- +----------+--------+--------+-------+-------+------+-------+------+ Err bitreich.org 70 i- |BYWEEKNO |N/A |N/A |N/A |N/A |N/A |N/A |Expand| Err bitreich.org 70 i- +----------+--------+--------+-------+-------+------+-------+------+ Err bitreich.org 70 i- |BYYEARDAY |Limit |Limit |Limit |N/A |N/A |N/A |Expand| Err bitreich.org 70 i- +----------+--------+--------+-------+-------+------+-------+------+ Err bitreich.org 70 i- |BYMONTHDAY|Limit |Limit |Limit |Limit |N/A |Expand |Expand| Err bitreich.org 70 i- +----------+--------+--------+-------+-------+------+-------+------+ Err bitreich.org 70 i- |BYDAY |Limit |Limit |Limit |Limit |Expand|Note 1 |Note 2| Err bitreich.org 70 i- +----------+--------+--------+-------+-------+------+-------+------+ Err bitreich.org 70 i- |BYHOUR |Limit |Limit |Limit |Expand |Expand|Expand |Expand| Err bitreich.org 70 i- +----------+--------+--------+-------+-------+------+-------+------+ Err bitreich.org 70 i- |BYMINUTE |Limit |Limit |Expand |Expand |Expand|Expand |Expand| Err bitreich.org 70 i- +----------+--------+--------+-------+-------+------+-------+------+ Err bitreich.org 70 i- |BYSECOND |Limit |Expand |Expand |Expand |Expand|Expand |Expand| Err bitreich.org 70 i- +----------+--------+--------+-------+-------+------+-------+------+ Err bitreich.org 70 i- |BYSETPOS |Limit |Limit |Limit |Limit |Limit |Limit |Limit | Err bitreich.org 70 i- +----------+--------+--------+-------+-------+------+-------+------+ Err bitreich.org 70 i- Err bitreich.org 70 i- Note 1: Limit if BYMONTHDAY is present; otherwise, special expand Err bitreich.org 70 i- for MONTHLY. Err bitreich.org 70 i- Err bitreich.org 70 i- Note 2: Limit if BYYEARDAY or BYMONTHDAY is present; otherwise, Err bitreich.org 70 i- special expand for WEEKLY if BYWEEKNO present; otherwise, Err bitreich.org 70 i- special expand for MONTHLY if BYMONTH present; otherwise, Err bitreich.org 70 i- special expand for YEARLY. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 44] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Here is an example of evaluating multiple BYxxx rule parts. Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970105T083000 Err bitreich.org 70 i- RRULE:FREQ=YEARLY;INTERVAL=2;BYMONTH=1;BYDAY=SU;BYHOUR=8,9; Err bitreich.org 70 i- BYMINUTE=30 Err bitreich.org 70 i- Err bitreich.org 70 i- First, the "INTERVAL=2" would be applied to "FREQ=YEARLY" to Err bitreich.org 70 i- arrive at "every other year". Then, "BYMONTH=1" would be applied Err bitreich.org 70 i- to arrive at "every January, every other year". Then, "BYDAY=SU" Err bitreich.org 70 i- would be applied to arrive at "every Sunday in January, every Err bitreich.org 70 i- other year". Then, "BYHOUR=8,9" would be applied to arrive at Err bitreich.org 70 i- "every Sunday in January at 8 AM and 9 AM, every other year". Err bitreich.org 70 i- Then, "BYMINUTE=30" would be applied to arrive at "every Sunday in Err bitreich.org 70 i- January at 8:30 AM and 9:30 AM, every other year". Then, lacking Err bitreich.org 70 i- information from "RRULE", the second is derived from "DTSTART", to Err bitreich.org 70 i- end up in "every Sunday in January at 8:30:00 AM and 9:30:00 AM, Err bitreich.org 70 i- every other year". Similarly, if the BYMINUTE, BYHOUR, BYDAY, Err bitreich.org 70 i- BYMONTHDAY, or BYMONTH rule part were missing, the appropriate Err bitreich.org 70 i- minute, hour, day, or month would have been retrieved from the Err bitreich.org 70 i- "DTSTART" property. Err bitreich.org 70 i- Err bitreich.org 70 i- If the computed local start time of a recurrence instance does not Err bitreich.org 70 i- exist, or occurs more than once, for the specified time zone, the Err bitreich.org 70 i- time of the recurrence instance is interpreted in the same manner Err bitreich.org 70 i- as an explicit DATE-TIME value describing that date and time, as Err bitreich.org 70 i- specified in Section 3.3.5. Err bitreich.org 70 i- Err bitreich.org 70 i- No additional content value encoding (i.e., BACKSLASH character Err bitreich.org 70 i- encoding, see Section 3.3.11) is defined for this value type. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is a rule that specifies 10 occurrences that Err bitreich.org 70 i- occur every other day: Err bitreich.org 70 i- Err bitreich.org 70 i- FREQ=DAILY;COUNT=10;INTERVAL=2 Err bitreich.org 70 i- Err bitreich.org 70 i- There are other examples specified in Section 3.8.5.3. Err bitreich.org 70 i- Err bitreich.org 70 i-3.3.11. Text Err bitreich.org 70 i- Err bitreich.org 70 i- Value Name: TEXT Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This value type is used to identify values that contain Err bitreich.org 70 i- human-readable text. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This value type is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 45] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- text = *(TSAFE-CHAR / ":" / DQUOTE / ESCAPED-CHAR) Err bitreich.org 70 i- ; Folded according to description above Err bitreich.org 70 i- Err bitreich.org 70 i- ESCAPED-CHAR = ("\\" / "\;" / "\," / "\N" / "\n") Err bitreich.org 70 i- ; \\ encodes \, \N or \n encodes newline Err bitreich.org 70 i- ; \; encodes ;, \, encodes , Err bitreich.org 70 i- Err bitreich.org 70 i- TSAFE-CHAR = WSP / %x21 / %x23-2B / %x2D-39 / %x3C-5B / Err bitreich.org 70 i- %x5D-7E / NON-US-ASCII Err bitreich.org 70 i- ; Any character except CONTROLs not needed by the current Err bitreich.org 70 i- ; character set, DQUOTE, ";", ":", "\", "," Err bitreich.org 70 i- Err bitreich.org 70 i- Description: If the property permits, multiple TEXT values are Err bitreich.org 70 i- specified by a COMMA-separated list of values. Err bitreich.org 70 i- Err bitreich.org 70 i- The language in which the text is represented can be controlled by Err bitreich.org 70 i- the "LANGUAGE" property parameter. Err bitreich.org 70 i- Err bitreich.org 70 i- An intentional formatted text line break MUST only be included in Err bitreich.org 70 i- a "TEXT" property value by representing the line break with the Err bitreich.org 70 i- character sequence of BACKSLASH, followed by a LATIN SMALL LETTER Err bitreich.org 70 i- N or a LATIN CAPITAL LETTER N, that is "\n" or "\N". Err bitreich.org 70 i- Err bitreich.org 70 i- The "TEXT" property values may also contain special characters Err bitreich.org 70 i- that are used to signify delimiters, such as a COMMA character for Err bitreich.org 70 i- lists of values or a SEMICOLON character for structured values. Err bitreich.org 70 i- In order to support the inclusion of these special characters in Err bitreich.org 70 i- "TEXT" property values, they MUST be escaped with a BACKSLASH Err bitreich.org 70 i- character. A BACKSLASH character in a "TEXT" property value MUST Err bitreich.org 70 i- be escaped with another BACKSLASH character. A COMMA character in Err bitreich.org 70 i- a "TEXT" property value MUST be escaped with a BACKSLASH Err bitreich.org 70 i- character. A SEMICOLON character in a "TEXT" property value MUST Err bitreich.org 70 i- be escaped with a BACKSLASH character. However, a COLON character Err bitreich.org 70 i- in a "TEXT" property value SHALL NOT be escaped with a BACKSLASH Err bitreich.org 70 i- character. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: A multiple line value of: Err bitreich.org 70 i- Err bitreich.org 70 i- Project XYZ Final Review Err bitreich.org 70 i- Conference Room - 3B Err bitreich.org 70 i- Come Prepared. Err bitreich.org 70 i- Err bitreich.org 70 i- would be represented as: Err bitreich.org 70 i- Err bitreich.org 70 i- Project XYZ Final Review\nConference Room - 3B\nCome Prepared. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 46] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-3.3.12. Time Err bitreich.org 70 i- Err bitreich.org 70 i- Value Name: TIME Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This value type is used to identify values that contain a Err bitreich.org 70 i- time of day. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This value type is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- time = time-hour time-minute time-second [time-utc] Err bitreich.org 70 i- Err bitreich.org 70 i- time-hour = 2DIGIT ;00-23 Err bitreich.org 70 i- time-minute = 2DIGIT ;00-59 Err bitreich.org 70 i- time-second = 2DIGIT ;00-60 Err bitreich.org 70 i- ;The "60" value is used to account for positive "leap" seconds. Err bitreich.org 70 i- Err bitreich.org 70 i- time-utc = "Z" Err bitreich.org 70 i- Err bitreich.org 70 i- Description: If the property permits, multiple "time" values are Err bitreich.org 70 i- specified by a COMMA-separated list of values. No additional Err bitreich.org 70 i- content value encoding (i.e., BACKSLASH character encoding, see Err bitreich.org 70 i- Section 3.3.11) is defined for this value type. Err bitreich.org 70 i- Err bitreich.org 70 i- The "TIME" value type is used to identify values that contain a Err bitreich.org 70 i- time of day. The format is based on the [ISO.8601.2004] complete Err bitreich.org 70 i- representation, basic format for a time of day. The text format Err bitreich.org 70 i- consists of a two-digit, 24-hour of the day (i.e., values 00-23), Err bitreich.org 70 i- two-digit minute in the hour (i.e., values 00-59), and two-digit Err bitreich.org 70 i- seconds in the minute (i.e., values 00-60). The seconds value of Err bitreich.org 70 i- 60 MUST only be used to account for positive "leap" seconds. Err bitreich.org 70 i- Fractions of a second are not supported by this format. Err bitreich.org 70 i- Err bitreich.org 70 i- In parallel to the "DATE-TIME" definition above, the "TIME" value Err bitreich.org 70 i- type expresses time values in three forms: Err bitreich.org 70 i- Err bitreich.org 70 i- The form of time with UTC offset MUST NOT be used. For example, Err bitreich.org 70 i- the following is not valid for a time value: Err bitreich.org 70 i- Err bitreich.org 70 i- 230000-0800 ;Invalid time format Err bitreich.org 70 i- Err bitreich.org 70 i- FORM #1 LOCAL TIME Err bitreich.org 70 i- Err bitreich.org 70 i- The local time form is simply a time value that does not contain Err bitreich.org 70 i- the UTC designator nor does it reference a time zone. For Err bitreich.org 70 i- example, 11:00 PM: Err bitreich.org 70 i- Err bitreich.org 70 i- 230000 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 47] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Time values of this type are said to be "floating" and are not Err bitreich.org 70 i- bound to any time zone in particular. They are used to represent Err bitreich.org 70 i- the same hour, minute, and second value regardless of which time Err bitreich.org 70 i- zone is currently being observed. For example, an event can be Err bitreich.org 70 i- defined that indicates that an individual will be busy from 11:00 Err bitreich.org 70 i- AM to 1:00 PM every day, no matter which time zone the person is Err bitreich.org 70 i- in. In these cases, a local time can be specified. The recipient Err bitreich.org 70 i- of an iCalendar object with a property value consisting of a local Err bitreich.org 70 i- time, without any relative time zone information, SHOULD interpret Err bitreich.org 70 i- the value as being fixed to whatever time zone the "ATTENDEE" is Err bitreich.org 70 i- in at any given moment. This means that two "Attendees", may Err bitreich.org 70 i- participate in the same event at different UTC times; floating Err bitreich.org 70 i- time SHOULD only be used where that is reasonable behavior. Err bitreich.org 70 i- Err bitreich.org 70 i- In most cases, a fixed time is desired. To properly communicate a Err bitreich.org 70 i- fixed time in a property value, either UTC time or local time with Err bitreich.org 70 i- time zone reference MUST be specified. Err bitreich.org 70 i- Err bitreich.org 70 i- The use of local time in a TIME value without the "TZID" property Err bitreich.org 70 i- parameter is to be interpreted as floating time, regardless of the Err bitreich.org 70 i- existence of "VTIMEZONE" calendar components in the iCalendar Err bitreich.org 70 i- object. Err bitreich.org 70 i- Err bitreich.org 70 i- FORM #2: UTC TIME Err bitreich.org 70 i- Err bitreich.org 70 i- UTC time, or absolute time, is identified by a LATIN CAPITAL Err bitreich.org 70 i- LETTER Z suffix character, the UTC designator, appended to the Err bitreich.org 70 i- time value. For example, the following represents 07:00 AM UTC: Err bitreich.org 70 i- Err bitreich.org 70 i- 070000Z Err bitreich.org 70 i- Err bitreich.org 70 i- The "TZID" property parameter MUST NOT be applied to TIME Err bitreich.org 70 i- properties whose time values are specified in UTC. Err bitreich.org 70 i- Err bitreich.org 70 i- FORM #3: LOCAL TIME AND TIME ZONE REFERENCE Err bitreich.org 70 i- Err bitreich.org 70 i- The local time with reference to time zone information form is Err bitreich.org 70 i- identified by the use the "TZID" property parameter to reference Err bitreich.org 70 i- the appropriate time zone definition. "TZID" is discussed in Err bitreich.org 70 i- detail in Section 3.2.19. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following represents 8:30 AM in New York in winter, Err bitreich.org 70 i- five hours behind UTC, in each of the three formats: Err bitreich.org 70 i- Err bitreich.org 70 i- 083000 Err bitreich.org 70 i- 133000Z Err bitreich.org 70 i- TZID=America/New_York:083000 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 48] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-3.3.13. URI Err bitreich.org 70 i- Err bitreich.org 70 i- Value Name: URI Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This value type is used to identify values that contain a Err bitreich.org 70 i- uniform resource identifier (URI) type of reference to the Err bitreich.org 70 i- property value. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This value type is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- uri = Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This value type might be used to reference binary Err bitreich.org 70 i- information, for values that are large, or otherwise undesirable Err bitreich.org 70 i- to include directly in the iCalendar object. Err bitreich.org 70 i- Err bitreich.org 70 i- Property values with this value type MUST follow the generic URI Err bitreich.org 70 i- syntax defined in [RFC3986]. Err bitreich.org 70 i- Err bitreich.org 70 i- When a property parameter value is a URI value type, the URI MUST Err bitreich.org 70 i- be specified as a quoted-string value. Err bitreich.org 70 i- Err bitreich.org 70 i- No additional content value encoding (i.e., BACKSLASH character Err bitreich.org 70 i- encoding, see Section 3.3.11) is defined for this value type. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is a URI for a network file: Err bitreich.org 70 i- Err bitreich.org 70 i- http://example.com/my-report.txt Err bitreich.org 70 i- Err bitreich.org 70 i-3.3.14. UTC Offset Err bitreich.org 70 i- Err bitreich.org 70 i- Value Name: UTC-OFFSET Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This value type is used to identify properties that contain Err bitreich.org 70 i- an offset from UTC to local time. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This value type is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- utc-offset = time-numzone Err bitreich.org 70 i- Err bitreich.org 70 i- time-numzone = ("+" / "-") time-hour time-minute [time-second] Err bitreich.org 70 i- Err bitreich.org 70 i- Description: The PLUS SIGN character MUST be specified for positive Err bitreich.org 70 i- UTC offsets (i.e., ahead of UTC). The HYPHEN-MINUS character MUST Err bitreich.org 70 i- be specified for negative UTC offsets (i.e., behind of UTC). The Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 49] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- value of "-0000" and "-000000" are not allowed. The time-second, Err bitreich.org 70 i- if present, MUST NOT be 60; if absent, it defaults to zero. Err bitreich.org 70 i- Err bitreich.org 70 i- No additional content value encoding (i.e., BACKSLASH character Err bitreich.org 70 i- encoding, see Section 3.3.11) is defined for this value type. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following UTC offsets are given for standard time for Err bitreich.org 70 i- New York (five hours behind UTC) and Geneva (one hour ahead of Err bitreich.org 70 i- UTC): Err bitreich.org 70 i- Err bitreich.org 70 i- -0500 Err bitreich.org 70 i- Err bitreich.org 70 i- +0100 Err bitreich.org 70 i- Err bitreich.org 70 i-3.4. iCalendar Object Err bitreich.org 70 i- Err bitreich.org 70 i- The Calendaring and Scheduling Core Object is a collection of Err bitreich.org 70 i- calendaring and scheduling information. Typically, this information Err bitreich.org 70 i- will consist of an iCalendar stream with a single iCalendar object. Err bitreich.org 70 i- However, multiple iCalendar objects can be sequentially grouped Err bitreich.org 70 i- together in an iCalendar stream. The first line and last line of the Err bitreich.org 70 i- iCalendar object MUST contain a pair of iCalendar object delimiter Err bitreich.org 70 i- strings. The syntax for an iCalendar stream is as follows: Err bitreich.org 70 i- Err bitreich.org 70 i- icalstream = 1*icalobject Err bitreich.org 70 i- Err bitreich.org 70 i- icalobject = "BEGIN" ":" "VCALENDAR" CRLF Err bitreich.org 70 i- icalbody Err bitreich.org 70 i- "END" ":" "VCALENDAR" CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- The following is a simple example of an iCalendar object: Err bitreich.org 70 i- Err bitreich.org 70 i- BEGIN:VCALENDAR Err bitreich.org 70 i- VERSION:2.0 Err bitreich.org 70 i- PRODID:-//hacksw/handcal//NONSGML v1.0//EN Err bitreich.org 70 i- BEGIN:VEVENT Err bitreich.org 70 i- UID:19970610T172345Z-AF23B2@example.com Err bitreich.org 70 i- DTSTAMP:19970610T172345Z Err bitreich.org 70 i- DTSTART:19970714T170000Z Err bitreich.org 70 i- DTEND:19970715T040000Z Err bitreich.org 70 i- SUMMARY:Bastille Day Party Err bitreich.org 70 i- END:VEVENT Err bitreich.org 70 i- END:VCALENDAR Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 50] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-3.5. Property Err bitreich.org 70 i- Err bitreich.org 70 i- A property is the definition of an individual attribute describing a Err bitreich.org 70 i- calendar object or a calendar component. A property takes the form Err bitreich.org 70 i- defined by the "contentline" notation defined in Section 3.1. Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of a property: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART:19960415T133000Z Err bitreich.org 70 i- Err bitreich.org 70 i- This memo imposes no ordering of properties within an iCalendar Err bitreich.org 70 i- object. Err bitreich.org 70 i- Err bitreich.org 70 i- Property names, parameter names, and enumerated parameter values are Err bitreich.org 70 i- case-insensitive. For example, the property name "DUE" is the same Err bitreich.org 70 i- as "due" and "Due", DTSTART;TZID=America/New_York:19980714T120000 is Err bitreich.org 70 i- the same as DtStart;TzID=America/New_York:19980714T120000. Err bitreich.org 70 i- Err bitreich.org 70 i-3.6. Calendar Components Err bitreich.org 70 i- Err bitreich.org 70 i- The body of the iCalendar object consists of a sequence of calendar Err bitreich.org 70 i- properties and one or more calendar components. The calendar Err bitreich.org 70 i- properties are attributes that apply to the calendar object as a Err bitreich.org 70 i- whole. The calendar components are collections of properties that Err bitreich.org 70 i- express a particular calendar semantic. For example, the calendar Err bitreich.org 70 i- component can specify an event, a to-do, a journal entry, time zone Err bitreich.org 70 i- information, free/busy time information, or an alarm. Err bitreich.org 70 i- Err bitreich.org 70 i- The body of the iCalendar object is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- icalbody = calprops component Err bitreich.org 70 i- Err bitreich.org 70 i- calprops = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are REQUIRED, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- prodid / version / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- calscale / method / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 51] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- x-prop / iana-prop Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- component = 1*(eventc / todoc / journalc / freebusyc / Err bitreich.org 70 i- timezonec / iana-comp / x-comp) Err bitreich.org 70 i- Err bitreich.org 70 i- iana-comp = "BEGIN" ":" iana-token CRLF Err bitreich.org 70 i- 1*contentline Err bitreich.org 70 i- "END" ":" iana-token CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- x-comp = "BEGIN" ":" x-name CRLF Err bitreich.org 70 i- 1*contentline Err bitreich.org 70 i- "END" ":" x-name CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- An iCalendar object MUST include the "PRODID" and "VERSION" calendar Err bitreich.org 70 i- properties. In addition, it MUST include at least one calendar Err bitreich.org 70 i- component. Special forms of iCalendar objects are possible to Err bitreich.org 70 i- publish just busy time (i.e., only a "VFREEBUSY" calendar component) Err bitreich.org 70 i- or time zone (i.e., only a "VTIMEZONE" calendar component) Err bitreich.org 70 i- information. In addition, a complex iCalendar object that is used to Err bitreich.org 70 i- capture a complete snapshot of the contents of a calendar is possible Err bitreich.org 70 i- (e.g., composite of many different calendar components). More Err bitreich.org 70 i- commonly, an iCalendar object will consist of just a single "VEVENT", Err bitreich.org 70 i- "VTODO", or "VJOURNAL" calendar component. Applications MUST ignore Err bitreich.org 70 i- x-comp and iana-comp values they don't recognize. Applications that Err bitreich.org 70 i- support importing iCalendar objects SHOULD support all of the Err bitreich.org 70 i- component types defined in this document, and SHOULD NOT silently Err bitreich.org 70 i- drop any components as that can lead to user data loss. Err bitreich.org 70 i- Err bitreich.org 70 i-3.6.1. Event Component Err bitreich.org 70 i- Err bitreich.org 70 i- Component Name: VEVENT Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: Provide a grouping of component properties that describe an Err bitreich.org 70 i- event. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: A "VEVENT" calendar component is defined by the Err bitreich.org 70 i- following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- eventc = "BEGIN" ":" "VEVENT" CRLF Err bitreich.org 70 i- eventprop *alarmc Err bitreich.org 70 i- "END" ":" "VEVENT" CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- eventprop = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are REQUIRED, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 52] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- ; Err bitreich.org 70 i- dtstamp / uid / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is REQUIRED if the component Err bitreich.org 70 i- ; appears in an iCalendar object that doesn't Err bitreich.org 70 i- ; specify the "METHOD" property; otherwise, it Err bitreich.org 70 i- ; is OPTIONAL; in any case, it MUST NOT occur Err bitreich.org 70 i- ; more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- dtstart / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- class / created / description / geo / Err bitreich.org 70 i- last-mod / location / organizer / priority / Err bitreich.org 70 i- seq / status / summary / transp / Err bitreich.org 70 i- url / recurid / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; but SHOULD NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- rrule / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; Either 'dtend' or 'duration' MAY appear in Err bitreich.org 70 i- ; a 'eventprop', but 'dtend' and 'duration' Err bitreich.org 70 i- ; MUST NOT occur in the same 'eventprop'. Err bitreich.org 70 i- ; Err bitreich.org 70 i- dtend / duration / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- attach / attendee / categories / comment / Err bitreich.org 70 i- contact / exdate / rstatus / related / Err bitreich.org 70 i- resources / rdate / x-prop / iana-prop Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- Description: A "VEVENT" calendar component is a grouping of Err bitreich.org 70 i- component properties, possibly including "VALARM" calendar Err bitreich.org 70 i- components, that represents a scheduled amount of time on a Err bitreich.org 70 i- calendar. For example, it can be an activity; such as a one-hour Err bitreich.org 70 i- long, department meeting from 8:00 AM to 9:00 AM, tomorrow. Err bitreich.org 70 i- Generally, an event will take up time on an individual calendar. Err bitreich.org 70 i- Hence, the event will appear as an opaque interval in a search for Err bitreich.org 70 i- busy time. Alternately, the event can have its Time Transparency Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 53] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- set to "TRANSPARENT" in order to prevent blocking of the event in Err bitreich.org 70 i- searches for busy time. Err bitreich.org 70 i- Err bitreich.org 70 i- The "VEVENT" is also the calendar component used to specify an Err bitreich.org 70 i- anniversary or daily reminder within a calendar. These events Err bitreich.org 70 i- have a DATE value type for the "DTSTART" property instead of the Err bitreich.org 70 i- default value type of DATE-TIME. If such a "VEVENT" has a "DTEND" Err bitreich.org 70 i- property, it MUST be specified as a DATE value also. The Err bitreich.org 70 i- anniversary type of "VEVENT" can span more than one date (i.e., Err bitreich.org 70 i- "DTEND" property value is set to a calendar date after the Err bitreich.org 70 i- "DTSTART" property value). If such a "VEVENT" has a "DURATION" Err bitreich.org 70 i- property, it MUST be specified as a "dur-day" or "dur-week" value. Err bitreich.org 70 i- Err bitreich.org 70 i- The "DTSTART" property for a "VEVENT" specifies the inclusive Err bitreich.org 70 i- start of the event. For recurring events, it also specifies the Err bitreich.org 70 i- very first instance in the recurrence set. The "DTEND" property Err bitreich.org 70 i- for a "VEVENT" calendar component specifies the non-inclusive end Err bitreich.org 70 i- of the event. For cases where a "VEVENT" calendar component Err bitreich.org 70 i- specifies a "DTSTART" property with a DATE value type but no Err bitreich.org 70 i- "DTEND" nor "DURATION" property, the event's duration is taken to Err bitreich.org 70 i- be one day. For cases where a "VEVENT" calendar component Err bitreich.org 70 i- specifies a "DTSTART" property with a DATE-TIME value type but no Err bitreich.org 70 i- "DTEND" property, the event ends on the same calendar date and Err bitreich.org 70 i- time of day specified by the "DTSTART" property. Err bitreich.org 70 i- Err bitreich.org 70 i- The "VEVENT" calendar component cannot be nested within another Err bitreich.org 70 i- calendar component. However, "VEVENT" calendar components can be Err bitreich.org 70 i- related to each other or to a "VTODO" or to a "VJOURNAL" calendar Err bitreich.org 70 i- component with the "RELATED-TO" property. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of the "VEVENT" calendar Err bitreich.org 70 i- component used to represent a meeting that will also be opaque to Err bitreich.org 70 i- searches for busy time: Err bitreich.org 70 i- Err bitreich.org 70 i- BEGIN:VEVENT Err bitreich.org 70 i- UID:19970901T130000Z-123401@example.com Err bitreich.org 70 i- DTSTAMP:19970901T130000Z Err bitreich.org 70 i- DTSTART:19970903T163000Z Err bitreich.org 70 i- DTEND:19970903T190000Z Err bitreich.org 70 i- SUMMARY:Annual Employee Review Err bitreich.org 70 i- CLASS:PRIVATE Err bitreich.org 70 i- CATEGORIES:BUSINESS,HUMAN RESOURCES Err bitreich.org 70 i- END:VEVENT Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of the "VEVENT" calendar component Err bitreich.org 70 i- used to represent a reminder that will not be opaque, but rather Err bitreich.org 70 i- transparent, to searches for busy time: Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 54] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- BEGIN:VEVENT Err bitreich.org 70 i- UID:19970901T130000Z-123402@example.com Err bitreich.org 70 i- DTSTAMP:19970901T130000Z Err bitreich.org 70 i- DTSTART:19970401T163000Z Err bitreich.org 70 i- DTEND:19970402T010000Z Err bitreich.org 70 i- SUMMARY:Laurel is in sensitivity awareness class. Err bitreich.org 70 i- CLASS:PUBLIC Err bitreich.org 70 i- CATEGORIES:BUSINESS,HUMAN RESOURCES Err bitreich.org 70 i- TRANSP:TRANSPARENT Err bitreich.org 70 i- END:VEVENT Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of the "VEVENT" calendar component Err bitreich.org 70 i- used to represent an anniversary that will occur annually: Err bitreich.org 70 i- Err bitreich.org 70 i- BEGIN:VEVENT Err bitreich.org 70 i- UID:19970901T130000Z-123403@example.com Err bitreich.org 70 i- DTSTAMP:19970901T130000Z Err bitreich.org 70 i- DTSTART;VALUE=DATE:19971102 Err bitreich.org 70 i- SUMMARY:Our Blissful Anniversary Err bitreich.org 70 i- TRANSP:TRANSPARENT Err bitreich.org 70 i- CLASS:CONFIDENTIAL Err bitreich.org 70 i- CATEGORIES:ANNIVERSARY,PERSONAL,SPECIAL OCCASION Err bitreich.org 70 i- RRULE:FREQ=YEARLY Err bitreich.org 70 i- END:VEVENT Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of the "VEVENT" calendar component Err bitreich.org 70 i- used to represent a multi-day event scheduled from June 28th, 2007 Err bitreich.org 70 i- to July 8th, 2007 inclusively. Note that the "DTEND" property is Err bitreich.org 70 i- set to July 9th, 2007, since the "DTEND" property specifies the Err bitreich.org 70 i- non-inclusive end of the event. Err bitreich.org 70 i- Err bitreich.org 70 i- BEGIN:VEVENT Err bitreich.org 70 i- UID:20070423T123432Z-541111@example.com Err bitreich.org 70 i- DTSTAMP:20070423T123432Z Err bitreich.org 70 i- DTSTART;VALUE=DATE:20070628 Err bitreich.org 70 i- DTEND;VALUE=DATE:20070709 Err bitreich.org 70 i- SUMMARY:Festival International de Jazz de Montreal Err bitreich.org 70 i- TRANSP:TRANSPARENT Err bitreich.org 70 i- END:VEVENT Err bitreich.org 70 i- Err bitreich.org 70 i-3.6.2. To-Do Component Err bitreich.org 70 i- Err bitreich.org 70 i- Component Name: VTODO Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: Provide a grouping of calendar properties that describe a Err bitreich.org 70 i- to-do. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 55] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: A "VTODO" calendar component is defined by the Err bitreich.org 70 i- following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- todoc = "BEGIN" ":" "VTODO" CRLF Err bitreich.org 70 i- todoprop *alarmc Err bitreich.org 70 i- "END" ":" "VTODO" CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- todoprop = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are REQUIRED, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- dtstamp / uid / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- class / completed / created / description / Err bitreich.org 70 i- dtstart / geo / last-mod / location / organizer / Err bitreich.org 70 i- percent / priority / recurid / seq / status / Err bitreich.org 70 i- summary / url / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; but SHOULD NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- rrule / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; Either 'due' or 'duration' MAY appear in Err bitreich.org 70 i- ; a 'todoprop', but 'due' and 'duration' Err bitreich.org 70 i- ; MUST NOT occur in the same 'todoprop'. Err bitreich.org 70 i- ; If 'duration' appear in a 'todoprop', Err bitreich.org 70 i- ; then 'dtstart' MUST also appear in Err bitreich.org 70 i- ; the same 'todoprop'. Err bitreich.org 70 i- ; Err bitreich.org 70 i- due / duration / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- attach / attendee / categories / comment / contact / Err bitreich.org 70 i- exdate / rstatus / related / resources / Err bitreich.org 70 i- rdate / x-prop / iana-prop Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- Description: A "VTODO" calendar component is a grouping of component Err bitreich.org 70 i- properties and possibly "VALARM" calendar components that Err bitreich.org 70 i- represent an action-item or assignment. For example, it can be Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 56] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- used to represent an item of work assigned to an individual; such Err bitreich.org 70 i- as "turn in travel expense today". Err bitreich.org 70 i- Err bitreich.org 70 i- The "VTODO" calendar component cannot be nested within another Err bitreich.org 70 i- calendar component. However, "VTODO" calendar components can be Err bitreich.org 70 i- related to each other or to a "VEVENT" or to a "VJOURNAL" calendar Err bitreich.org 70 i- component with the "RELATED-TO" property. Err bitreich.org 70 i- Err bitreich.org 70 i- A "VTODO" calendar component without the "DTSTART" and "DUE" (or Err bitreich.org 70 i- "DURATION") properties specifies a to-do that will be associated Err bitreich.org 70 i- with each successive calendar date, until it is completed. Err bitreich.org 70 i- Err bitreich.org 70 i- Examples: The following is an example of a "VTODO" calendar Err bitreich.org 70 i- component that needs to be completed before May 1st, 2007. On Err bitreich.org 70 i- midnight May 1st, 2007 this to-do would be considered overdue. Err bitreich.org 70 i- Err bitreich.org 70 i- BEGIN:VTODO Err bitreich.org 70 i- UID:20070313T123432Z-456553@example.com Err bitreich.org 70 i- DTSTAMP:20070313T123432Z Err bitreich.org 70 i- DUE;VALUE=DATE:20070501 Err bitreich.org 70 i- SUMMARY:Submit Quebec Income Tax Return for 2006 Err bitreich.org 70 i- CLASS:CONFIDENTIAL Err bitreich.org 70 i- CATEGORIES:FAMILY,FINANCE Err bitreich.org 70 i- STATUS:NEEDS-ACTION Err bitreich.org 70 i- END:VTODO Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of a "VTODO" calendar component that Err bitreich.org 70 i- was due before 1:00 P.M. UTC on July 9th, 2007 and was completed Err bitreich.org 70 i- on July 7th, 2007 at 10:00 A.M. UTC. Err bitreich.org 70 i- Err bitreich.org 70 i- BEGIN:VTODO Err bitreich.org 70 i- UID:20070514T103211Z-123404@example.com Err bitreich.org 70 i- DTSTAMP:20070514T103211Z Err bitreich.org 70 i- DTSTART:20070514T110000Z Err bitreich.org 70 i- DUE:20070709T130000Z Err bitreich.org 70 i- COMPLETED:20070707T100000Z Err bitreich.org 70 i- SUMMARY:Submit Revised Internet-Draft Err bitreich.org 70 i- PRIORITY:1 Err bitreich.org 70 i- STATUS:NEEDS-ACTION Err bitreich.org 70 i- END:VTODO Err bitreich.org 70 i- Err bitreich.org 70 i-3.6.3. Journal Component Err bitreich.org 70 i- Err bitreich.org 70 i- Component Name: VJOURNAL Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: Provide a grouping of component properties that describe a Err bitreich.org 70 i- journal entry. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 57] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: A "VJOURNAL" calendar component is defined by the Err bitreich.org 70 i- following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- journalc = "BEGIN" ":" "VJOURNAL" CRLF Err bitreich.org 70 i- jourprop Err bitreich.org 70 i- "END" ":" "VJOURNAL" CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- jourprop = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are REQUIRED, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- dtstamp / uid / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- class / created / dtstart / Err bitreich.org 70 i- last-mod / organizer / recurid / seq / Err bitreich.org 70 i- status / summary / url / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; but SHOULD NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- rrule / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- attach / attendee / categories / comment / Err bitreich.org 70 i- contact / description / exdate / related / rdate / Err bitreich.org 70 i- rstatus / x-prop / iana-prop Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- Description: A "VJOURNAL" calendar component is a grouping of Err bitreich.org 70 i- component properties that represent one or more descriptive text Err bitreich.org 70 i- notes associated with a particular calendar date. The "DTSTART" Err bitreich.org 70 i- property is used to specify the calendar date with which the Err bitreich.org 70 i- journal entry is associated. Generally, it will have a DATE value Err bitreich.org 70 i- data type, but it can also be used to specify a DATE-TIME value Err bitreich.org 70 i- data type. Examples of a journal entry include a daily record of Err bitreich.org 70 i- a legislative body or a journal entry of individual telephone Err bitreich.org 70 i- contacts for the day or an ordered list of accomplishments for the Err bitreich.org 70 i- day. The "VJOURNAL" calendar component can also be used to Err bitreich.org 70 i- associate a document with a calendar date. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 58] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- The "VJOURNAL" calendar component does not take up time on a Err bitreich.org 70 i- calendar. Hence, it does not play a role in free or busy time Err bitreich.org 70 i- searches -- it is as though it has a time transparency value of Err bitreich.org 70 i- TRANSPARENT. It is transparent to any such searches. Err bitreich.org 70 i- Err bitreich.org 70 i- The "VJOURNAL" calendar component cannot be nested within another Err bitreich.org 70 i- calendar component. However, "VJOURNAL" calendar components can Err bitreich.org 70 i- be related to each other or to a "VEVENT" or to a "VTODO" calendar Err bitreich.org 70 i- component, with the "RELATED-TO" property. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of the "VJOURNAL" calendar Err bitreich.org 70 i- component: Err bitreich.org 70 i- Err bitreich.org 70 i- BEGIN:VJOURNAL Err bitreich.org 70 i- UID:19970901T130000Z-123405@example.com Err bitreich.org 70 i- DTSTAMP:19970901T130000Z Err bitreich.org 70 i- DTSTART;VALUE=DATE:19970317 Err bitreich.org 70 i- SUMMARY:Staff meeting minutes Err bitreich.org 70 i- DESCRIPTION:1. Staff meeting: Participants include Joe\, Err bitreich.org 70 i- Lisa\, and Bob. Aurora project plans were reviewed. Err bitreich.org 70 i- There is currently no budget reserves for this project. Err bitreich.org 70 i- Lisa will escalate to management. Next meeting on Tuesday.\n Err bitreich.org 70 i- 2. Telephone Conference: ABC Corp. sales representative Err bitreich.org 70 i- called to discuss new printer. Promised to get us a demo by Err bitreich.org 70 i- Friday.\n3. Henry Miller (Handsoff Insurance): Car was Err bitreich.org 70 i- totaled by tree. Is looking into a loaner car. 555-2323 Err bitreich.org 70 i- (tel). Err bitreich.org 70 i- END:VJOURNAL Err bitreich.org 70 i- Err bitreich.org 70 i-3.6.4. Free/Busy Component Err bitreich.org 70 i- Err bitreich.org 70 i- Component Name: VFREEBUSY Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: Provide a grouping of component properties that describe Err bitreich.org 70 i- either a request for free/busy time, describe a response to a Err bitreich.org 70 i- request for free/busy time, or describe a published set of busy Err bitreich.org 70 i- time. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: A "VFREEBUSY" calendar component is defined by Err bitreich.org 70 i- the following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- freebusyc = "BEGIN" ":" "VFREEBUSY" CRLF Err bitreich.org 70 i- fbprop Err bitreich.org 70 i- "END" ":" "VFREEBUSY" CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- fbprop = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are REQUIRED, Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 59] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- dtstamp / uid / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- contact / dtstart / dtend / Err bitreich.org 70 i- organizer / url / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- attendee / comment / freebusy / rstatus / x-prop / Err bitreich.org 70 i- iana-prop Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- Description: A "VFREEBUSY" calendar component is a grouping of Err bitreich.org 70 i- component properties that represents either a request for free or Err bitreich.org 70 i- busy time information, a reply to a request for free or busy time Err bitreich.org 70 i- information, or a published set of busy time information. Err bitreich.org 70 i- Err bitreich.org 70 i- When used to request free/busy time information, the "ATTENDEE" Err bitreich.org 70 i- property specifies the calendar users whose free/busy time is Err bitreich.org 70 i- being requested; the "ORGANIZER" property specifies the calendar Err bitreich.org 70 i- user who is requesting the free/busy time; the "DTSTART" and Err bitreich.org 70 i- "DTEND" properties specify the window of time for which the free/ Err bitreich.org 70 i- busy time is being requested; the "UID" and "DTSTAMP" properties Err bitreich.org 70 i- are specified to assist in proper sequencing of multiple free/busy Err bitreich.org 70 i- time requests. Err bitreich.org 70 i- Err bitreich.org 70 i- When used to reply to a request for free/busy time, the "ATTENDEE" Err bitreich.org 70 i- property specifies the calendar user responding to the free/busy Err bitreich.org 70 i- time request; the "ORGANIZER" property specifies the calendar user Err bitreich.org 70 i- that originally requested the free/busy time; the "FREEBUSY" Err bitreich.org 70 i- property specifies the free/busy time information (if it exists); Err bitreich.org 70 i- and the "UID" and "DTSTAMP" properties are specified to assist in Err bitreich.org 70 i- proper sequencing of multiple free/busy time replies. Err bitreich.org 70 i- Err bitreich.org 70 i- When used to publish busy time, the "ORGANIZER" property specifies Err bitreich.org 70 i- the calendar user associated with the published busy time; the Err bitreich.org 70 i- "DTSTART" and "DTEND" properties specify an inclusive time window Err bitreich.org 70 i- that surrounds the busy time information; the "FREEBUSY" property Err bitreich.org 70 i- specifies the published busy time information; and the "DTSTAMP" Err bitreich.org 70 i- property specifies the DATE-TIME that iCalendar object was Err bitreich.org 70 i- created. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 60] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- The "VFREEBUSY" calendar component cannot be nested within another Err bitreich.org 70 i- calendar component. Multiple "VFREEBUSY" calendar components can Err bitreich.org 70 i- be specified within an iCalendar object. This permits the Err bitreich.org 70 i- grouping of free/busy information into logical collections, such Err bitreich.org 70 i- as monthly groups of busy time information. Err bitreich.org 70 i- Err bitreich.org 70 i- The "VFREEBUSY" calendar component is intended for use in Err bitreich.org 70 i- iCalendar object methods involving requests for free time, Err bitreich.org 70 i- requests for busy time, requests for both free and busy, and the Err bitreich.org 70 i- associated replies. Err bitreich.org 70 i- Err bitreich.org 70 i- Free/Busy information is represented with the "FREEBUSY" property. Err bitreich.org 70 i- This property provides a terse representation of time periods. Err bitreich.org 70 i- One or more "FREEBUSY" properties can be specified in the Err bitreich.org 70 i- "VFREEBUSY" calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- When present in a "VFREEBUSY" calendar component, the "DTSTART" Err bitreich.org 70 i- and "DTEND" properties SHOULD be specified prior to any "FREEBUSY" Err bitreich.org 70 i- properties. Err bitreich.org 70 i- Err bitreich.org 70 i- The recurrence properties ("RRULE", "RDATE", "EXDATE") are not Err bitreich.org 70 i- permitted within a "VFREEBUSY" calendar component. Any recurring Err bitreich.org 70 i- events are resolved into their individual busy time periods using Err bitreich.org 70 i- the "FREEBUSY" property. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of a "VFREEBUSY" calendar Err bitreich.org 70 i- component used to request free or busy time information: Err bitreich.org 70 i- Err bitreich.org 70 i- BEGIN:VFREEBUSY Err bitreich.org 70 i- UID:19970901T082949Z-FA43EF@example.com Err bitreich.org 70 i- ORGANIZER:mailto:jane_doe@example.com Err bitreich.org 70 i- ATTENDEE:mailto:john_public@example.com Err bitreich.org 70 i- DTSTART:19971015T050000Z Err bitreich.org 70 i- DTEND:19971016T050000Z Err bitreich.org 70 i- DTSTAMP:19970901T083000Z Err bitreich.org 70 i- END:VFREEBUSY Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 61] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of a "VFREEBUSY" calendar component Err bitreich.org 70 i- used to reply to the request with busy time information: Err bitreich.org 70 i- Err bitreich.org 70 i- BEGIN:VFREEBUSY Err bitreich.org 70 i- UID:19970901T095957Z-76A912@example.com Err bitreich.org 70 i- ORGANIZER:mailto:jane_doe@example.com Err bitreich.org 70 i- ATTENDEE:mailto:john_public@example.com Err bitreich.org 70 i- DTSTAMP:19970901T100000Z Err bitreich.org 70 i- FREEBUSY:19971015T050000Z/PT8H30M, Err bitreich.org 70 i- 19971015T160000Z/PT5H30M,19971015T223000Z/PT6H30M Err bitreich.org 70 i- URL:http://example.com/pub/busy/jpublic-01.ifb Err bitreich.org 70 i- COMMENT:This iCalendar file contains busy time information for Err bitreich.org 70 i- the next three months. Err bitreich.org 70 i- END:VFREEBUSY Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of a "VFREEBUSY" calendar component Err bitreich.org 70 i- used to publish busy time information: Err bitreich.org 70 i- Err bitreich.org 70 i- BEGIN:VFREEBUSY Err bitreich.org 70 i- UID:19970901T115957Z-76A912@example.com Err bitreich.org 70 i- DTSTAMP:19970901T120000Z Err bitreich.org 70 i- ORGANIZER:jsmith@example.com Err bitreich.org 70 i- DTSTART:19980313T141711Z Err bitreich.org 70 i- DTEND:19980410T141711Z Err bitreich.org 70 i- FREEBUSY:19980314T233000Z/19980315T003000Z Err bitreich.org 70 i- FREEBUSY:19980316T153000Z/19980316T163000Z Err bitreich.org 70 i- FREEBUSY:19980318T030000Z/19980318T040000Z Err bitreich.org 70 i- URL:http://www.example.com/calendar/busytime/jsmith.ifb Err bitreich.org 70 i- END:VFREEBUSY Err bitreich.org 70 i- Err bitreich.org 70 i-3.6.5. Time Zone Component Err bitreich.org 70 i- Err bitreich.org 70 i- Component Name: VTIMEZONE Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: Provide a grouping of component properties that defines a Err bitreich.org 70 i- time zone. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: A "VTIMEZONE" calendar component is defined by Err bitreich.org 70 i- the following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- timezonec = "BEGIN" ":" "VTIMEZONE" CRLF Err bitreich.org 70 i- *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; 'tzid' is REQUIRED, but MUST NOT occur more Err bitreich.org 70 i- ; than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- tzid / Err bitreich.org 70 i- ; Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 62] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- ; 'last-mod' and 'tzurl' are OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- last-mod / tzurl / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; One of 'standardc' or 'daylightc' MUST occur Err bitreich.org 70 i- ; and each MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- standardc / daylightc / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- x-prop / iana-prop Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- "END" ":" "VTIMEZONE" CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- standardc = "BEGIN" ":" "STANDARD" CRLF Err bitreich.org 70 i- tzprop Err bitreich.org 70 i- "END" ":" "STANDARD" CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- daylightc = "BEGIN" ":" "DAYLIGHT" CRLF Err bitreich.org 70 i- tzprop Err bitreich.org 70 i- "END" ":" "DAYLIGHT" CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- tzprop = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are REQUIRED, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- dtstart / tzoffsetto / tzoffsetfrom / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; but SHOULD NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- rrule / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- comment / rdate / tzname / x-prop / iana-prop Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- Description: A time zone is unambiguously defined by the set of time Err bitreich.org 70 i- measurement rules determined by the governing body for a given Err bitreich.org 70 i- geographic area. These rules describe, at a minimum, the base Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 63] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- offset from UTC for the time zone, often referred to as the Err bitreich.org 70 i- Standard Time offset. Many locations adjust their Standard Time Err bitreich.org 70 i- forward or backward by one hour, in order to accommodate seasonal Err bitreich.org 70 i- changes in number of daylight hours, often referred to as Daylight Err bitreich.org 70 i- Saving Time. Some locations adjust their time by a fraction of an Err bitreich.org 70 i- hour. Standard Time is also known as Winter Time. Daylight Err bitreich.org 70 i- Saving Time is also known as Advanced Time, Summer Time, or Legal Err bitreich.org 70 i- Time in certain countries. The following table shows the changes Err bitreich.org 70 i- in time zone rules in effect for New York City starting from 1967. Err bitreich.org 70 i- Each line represents a description or rule for a particular Err bitreich.org 70 i- observance. Err bitreich.org 70 i- Err bitreich.org 70 i- Effective Observance Rule Err bitreich.org 70 i- Err bitreich.org 70 i- +-----------+--------------------------+--------+--------------+ Err bitreich.org 70 i- | Date | (Date-Time) | Offset | Abbreviation | Err bitreich.org 70 i- +-----------+--------------------------+--------+--------------+ Err bitreich.org 70 i- | 1967-1973 | last Sun in Apr, 02:00 | -0400 | EDT | Err bitreich.org 70 i- | | | | | Err bitreich.org 70 i- | 1967-2006 | last Sun in Oct, 02:00 | -0500 | EST | Err bitreich.org 70 i- | | | | | Err bitreich.org 70 i- | 1974-1974 | Jan 6, 02:00 | -0400 | EDT | Err bitreich.org 70 i- | | | | | Err bitreich.org 70 i- | 1975-1975 | Feb 23, 02:00 | -0400 | EDT | Err bitreich.org 70 i- | | | | | Err bitreich.org 70 i- | 1976-1986 | last Sun in Apr, 02:00 | -0400 | EDT | Err bitreich.org 70 i- | | | | | Err bitreich.org 70 i- | 1987-2006 | first Sun in Apr, 02:00 | -0400 | EDT | Err bitreich.org 70 i- | | | | | Err bitreich.org 70 i- | 2007-* | second Sun in Mar, 02:00 | -0400 | EDT | Err bitreich.org 70 i- | | | | | Err bitreich.org 70 i- | 2007-* | first Sun in Nov, 02:00 | -0500 | EST | Err bitreich.org 70 i- +-----------+--------------------------+--------+--------------+ Err bitreich.org 70 i- Err bitreich.org 70 i- Note: The specification of a global time zone registry is not Err bitreich.org 70 i- addressed by this document and is left for future study. Err bitreich.org 70 i- However, implementers may find the TZ database [TZDB] a useful Err bitreich.org 70 i- reference. It is an informal, public-domain collection of time Err bitreich.org 70 i- zone information, which is currently being maintained by Err bitreich.org 70 i- volunteer Internet participants, and is used in several Err bitreich.org 70 i- operating systems. This database contains current and Err bitreich.org 70 i- historical time zone information for a wide variety of Err bitreich.org 70 i- locations around the globe; it provides a time zone identifier Err bitreich.org 70 i- for every unique time zone rule set in actual use since 1970, Err bitreich.org 70 i- with historical data going back to the introduction of standard Err bitreich.org 70 i- time. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 64] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Interoperability between two calendaring and scheduling Err bitreich.org 70 i- applications, especially for recurring events, to-dos or journal Err bitreich.org 70 i- entries, is dependent on the ability to capture and convey date Err bitreich.org 70 i- and time information in an unambiguous format. The specification Err bitreich.org 70 i- of current time zone information is integral to this behavior. Err bitreich.org 70 i- Err bitreich.org 70 i- If present, the "VTIMEZONE" calendar component defines the set of Err bitreich.org 70 i- Standard Time and Daylight Saving Time observances (or rules) for Err bitreich.org 70 i- a particular time zone for a given interval of time. The Err bitreich.org 70 i- "VTIMEZONE" calendar component cannot be nested within other Err bitreich.org 70 i- calendar components. Multiple "VTIMEZONE" calendar components can Err bitreich.org 70 i- exist in an iCalendar object. In this situation, each "VTIMEZONE" Err bitreich.org 70 i- MUST represent a unique time zone definition. This is necessary Err bitreich.org 70 i- for some classes of events, such as airline flights, that start in Err bitreich.org 70 i- one time zone and end in another. Err bitreich.org 70 i- Err bitreich.org 70 i- The "VTIMEZONE" calendar component MUST include the "TZID" Err bitreich.org 70 i- property and at least one definition of a "STANDARD" or "DAYLIGHT" Err bitreich.org 70 i- sub-component. The "STANDARD" or "DAYLIGHT" sub-component MUST Err bitreich.org 70 i- include the "DTSTART", "TZOFFSETFROM", and "TZOFFSETTO" Err bitreich.org 70 i- properties. Err bitreich.org 70 i- Err bitreich.org 70 i- An individual "VTIMEZONE" calendar component MUST be specified for Err bitreich.org 70 i- each unique "TZID" parameter value specified in the iCalendar Err bitreich.org 70 i- object. In addition, a "VTIMEZONE" calendar component, referred Err bitreich.org 70 i- to by a recurring calendar component, MUST provide valid time zone Err bitreich.org 70 i- information for all recurrence instances. Err bitreich.org 70 i- Err bitreich.org 70 i- Each "VTIMEZONE" calendar component consists of a collection of Err bitreich.org 70 i- one or more sub-components that describe the rule for a particular Err bitreich.org 70 i- observance (either a Standard Time or a Daylight Saving Time Err bitreich.org 70 i- observance). The "STANDARD" sub-component consists of a Err bitreich.org 70 i- collection of properties that describe Standard Time. The Err bitreich.org 70 i- "DAYLIGHT" sub-component consists of a collection of properties Err bitreich.org 70 i- that describe Daylight Saving Time. In general, this collection Err bitreich.org 70 i- of properties consists of: Err bitreich.org 70 i- Err bitreich.org 70 i- * the first onset DATE-TIME for the observance; Err bitreich.org 70 i- Err bitreich.org 70 i- * the last onset DATE-TIME for the observance, if a last onset is Err bitreich.org 70 i- known; Err bitreich.org 70 i- Err bitreich.org 70 i- * the offset to be applied for the observance; Err bitreich.org 70 i- Err bitreich.org 70 i- * a rule that describes the day and time when the observance Err bitreich.org 70 i- takes effect; Err bitreich.org 70 i- Err bitreich.org 70 i- * an optional name for the observance. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 65] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- For a given time zone, there may be multiple unique definitions of Err bitreich.org 70 i- the observances over a period of time. Each observance is Err bitreich.org 70 i- described using either a "STANDARD" or "DAYLIGHT" sub-component. Err bitreich.org 70 i- The collection of these sub-components is used to describe the Err bitreich.org 70 i- time zone for a given period of time. The offset to apply at any Err bitreich.org 70 i- given time is found by locating the observance that has the last Err bitreich.org 70 i- onset date and time before the time in question, and using the Err bitreich.org 70 i- offset value from that observance. Err bitreich.org 70 i- Err bitreich.org 70 i- The top-level properties in a "VTIMEZONE" calendar component are: Err bitreich.org 70 i- Err bitreich.org 70 i- The mandatory "TZID" property is a text value that uniquely Err bitreich.org 70 i- identifies the "VTIMEZONE" calendar component within the scope of Err bitreich.org 70 i- an iCalendar object. Err bitreich.org 70 i- Err bitreich.org 70 i- The optional "LAST-MODIFIED" property is a UTC value that Err bitreich.org 70 i- specifies the date and time that this time zone definition was Err bitreich.org 70 i- last updated. Err bitreich.org 70 i- Err bitreich.org 70 i- The optional "TZURL" property is a url value that points to a Err bitreich.org 70 i- published "VTIMEZONE" definition. "TZURL" SHOULD refer to a Err bitreich.org 70 i- resource that is accessible by anyone who might need to interpret Err bitreich.org 70 i- the object. This SHOULD NOT normally be a "file" URL or other URL Err bitreich.org 70 i- that is not widely accessible. Err bitreich.org 70 i- Err bitreich.org 70 i- The collection of properties that are used to define the Err bitreich.org 70 i- "STANDARD" and "DAYLIGHT" sub-components include: Err bitreich.org 70 i- Err bitreich.org 70 i- The mandatory "DTSTART" property gives the effective onset date Err bitreich.org 70 i- and local time for the time zone sub-component definition. Err bitreich.org 70 i- "DTSTART" in this usage MUST be specified as a date with a local Err bitreich.org 70 i- time value. Err bitreich.org 70 i- Err bitreich.org 70 i- The mandatory "TZOFFSETFROM" property gives the UTC offset that is Err bitreich.org 70 i- in use when the onset of this time zone observance begins. Err bitreich.org 70 i- "TZOFFSETFROM" is combined with "DTSTART" to define the effective Err bitreich.org 70 i- onset for the time zone sub-component definition. For example, Err bitreich.org 70 i- the following represents the time at which the observance of Err bitreich.org 70 i- Standard Time took effect in Fall 1967 for New York City: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART:19671029T020000 Err bitreich.org 70 i- Err bitreich.org 70 i- TZOFFSETFROM:-0400 Err bitreich.org 70 i- Err bitreich.org 70 i- The mandatory "TZOFFSETTO" property gives the UTC offset for the Err bitreich.org 70 i- time zone sub-component (Standard Time or Daylight Saving Time) Err bitreich.org 70 i- when this observance is in use. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 66] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- The optional "TZNAME" property is the customary name for the time Err bitreich.org 70 i- zone. This could be used for displaying dates. Err bitreich.org 70 i- Err bitreich.org 70 i- The onset DATE-TIME values for the observance defined by the time Err bitreich.org 70 i- zone sub-component is defined by the "DTSTART", "RRULE", and Err bitreich.org 70 i- "RDATE" properties. Err bitreich.org 70 i- Err bitreich.org 70 i- The "RRULE" property defines the recurrence rule for the onset of Err bitreich.org 70 i- the observance defined by this time zone sub-component. Some Err bitreich.org 70 i- specific requirements for the usage of "RRULE" for this purpose Err bitreich.org 70 i- include: Err bitreich.org 70 i- Err bitreich.org 70 i- * If observance is known to have an effective end date, the Err bitreich.org 70 i- "UNTIL" recurrence rule parameter MUST be used to specify the Err bitreich.org 70 i- last valid onset of this observance (i.e., the UNTIL DATE-TIME Err bitreich.org 70 i- will be equal to the last instance generated by the recurrence Err bitreich.org 70 i- pattern). It MUST be specified in UTC time. Err bitreich.org 70 i- Err bitreich.org 70 i- * The "DTSTART" and the "TZOFFSETFROM" properties MUST be used Err bitreich.org 70 i- when generating the onset DATE-TIME values (instances) from the Err bitreich.org 70 i- "RRULE". Err bitreich.org 70 i- Err bitreich.org 70 i- The "RDATE" property can also be used to define the onset of the Err bitreich.org 70 i- observance by giving the individual onset date and times. "RDATE" Err bitreich.org 70 i- in this usage MUST be specified as a date with local time value, Err bitreich.org 70 i- relative to the UTC offset specified in the "TZOFFSETFROM" Err bitreich.org 70 i- property. Err bitreich.org 70 i- Err bitreich.org 70 i- The optional "COMMENT" property is also allowed for descriptive Err bitreich.org 70 i- explanatory text. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following are examples of the "VTIMEZONE" calendar Err bitreich.org 70 i- component: Err bitreich.org 70 i- Err bitreich.org 70 i- This is an example showing all the time zone rules for New York Err bitreich.org 70 i- City since April 30, 1967 at 03:00:00 EDT. Err bitreich.org 70 i- Err bitreich.org 70 i- BEGIN:VTIMEZONE Err bitreich.org 70 i- TZID:America/New_York Err bitreich.org 70 i- LAST-MODIFIED:20050809T050000Z Err bitreich.org 70 i- BEGIN:DAYLIGHT Err bitreich.org 70 i- DTSTART:19670430T020000 Err bitreich.org 70 i- RRULE:FREQ=YEARLY;BYMONTH=4;BYDAY=-1SU;UNTIL=19730429T070000Z Err bitreich.org 70 i- TZOFFSETFROM:-0500 Err bitreich.org 70 i- TZOFFSETTO:-0400 Err bitreich.org 70 i- TZNAME:EDT Err bitreich.org 70 i- END:DAYLIGHT Err bitreich.org 70 i- BEGIN:STANDARD Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 67] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART:19671029T020000 Err bitreich.org 70 i- RRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=-1SU;UNTIL=20061029T060000Z Err bitreich.org 70 i- TZOFFSETFROM:-0400 Err bitreich.org 70 i- TZOFFSETTO:-0500 Err bitreich.org 70 i- TZNAME:EST Err bitreich.org 70 i- END:STANDARD Err bitreich.org 70 i- BEGIN:DAYLIGHT Err bitreich.org 70 i- DTSTART:19740106T020000 Err bitreich.org 70 i- RDATE:19750223T020000 Err bitreich.org 70 i- TZOFFSETFROM:-0500 Err bitreich.org 70 i- TZOFFSETTO:-0400 Err bitreich.org 70 i- TZNAME:EDT Err bitreich.org 70 i- END:DAYLIGHT Err bitreich.org 70 i- BEGIN:DAYLIGHT Err bitreich.org 70 i- DTSTART:19760425T020000 Err bitreich.org 70 i- RRULE:FREQ=YEARLY;BYMONTH=4;BYDAY=-1SU;UNTIL=19860427T070000Z Err bitreich.org 70 i- TZOFFSETFROM:-0500 Err bitreich.org 70 i- TZOFFSETTO:-0400 Err bitreich.org 70 i- TZNAME:EDT Err bitreich.org 70 i- END:DAYLIGHT Err bitreich.org 70 i- BEGIN:DAYLIGHT Err bitreich.org 70 i- DTSTART:19870405T020000 Err bitreich.org 70 i- RRULE:FREQ=YEARLY;BYMONTH=4;BYDAY=1SU;UNTIL=20060402T070000Z Err bitreich.org 70 i- TZOFFSETFROM:-0500 Err bitreich.org 70 i- TZOFFSETTO:-0400 Err bitreich.org 70 i- TZNAME:EDT Err bitreich.org 70 i- END:DAYLIGHT Err bitreich.org 70 i- BEGIN:DAYLIGHT Err bitreich.org 70 i- DTSTART:20070311T020000 Err bitreich.org 70 i- RRULE:FREQ=YEARLY;BYMONTH=3;BYDAY=2SU Err bitreich.org 70 i- TZOFFSETFROM:-0500 Err bitreich.org 70 i- TZOFFSETTO:-0400 Err bitreich.org 70 i- TZNAME:EDT Err bitreich.org 70 i- END:DAYLIGHT Err bitreich.org 70 i- BEGIN:STANDARD Err bitreich.org 70 i- DTSTART:20071104T020000 Err bitreich.org 70 i- RRULE:FREQ=YEARLY;BYMONTH=11;BYDAY=1SU Err bitreich.org 70 i- TZOFFSETFROM:-0400 Err bitreich.org 70 i- TZOFFSETTO:-0500 Err bitreich.org 70 i- TZNAME:EST Err bitreich.org 70 i- END:STANDARD Err bitreich.org 70 i- END:VTIMEZONE Err bitreich.org 70 i- Err bitreich.org 70 i- This is an example showing time zone information for New York City Err bitreich.org 70 i- using only the "DTSTART" property. Note that this is only Err bitreich.org 70 i- suitable for a recurring event that starts on or later than March Err bitreich.org 70 i- 11, 2007 at 03:00:00 EDT (i.e., the earliest effective transition Err bitreich.org 70 i- date and time) and ends no later than March 9, 2008 at 01:59:59 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 68] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- EST (i.e., latest valid date and time for EST in this scenario). Err bitreich.org 70 i- For example, this can be used for a recurring event that occurs Err bitreich.org 70 i- every Friday, 8:00 A.M.-9:00 A.M., starting June 1, 2007, ending Err bitreich.org 70 i- December 31, 2007, Err bitreich.org 70 i- Err bitreich.org 70 i- BEGIN:VTIMEZONE Err bitreich.org 70 i- TZID:America/New_York Err bitreich.org 70 i- LAST-MODIFIED:20050809T050000Z Err bitreich.org 70 i- BEGIN:STANDARD Err bitreich.org 70 i- DTSTART:20071104T020000 Err bitreich.org 70 i- TZOFFSETFROM:-0400 Err bitreich.org 70 i- TZOFFSETTO:-0500 Err bitreich.org 70 i- TZNAME:EST Err bitreich.org 70 i- END:STANDARD Err bitreich.org 70 i- BEGIN:DAYLIGHT Err bitreich.org 70 i- DTSTART:20070311T020000 Err bitreich.org 70 i- TZOFFSETFROM:-0500 Err bitreich.org 70 i- TZOFFSETTO:-0400 Err bitreich.org 70 i- TZNAME:EDT Err bitreich.org 70 i- END:DAYLIGHT Err bitreich.org 70 i- END:VTIMEZONE Err bitreich.org 70 i- Err bitreich.org 70 i- This is a simple example showing the current time zone rules for Err bitreich.org 70 i- New York City using a "RRULE" recurrence pattern. Note that there Err bitreich.org 70 i- is no effective end date to either of the Standard Time or Err bitreich.org 70 i- Daylight Time rules. This information would be valid for a Err bitreich.org 70 i- recurring event starting today and continuing indefinitely. Err bitreich.org 70 i- Err bitreich.org 70 i- BEGIN:VTIMEZONE Err bitreich.org 70 i- TZID:America/New_York Err bitreich.org 70 i- LAST-MODIFIED:20050809T050000Z Err bitreich.org 70 i- TZURL:http://zones.example.com/tz/America-New_York.ics Err bitreich.org 70 i- BEGIN:STANDARD Err bitreich.org 70 i- DTSTART:20071104T020000 Err bitreich.org 70 i- RRULE:FREQ=YEARLY;BYMONTH=11;BYDAY=1SU Err bitreich.org 70 i- TZOFFSETFROM:-0400 Err bitreich.org 70 i- TZOFFSETTO:-0500 Err bitreich.org 70 i- TZNAME:EST Err bitreich.org 70 i- END:STANDARD Err bitreich.org 70 i- BEGIN:DAYLIGHT Err bitreich.org 70 i- DTSTART:20070311T020000 Err bitreich.org 70 i- RRULE:FREQ=YEARLY;BYMONTH=3;BYDAY=2SU Err bitreich.org 70 i- TZOFFSETFROM:-0500 Err bitreich.org 70 i- TZOFFSETTO:-0400 Err bitreich.org 70 i- TZNAME:EDT Err bitreich.org 70 i- END:DAYLIGHT Err bitreich.org 70 i- END:VTIMEZONE Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 69] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- This is an example showing a set of rules for a fictitious time Err bitreich.org 70 i- zone where the Daylight Time rule has an effective end date (i.e., Err bitreich.org 70 i- after that date, Daylight Time is no longer observed). Err bitreich.org 70 i- Err bitreich.org 70 i- BEGIN:VTIMEZONE Err bitreich.org 70 i- TZID:Fictitious Err bitreich.org 70 i- LAST-MODIFIED:19870101T000000Z Err bitreich.org 70 i- BEGIN:STANDARD Err bitreich.org 70 i- DTSTART:19671029T020000 Err bitreich.org 70 i- RRULE:FREQ=YEARLY;BYDAY=-1SU;BYMONTH=10 Err bitreich.org 70 i- TZOFFSETFROM:-0400 Err bitreich.org 70 i- TZOFFSETTO:-0500 Err bitreich.org 70 i- TZNAME:EST Err bitreich.org 70 i- END:STANDARD Err bitreich.org 70 i- BEGIN:DAYLIGHT Err bitreich.org 70 i- DTSTART:19870405T020000 Err bitreich.org 70 i- RRULE:FREQ=YEARLY;BYDAY=1SU;BYMONTH=4;UNTIL=19980404T070000Z Err bitreich.org 70 i- TZOFFSETFROM:-0500 Err bitreich.org 70 i- TZOFFSETTO:-0400 Err bitreich.org 70 i- TZNAME:EDT Err bitreich.org 70 i- END:DAYLIGHT Err bitreich.org 70 i- END:VTIMEZONE Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 70] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- This is an example showing a set of rules for a fictitious time Err bitreich.org 70 i- zone where the first Daylight Time rule has an effective end date. Err bitreich.org 70 i- There is a second Daylight Time rule that picks up where the other Err bitreich.org 70 i- left off. Err bitreich.org 70 i- Err bitreich.org 70 i- BEGIN:VTIMEZONE Err bitreich.org 70 i- TZID:Fictitious Err bitreich.org 70 i- LAST-MODIFIED:19870101T000000Z Err bitreich.org 70 i- BEGIN:STANDARD Err bitreich.org 70 i- DTSTART:19671029T020000 Err bitreich.org 70 i- RRULE:FREQ=YEARLY;BYDAY=-1SU;BYMONTH=10 Err bitreich.org 70 i- TZOFFSETFROM:-0400 Err bitreich.org 70 i- TZOFFSETTO:-0500 Err bitreich.org 70 i- TZNAME:EST Err bitreich.org 70 i- END:STANDARD Err bitreich.org 70 i- BEGIN:DAYLIGHT Err bitreich.org 70 i- DTSTART:19870405T020000 Err bitreich.org 70 i- RRULE:FREQ=YEARLY;BYDAY=1SU;BYMONTH=4;UNTIL=19980404T070000Z Err bitreich.org 70 i- TZOFFSETFROM:-0500 Err bitreich.org 70 i- TZOFFSETTO:-0400 Err bitreich.org 70 i- TZNAME:EDT Err bitreich.org 70 i- END:DAYLIGHT Err bitreich.org 70 i- BEGIN:DAYLIGHT Err bitreich.org 70 i- DTSTART:19990424T020000 Err bitreich.org 70 i- RRULE:FREQ=YEARLY;BYDAY=-1SU;BYMONTH=4 Err bitreich.org 70 i- TZOFFSETFROM:-0500 Err bitreich.org 70 i- TZOFFSETTO:-0400 Err bitreich.org 70 i- TZNAME:EDT Err bitreich.org 70 i- END:DAYLIGHT Err bitreich.org 70 i- END:VTIMEZONE Err bitreich.org 70 i- Err bitreich.org 70 i-3.6.6. Alarm Component Err bitreich.org 70 i- Err bitreich.org 70 i- Component Name: VALARM Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: Provide a grouping of component properties that define an Err bitreich.org 70 i- alarm. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: A "VALARM" calendar component is defined by the Err bitreich.org 70 i- following notation: Err bitreich.org 70 i- Err bitreich.org 70 i- alarmc = "BEGIN" ":" "VALARM" CRLF Err bitreich.org 70 i- (audioprop / dispprop / emailprop) Err bitreich.org 70 i- "END" ":" "VALARM" CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- audioprop = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; 'action' and 'trigger' are both REQUIRED, Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 71] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- action / trigger / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; 'duration' and 'repeat' are both OPTIONAL, Err bitreich.org 70 i- ; and MUST NOT occur more than once each; Err bitreich.org 70 i- ; but if one occurs, so MUST the other. Err bitreich.org 70 i- ; Err bitreich.org 70 i- duration / repeat / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- attach / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- x-prop / iana-prop Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- dispprop = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are REQUIRED, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- action / description / trigger / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; 'duration' and 'repeat' are both OPTIONAL, Err bitreich.org 70 i- ; and MUST NOT occur more than once each; Err bitreich.org 70 i- ; but if one occurs, so MUST the other. Err bitreich.org 70 i- ; Err bitreich.org 70 i- duration / repeat / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- x-prop / iana-prop Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- emailprop = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are all REQUIRED, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- action / description / trigger / summary / Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 72] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is REQUIRED, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- attendee / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; 'duration' and 'repeat' are both OPTIONAL, Err bitreich.org 70 i- ; and MUST NOT occur more than once each; Err bitreich.org 70 i- ; but if one occurs, so MUST the other. Err bitreich.org 70 i- ; Err bitreich.org 70 i- duration / repeat / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- attach / x-prop / iana-prop Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- Description: A "VALARM" calendar component is a grouping of Err bitreich.org 70 i- component properties that is a reminder or alarm for an event or a Err bitreich.org 70 i- to-do. For example, it may be used to define a reminder for a Err bitreich.org 70 i- pending event or an overdue to-do. Err bitreich.org 70 i- Err bitreich.org 70 i- The "VALARM" calendar component MUST include the "ACTION" and Err bitreich.org 70 i- "TRIGGER" properties. The "ACTION" property further constrains Err bitreich.org 70 i- the "VALARM" calendar component in the following ways: Err bitreich.org 70 i- Err bitreich.org 70 i- When the action is "AUDIO", the alarm can also include one and Err bitreich.org 70 i- only one "ATTACH" property, which MUST point to a sound resource, Err bitreich.org 70 i- which is rendered when the alarm is triggered. Err bitreich.org 70 i- Err bitreich.org 70 i- When the action is "DISPLAY", the alarm MUST also include a Err bitreich.org 70 i- "DESCRIPTION" property, which contains the text to be displayed Err bitreich.org 70 i- when the alarm is triggered. Err bitreich.org 70 i- Err bitreich.org 70 i- When the action is "EMAIL", the alarm MUST include a "DESCRIPTION" Err bitreich.org 70 i- property, which contains the text to be used as the message body, Err bitreich.org 70 i- a "SUMMARY" property, which contains the text to be used as the Err bitreich.org 70 i- message subject, and one or more "ATTENDEE" properties, which Err bitreich.org 70 i- contain the email address of attendees to receive the message. It Err bitreich.org 70 i- can also include one or more "ATTACH" properties, which are Err bitreich.org 70 i- intended to be sent as message attachments. When the alarm is Err bitreich.org 70 i- triggered, the email message is sent. Err bitreich.org 70 i- Err bitreich.org 70 i- The "VALARM" calendar component MUST only appear within either a Err bitreich.org 70 i- "VEVENT" or "VTODO" calendar component. "VALARM" calendar Err bitreich.org 70 i- components cannot be nested. Multiple mutually independent Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 73] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- "VALARM" calendar components can be specified for a single Err bitreich.org 70 i- "VEVENT" or "VTODO" calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- The "TRIGGER" property specifies when the alarm will be triggered. Err bitreich.org 70 i- The "TRIGGER" property specifies a duration prior to the start of Err bitreich.org 70 i- an event or a to-do. The "TRIGGER" edge may be explicitly set to Err bitreich.org 70 i- be relative to the "START" or "END" of the event or to-do with the Err bitreich.org 70 i- "RELATED" parameter of the "TRIGGER" property. The "TRIGGER" Err bitreich.org 70 i- property value type can alternatively be set to an absolute Err bitreich.org 70 i- calendar date with UTC time. Err bitreich.org 70 i- Err bitreich.org 70 i- In an alarm set to trigger on the "START" of an event or to-do, Err bitreich.org 70 i- the "DTSTART" property MUST be present in the associated event or Err bitreich.org 70 i- to-do. In an alarm in a "VEVENT" calendar component set to Err bitreich.org 70 i- trigger on the "END" of the event, either the "DTEND" property Err bitreich.org 70 i- MUST be present, or the "DTSTART" and "DURATION" properties MUST Err bitreich.org 70 i- both be present. In an alarm in a "VTODO" calendar component set Err bitreich.org 70 i- to trigger on the "END" of the to-do, either the "DUE" property Err bitreich.org 70 i- MUST be present, or the "DTSTART" and "DURATION" properties MUST Err bitreich.org 70 i- both be present. Err bitreich.org 70 i- Err bitreich.org 70 i- The alarm can be defined such that it triggers repeatedly. A Err bitreich.org 70 i- definition of an alarm with a repeating trigger MUST include both Err bitreich.org 70 i- the "DURATION" and "REPEAT" properties. The "DURATION" property Err bitreich.org 70 i- specifies the delay period, after which the alarm will repeat. Err bitreich.org 70 i- The "REPEAT" property specifies the number of additional Err bitreich.org 70 i- repetitions that the alarm will be triggered. This repetition Err bitreich.org 70 i- count is in addition to the initial triggering of the alarm. Both Err bitreich.org 70 i- of these properties MUST be present in order to specify a Err bitreich.org 70 i- repeating alarm. If one of these two properties is absent, then Err bitreich.org 70 i- the alarm will not repeat beyond the initial trigger. Err bitreich.org 70 i- Err bitreich.org 70 i- The "ACTION" property is used within the "VALARM" calendar Err bitreich.org 70 i- component to specify the type of action invoked when the alarm is Err bitreich.org 70 i- triggered. The "VALARM" properties provide enough information for Err bitreich.org 70 i- a specific action to be invoked. It is typically the Err bitreich.org 70 i- responsibility of a "Calendar User Agent" (CUA) to deliver the Err bitreich.org 70 i- alarm in the specified fashion. An "ACTION" property value of Err bitreich.org 70 i- AUDIO specifies an alarm that causes a sound to be played to alert Err bitreich.org 70 i- the user; DISPLAY specifies an alarm that causes a text message to Err bitreich.org 70 i- be displayed to the user; and EMAIL specifies an alarm that causes Err bitreich.org 70 i- an electronic email message to be delivered to one or more email Err bitreich.org 70 i- addresses. Err bitreich.org 70 i- Err bitreich.org 70 i- In an AUDIO alarm, if the optional "ATTACH" property is included, Err bitreich.org 70 i- it MUST specify an audio sound resource. The intention is that Err bitreich.org 70 i- the sound will be played as the alarm effect. If an "ATTACH" Err bitreich.org 70 i- property is specified that does not refer to a sound resource, or Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 74] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- if the specified sound resource cannot be rendered (because its Err bitreich.org 70 i- format is unsupported, or because it cannot be retrieved), then Err bitreich.org 70 i- the CUA or other entity responsible for playing the sound may Err bitreich.org 70 i- choose a fallback action, such as playing a built-in default Err bitreich.org 70 i- sound, or playing no sound at all. Err bitreich.org 70 i- Err bitreich.org 70 i- In a DISPLAY alarm, the intended alarm effect is for the text Err bitreich.org 70 i- value of the "DESCRIPTION" property to be displayed to the user. Err bitreich.org 70 i- Err bitreich.org 70 i- In an EMAIL alarm, the intended alarm effect is for an email Err bitreich.org 70 i- message to be composed and delivered to all the addresses Err bitreich.org 70 i- specified by the "ATTENDEE" properties in the "VALARM" calendar Err bitreich.org 70 i- component. The "DESCRIPTION" property of the "VALARM" calendar Err bitreich.org 70 i- component MUST be used as the body text of the message, and the Err bitreich.org 70 i- "SUMMARY" property MUST be used as the subject text. Any "ATTACH" Err bitreich.org 70 i- properties in the "VALARM" calendar component SHOULD be sent as Err bitreich.org 70 i- attachments to the message. Err bitreich.org 70 i- Err bitreich.org 70 i- Note: Implementations should carefully consider whether they Err bitreich.org 70 i- accept alarm components from untrusted sources, e.g., when Err bitreich.org 70 i- importing calendar objects from external sources. One Err bitreich.org 70 i- reasonable policy is to always ignore alarm components that the Err bitreich.org 70 i- calendar user has not set herself, or at least ask for Err bitreich.org 70 i- confirmation in such a case. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following example is for a "VALARM" calendar component Err bitreich.org 70 i- that specifies an audio alarm that will sound at a precise time Err bitreich.org 70 i- and repeat 4 more times at 15-minute intervals: Err bitreich.org 70 i- Err bitreich.org 70 i- BEGIN:VALARM Err bitreich.org 70 i- TRIGGER;VALUE=DATE-TIME:19970317T133000Z Err bitreich.org 70 i- REPEAT:4 Err bitreich.org 70 i- DURATION:PT15M Err bitreich.org 70 i- ACTION:AUDIO Err bitreich.org 70 i- ATTACH;FMTTYPE=audio/basic:ftp://example.com/pub/ Err bitreich.org 70 i- sounds/bell-01.aud Err bitreich.org 70 i- END:VALARM Err bitreich.org 70 i- Err bitreich.org 70 i- The following example is for a "VALARM" calendar component that Err bitreich.org 70 i- specifies a display alarm that will trigger 30 minutes before the Err bitreich.org 70 i- scheduled start of the event or of the to-do it is associated with Err bitreich.org 70 i- and will repeat 2 more times at 15-minute intervals: Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 75] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- BEGIN:VALARM Err bitreich.org 70 i- TRIGGER:-PT30M Err bitreich.org 70 i- REPEAT:2 Err bitreich.org 70 i- DURATION:PT15M Err bitreich.org 70 i- ACTION:DISPLAY Err bitreich.org 70 i- DESCRIPTION:Breakfast meeting with executive\n Err bitreich.org 70 i- team at 8:30 AM EST. Err bitreich.org 70 i- END:VALARM Err bitreich.org 70 i- Err bitreich.org 70 i- The following example is for a "VALARM" calendar component that Err bitreich.org 70 i- specifies an email alarm that will trigger 2 days before the Err bitreich.org 70 i- scheduled due DATE-TIME of a to-do with which it is associated. Err bitreich.org 70 i- It does not repeat. The email has a subject, body, and attachment Err bitreich.org 70 i- link. Err bitreich.org 70 i- Err bitreich.org 70 i- BEGIN:VALARM Err bitreich.org 70 i- TRIGGER;RELATED=END:-P2D Err bitreich.org 70 i- ACTION:EMAIL Err bitreich.org 70 i- ATTENDEE:mailto:john_doe@example.com Err bitreich.org 70 i- SUMMARY:*** REMINDER: SEND AGENDA FOR WEEKLY STAFF MEETING *** Err bitreich.org 70 i- DESCRIPTION:A draft agenda needs to be sent out to the attendees Err bitreich.org 70 i- to the weekly managers meeting (MGR-LIST). Attached is a Err bitreich.org 70 i- pointer the document template for the agenda file. Err bitreich.org 70 i- ATTACH;FMTTYPE=application/msword:http://example.com/ Err bitreich.org 70 i- templates/agenda.doc Err bitreich.org 70 i- END:VALARM Err bitreich.org 70 i- Err bitreich.org 70 i-3.7. Calendar Properties Err bitreich.org 70 i- Err bitreich.org 70 i- The Calendar Properties are attributes that apply to the iCalendar Err bitreich.org 70 i- object, as a whole. These properties do not appear within a calendar Err bitreich.org 70 i- component. They SHOULD be specified after the "BEGIN:VCALENDAR" Err bitreich.org 70 i- delimiter string and prior to any calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i-3.7.1. Calendar Scale Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: CALSCALE Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property defines the calendar scale used for the Err bitreich.org 70 i- calendar information specified in the iCalendar object. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: TEXT Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA and non-standard property parameters can Err bitreich.org 70 i- be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property can be specified once in an iCalendar Err bitreich.org 70 i- object. The default value is "GREGORIAN". Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 76] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This memo is based on the Gregorian calendar scale. Err bitreich.org 70 i- The Gregorian calendar scale is assumed if this property is not Err bitreich.org 70 i- specified in the iCalendar object. It is expected that other Err bitreich.org 70 i- calendar scales will be defined in other specifications or by Err bitreich.org 70 i- future versions of this memo. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- calscale = "CALSCALE" calparam ":" calvalue CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- calparam = *(";" other-param) Err bitreich.org 70 i- Err bitreich.org 70 i- calvalue = "GREGORIAN" Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- CALSCALE:GREGORIAN Err bitreich.org 70 i- Err bitreich.org 70 i-3.7.2. Method Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: METHOD Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property defines the iCalendar object method Err bitreich.org 70 i- associated with the calendar object. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: TEXT Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA and non-standard property parameters can Err bitreich.org 70 i- be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property can be specified once in an iCalendar Err bitreich.org 70 i- object. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: When used in a MIME message entity, the value of this Err bitreich.org 70 i- property MUST be the same as the Content-Type "method" parameter Err bitreich.org 70 i- value. If either the "METHOD" property or the Content-Type Err bitreich.org 70 i- "method" parameter is specified, then the other MUST also be Err bitreich.org 70 i- specified. Err bitreich.org 70 i- Err bitreich.org 70 i- No methods are defined by this specification. This is the subject Err bitreich.org 70 i- of other specifications, such as the iCalendar Transport- Err bitreich.org 70 i- independent Interoperability Protocol (iTIP) defined by [2446bis]. Err bitreich.org 70 i- Err bitreich.org 70 i- If this property is not present in the iCalendar object, then a Err bitreich.org 70 i- scheduling transaction MUST NOT be assumed. In such cases, the Err bitreich.org 70 i- iCalendar object is merely being used to transport a snapshot of Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 77] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- some calendar information; without the intention of conveying a Err bitreich.org 70 i- scheduling semantic. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- method = "METHOD" metparam ":" metvalue CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- metparam = *(";" other-param) Err bitreich.org 70 i- Err bitreich.org 70 i- metvalue = iana-token Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is a hypothetical example of this property to Err bitreich.org 70 i- convey that the iCalendar object is a scheduling request: Err bitreich.org 70 i- Err bitreich.org 70 i- METHOD:REQUEST Err bitreich.org 70 i- Err bitreich.org 70 i-3.7.3. Product Identifier Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: PRODID Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property specifies the identifier for the product that Err bitreich.org 70 i- created the iCalendar object. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: TEXT Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA and non-standard property parameters can Err bitreich.org 70 i- be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: The property MUST be specified once in an iCalendar Err bitreich.org 70 i- object. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: The vendor of the implementation SHOULD assure that Err bitreich.org 70 i- this is a globally unique identifier; using some technique such as Err bitreich.org 70 i- an FPI value, as defined in [ISO.9070.1991]. Err bitreich.org 70 i- Err bitreich.org 70 i- This property SHOULD NOT be used to alter the interpretation of an Err bitreich.org 70 i- iCalendar object beyond the semantics specified in this memo. For Err bitreich.org 70 i- example, it is not to be used to further the understanding of non- Err bitreich.org 70 i- standard properties. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- prodid = "PRODID" pidparam ":" pidvalue CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- pidparam = *(";" other-param) Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 78] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- pidvalue = text Err bitreich.org 70 i- ;Any text that describes the product and version Err bitreich.org 70 i- ;and that is generally assured of being unique. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property. It does not Err bitreich.org 70 i- imply that English is the default language. Err bitreich.org 70 i- Err bitreich.org 70 i- PRODID:-//ABC Corporation//NONSGML My Product//EN Err bitreich.org 70 i- Err bitreich.org 70 i-3.7.4. Version Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: VERSION Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property specifies the identifier corresponding to the Err bitreich.org 70 i- highest version number or the minimum and maximum range of the Err bitreich.org 70 i- iCalendar specification that is required in order to interpret the Err bitreich.org 70 i- iCalendar object. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: TEXT Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA and non-standard property parameters can Err bitreich.org 70 i- be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property MUST be specified once in an iCalendar Err bitreich.org 70 i- object. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: A value of "2.0" corresponds to this memo. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- version = "VERSION" verparam ":" vervalue CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- verparam = *(";" other-param) Err bitreich.org 70 i- Err bitreich.org 70 i- vervalue = "2.0" ;This memo Err bitreich.org 70 i- / maxver Err bitreich.org 70 i- / (minver ";" maxver) Err bitreich.org 70 i- Err bitreich.org 70 i- minver = Err bitreich.org 70 i- ;Minimum iCalendar version needed to parse the iCalendar object. Err bitreich.org 70 i- Err bitreich.org 70 i- maxver = Err bitreich.org 70 i- ;Maximum iCalendar version needed to parse the iCalendar object. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 79] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- VERSION:2.0 Err bitreich.org 70 i- Err bitreich.org 70 i-3.8. Component Properties Err bitreich.org 70 i- Err bitreich.org 70 i- The following properties can appear within calendar components, as Err bitreich.org 70 i- specified by each component property definition. Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.1. Descriptive Component Properties Err bitreich.org 70 i- Err bitreich.org 70 i- The following properties specify descriptive information about Err bitreich.org 70 i- calendar components. Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.1.1. Attachment Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: ATTACH Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property provides the capability to associate a Err bitreich.org 70 i- document object with a calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: The default value type for this property is URI. The Err bitreich.org 70 i- value type can also be set to BINARY to indicate inline binary Err bitreich.org 70 i- encoded content information. Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA, non-standard, inline encoding, and value Err bitreich.org 70 i- data type property parameters can be specified on this property. Err bitreich.org 70 i- The format type parameter can be specified on this property and is Err bitreich.org 70 i- RECOMMENDED for inline binary encoded content information. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property can be specified multiple times in a Err bitreich.org 70 i- "VEVENT", "VTODO", "VJOURNAL", or "VALARM" calendar component with Err bitreich.org 70 i- the exception of AUDIO alarm that only allows this property to Err bitreich.org 70 i- occur once. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This property is used in "VEVENT", "VTODO", and Err bitreich.org 70 i- "VJOURNAL" calendar components to associate a resource (e.g., Err bitreich.org 70 i- document) with the calendar component. This property is used in Err bitreich.org 70 i- "VALARM" calendar components to specify an audio sound resource or Err bitreich.org 70 i- an email message attachment. This property can be specified as a Err bitreich.org 70 i- URI pointing to a resource or as inline binary encoded content. Err bitreich.org 70 i- Err bitreich.org 70 i- When this property is specified as inline binary encoded content, Err bitreich.org 70 i- calendar applications MAY attempt to guess the media type of the Err bitreich.org 70 i- resource via inspection of its content if and only if the media Err bitreich.org 70 i- type of the resource is not given by the "FMTTYPE" parameter. If Err bitreich.org 70 i- the media type remains unknown, calendar applications SHOULD treat Err bitreich.org 70 i- it as type "application/octet-stream". Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 80] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- attach = "ATTACH" attachparam ( ":" uri ) / Err bitreich.org 70 i- ( Err bitreich.org 70 i- ";" "ENCODING" "=" "BASE64" Err bitreich.org 70 i- ";" "VALUE" "=" "BINARY" Err bitreich.org 70 i- ":" binary Err bitreich.org 70 i- ) Err bitreich.org 70 i- CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- attachparam = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL for a URI value, Err bitreich.org 70 i- ; RECOMMENDED for a BINARY value, Err bitreich.org 70 i- ; and MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" fmttypeparam) / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" other-param) Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following are examples of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- ATTACH:CID:jsmith.part3.960817T083000.xyzMail@example.com Err bitreich.org 70 i- Err bitreich.org 70 i- ATTACH;FMTTYPE=application/postscript:ftp://example.com/pub/ Err bitreich.org 70 i- reports/r-960812.ps Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.1.2. Categories Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: CATEGORIES Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property defines the categories for a calendar Err bitreich.org 70 i- component. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: TEXT Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA, non-standard, and language property Err bitreich.org 70 i- parameters can be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: The property can be specified within "VEVENT", "VTODO", Err bitreich.org 70 i- or "VJOURNAL" calendar components. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 81] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This property is used to specify categories or subtypes Err bitreich.org 70 i- of the calendar component. The categories are useful in searching Err bitreich.org 70 i- for a calendar component of a particular type and category. Err bitreich.org 70 i- Within the "VEVENT", "VTODO", or "VJOURNAL" calendar components, Err bitreich.org 70 i- more than one category can be specified as a COMMA-separated list Err bitreich.org 70 i- of categories. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- categories = "CATEGORIES" catparam ":" text *("," text) Err bitreich.org 70 i- CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- catparam = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" languageparam ) / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" other-param) Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following are examples of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- CATEGORIES:APPOINTMENT,EDUCATION Err bitreich.org 70 i- Err bitreich.org 70 i- CATEGORIES:MEETING Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.1.3. Classification Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: CLASS Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property defines the access classification for a Err bitreich.org 70 i- calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: TEXT Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA and non-standard property parameters can Err bitreich.org 70 i- be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: The property can be specified once in a "VEVENT", Err bitreich.org 70 i- "VTODO", or "VJOURNAL" calendar components. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 82] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Description: An access classification is only one component of the Err bitreich.org 70 i- general security system within a calendar application. It Err bitreich.org 70 i- provides a method of capturing the scope of the access the Err bitreich.org 70 i- calendar owner intends for information within an individual Err bitreich.org 70 i- calendar entry. The access classification of an individual Err bitreich.org 70 i- iCalendar component is useful when measured along with the other Err bitreich.org 70 i- security components of a calendar system (e.g., calendar user Err bitreich.org 70 i- authentication, authorization, access rights, access role, etc.). Err bitreich.org 70 i- Hence, the semantics of the individual access classifications Err bitreich.org 70 i- cannot be completely defined by this memo alone. Additionally, Err bitreich.org 70 i- due to the "blind" nature of most exchange processes using this Err bitreich.org 70 i- memo, these access classifications cannot serve as an enforcement Err bitreich.org 70 i- statement for a system receiving an iCalendar object. Rather, Err bitreich.org 70 i- they provide a method for capturing the intention of the calendar Err bitreich.org 70 i- owner for the access to the calendar component. If not specified Err bitreich.org 70 i- in a component that allows this property, the default value is Err bitreich.org 70 i- PUBLIC. Applications MUST treat x-name and iana-token values they Err bitreich.org 70 i- don't recognize the same way as they would the PRIVATE value. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- class = "CLASS" classparam ":" classvalue CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- classparam = *(";" other-param) Err bitreich.org 70 i- Err bitreich.org 70 i- classvalue = "PUBLIC" / "PRIVATE" / "CONFIDENTIAL" / iana-token Err bitreich.org 70 i- / x-name Err bitreich.org 70 i- ;Default is PUBLIC Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- CLASS:PUBLIC Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.1.4. Comment Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: COMMENT Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property specifies non-processing information intended Err bitreich.org 70 i- to provide a comment to the calendar user. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: TEXT Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA, non-standard, alternate text Err bitreich.org 70 i- representation, and language property parameters can be specified Err bitreich.org 70 i- on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 83] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property can be specified multiple times in Err bitreich.org 70 i- "VEVENT", "VTODO", "VJOURNAL", and "VFREEBUSY" calendar components Err bitreich.org 70 i- as well as in the "STANDARD" and "DAYLIGHT" sub-components. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This property is used to specify a comment to the Err bitreich.org 70 i- calendar user. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- comment = "COMMENT" commparam ":" text CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- commparam = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" altrepparam) / (";" languageparam) / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" other-param) Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- COMMENT:The meeting really needs to include both ourselves Err bitreich.org 70 i- and the customer. We can't hold this meeting without them. Err bitreich.org 70 i- As a matter of fact\, the venue for the meeting ought to be at Err bitreich.org 70 i- their site. - - John Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.1.5. Description Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: DESCRIPTION Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property provides a more complete description of the Err bitreich.org 70 i- calendar component than that provided by the "SUMMARY" property. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: TEXT Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA, non-standard, alternate text Err bitreich.org 70 i- representation, and language property parameters can be specified Err bitreich.org 70 i- on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 84] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: The property can be specified in the "VEVENT", "VTODO", Err bitreich.org 70 i- "VJOURNAL", or "VALARM" calendar components. The property can be Err bitreich.org 70 i- specified multiple times only within a "VJOURNAL" calendar Err bitreich.org 70 i- component. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This property is used in the "VEVENT" and "VTODO" to Err bitreich.org 70 i- capture lengthy textual descriptions associated with the activity. Err bitreich.org 70 i- Err bitreich.org 70 i- This property is used in the "VJOURNAL" calendar component to Err bitreich.org 70 i- capture one or more textual journal entries. Err bitreich.org 70 i- Err bitreich.org 70 i- This property is used in the "VALARM" calendar component to Err bitreich.org 70 i- capture the display text for a DISPLAY category of alarm, and to Err bitreich.org 70 i- capture the body text for an EMAIL category of alarm. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- description = "DESCRIPTION" descparam ":" text CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- descparam = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" altrepparam) / (";" languageparam) / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" other-param) Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property with formatted Err bitreich.org 70 i- line breaks in the property value: Err bitreich.org 70 i- Err bitreich.org 70 i- DESCRIPTION:Meeting to provide technical review for "Phoenix" Err bitreich.org 70 i- design.\nHappy Face Conference Room. Phoenix design team Err bitreich.org 70 i- MUST attend this meeting.\nRSVP to team leader. Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.1.6. Geographic Position Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: GEO Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property specifies information related to the global Err bitreich.org 70 i- position for the activity specified by a calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 85] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: FLOAT. The value MUST be two SEMICOLON-separated FLOAT Err bitreich.org 70 i- values. Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA and non-standard property parameters can Err bitreich.org 70 i- be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property can be specified in "VEVENT" or "VTODO" Err bitreich.org 70 i- calendar components. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This property value specifies latitude and longitude, Err bitreich.org 70 i- in that order (i.e., "LAT LON" ordering). The longitude Err bitreich.org 70 i- represents the location east or west of the prime meridian as a Err bitreich.org 70 i- positive or negative real number, respectively. The longitude and Err bitreich.org 70 i- latitude values MAY be specified up to six decimal places, which Err bitreich.org 70 i- will allow for accuracy to within one meter of geographical Err bitreich.org 70 i- position. Receiving applications MUST accept values of this Err bitreich.org 70 i- precision and MAY truncate values of greater precision. Err bitreich.org 70 i- Err bitreich.org 70 i- Values for latitude and longitude shall be expressed as decimal Err bitreich.org 70 i- fractions of degrees. Whole degrees of latitude shall be Err bitreich.org 70 i- represented by a two-digit decimal number ranging from 0 through Err bitreich.org 70 i- 90. Whole degrees of longitude shall be represented by a decimal Err bitreich.org 70 i- number ranging from 0 through 180. When a decimal fraction of a Err bitreich.org 70 i- degree is specified, it shall be separated from the whole number Err bitreich.org 70 i- of degrees by a decimal point. Err bitreich.org 70 i- Err bitreich.org 70 i- Latitudes north of the equator shall be specified by a plus sign Err bitreich.org 70 i- (+), or by the absence of a minus sign (-), preceding the digits Err bitreich.org 70 i- designating degrees. Latitudes south of the Equator shall be Err bitreich.org 70 i- designated by a minus sign (-) preceding the digits designating Err bitreich.org 70 i- degrees. A point on the Equator shall be assigned to the Northern Err bitreich.org 70 i- Hemisphere. Err bitreich.org 70 i- Err bitreich.org 70 i- Longitudes east of the prime meridian shall be specified by a plus Err bitreich.org 70 i- sign (+), or by the absence of a minus sign (-), preceding the Err bitreich.org 70 i- digits designating degrees. Longitudes west of the meridian shall Err bitreich.org 70 i- be designated by minus sign (-) preceding the digits designating Err bitreich.org 70 i- degrees. A point on the prime meridian shall be assigned to the Err bitreich.org 70 i- Eastern Hemisphere. A point on the 180th meridian shall be Err bitreich.org 70 i- assigned to the Western Hemisphere. One exception to this last Err bitreich.org 70 i- convention is permitted. For the special condition of describing Err bitreich.org 70 i- a band of latitude around the earth, the East Bounding Coordinate Err bitreich.org 70 i- data element shall be assigned the value +180 (180) degrees. Err bitreich.org 70 i- Err bitreich.org 70 i- Any spatial address with a latitude of +90 (90) or -90 degrees Err bitreich.org 70 i- will specify the position at the North or South Pole, Err bitreich.org 70 i- respectively. The component for longitude may have any legal Err bitreich.org 70 i- value. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 86] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- With the exception of the special condition described above, this Err bitreich.org 70 i- form is specified in [ANSI INCITS 61-1986]. Err bitreich.org 70 i- Err bitreich.org 70 i- The simple formula for converting degrees-minutes-seconds into Err bitreich.org 70 i- decimal degrees is: Err bitreich.org 70 i- Err bitreich.org 70 i- decimal = degrees + minutes/60 + seconds/3600. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- geo = "GEO" geoparam ":" geovalue CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- geoparam = *(";" other-param) Err bitreich.org 70 i- Err bitreich.org 70 i- geovalue = float ";" float Err bitreich.org 70 i- ;Latitude and Longitude components Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- GEO:37.386013;-122.082932 Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.1.7. Location Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: LOCATION Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property defines the intended venue for the activity Err bitreich.org 70 i- defined by a calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: TEXT Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA, non-standard, alternate text Err bitreich.org 70 i- representation, and language property parameters can be specified Err bitreich.org 70 i- on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property can be specified in "VEVENT" or "VTODO" Err bitreich.org 70 i- calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: Specific venues such as conference or meeting rooms may Err bitreich.org 70 i- be explicitly specified using this property. An alternate Err bitreich.org 70 i- representation may be specified that is a URI that points to Err bitreich.org 70 i- directory information with more structured specification of the Err bitreich.org 70 i- location. For example, the alternate representation may specify Err bitreich.org 70 i- either an LDAP URL [RFC4516] pointing to an LDAP server entry or a Err bitreich.org 70 i- CID URL [RFC2392] pointing to a MIME body part containing a Err bitreich.org 70 i- Virtual-Information Card (vCard) [RFC2426] for the location. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 87] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- location = "LOCATION" locparam ":" text CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- locparam = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" altrepparam) / (";" languageparam) / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" other-param) Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following are some examples of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- LOCATION:Conference Room - F123\, Bldg. 002 Err bitreich.org 70 i- Err bitreich.org 70 i- LOCATION;ALTREP="http://xyzcorp.com/conf-rooms/f123.vcf": Err bitreich.org 70 i- Conference Room - F123\, Bldg. 002 Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.1.8. Percent Complete Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: PERCENT-COMPLETE Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property is used by an assignee or delegatee of a Err bitreich.org 70 i- to-do to convey the percent completion of a to-do to the Err bitreich.org 70 i- "Organizer". Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: INTEGER Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA and non-standard property parameters can Err bitreich.org 70 i- be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property can be specified once in a "VTODO" Err bitreich.org 70 i- calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: The property value is a positive integer between 0 and Err bitreich.org 70 i- 100. A value of "0" indicates the to-do has not yet been started. Err bitreich.org 70 i- A value of "100" indicates that the to-do has been completed. Err bitreich.org 70 i- Integer values in between indicate the percent partially complete. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 88] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- When a to-do is assigned to multiple individuals, the property Err bitreich.org 70 i- value indicates the percent complete for that portion of the to-do Err bitreich.org 70 i- assigned to the assignee or delegatee. For example, if a to-do is Err bitreich.org 70 i- assigned to both individuals "A" and "B". A reply from "A" with a Err bitreich.org 70 i- percent complete of "70" indicates that "A" has completed 70% of Err bitreich.org 70 i- the to-do assigned to them. A reply from "B" with a percent Err bitreich.org 70 i- complete of "50" indicates "B" has completed 50% of the to-do Err bitreich.org 70 i- assigned to them. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- percent = "PERCENT-COMPLETE" pctparam ":" integer CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- pctparam = *(";" other-param) Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property to show 39% Err bitreich.org 70 i- completion: Err bitreich.org 70 i- Err bitreich.org 70 i- PERCENT-COMPLETE:39 Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.1.9. Priority Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: PRIORITY Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property defines the relative priority for a calendar Err bitreich.org 70 i- component. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: INTEGER Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA and non-standard property parameters can Err bitreich.org 70 i- be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property can be specified in "VEVENT" and "VTODO" Err bitreich.org 70 i- calendar components. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This priority is specified as an integer in the range 0 Err bitreich.org 70 i- to 9. A value of 0 specifies an undefined priority. A value of 1 Err bitreich.org 70 i- is the highest priority. A value of 2 is the second highest Err bitreich.org 70 i- priority. Subsequent numbers specify a decreasing ordinal Err bitreich.org 70 i- priority. A value of 9 is the lowest priority. Err bitreich.org 70 i- Err bitreich.org 70 i- A CUA with a three-level priority scheme of "HIGH", "MEDIUM", and Err bitreich.org 70 i- "LOW" is mapped into this property such that a property value in Err bitreich.org 70 i- the range of 1 to 4 specifies "HIGH" priority. A value of 5 is Err bitreich.org 70 i- the normal or "MEDIUM" priority. A value in the range of 6 to 9 Err bitreich.org 70 i- is "LOW" priority. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 89] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- A CUA with a priority schema of "A1", "A2", "A3", "B1", "B2", ..., Err bitreich.org 70 i- "C3" is mapped into this property such that a property value of 1 Err bitreich.org 70 i- specifies "A1", a property value of 2 specifies "A2", a property Err bitreich.org 70 i- value of 3 specifies "A3", and so forth up to a property value of Err bitreich.org 70 i- 9 specifies "C3". Err bitreich.org 70 i- Err bitreich.org 70 i- Other integer values are reserved for future use. Err bitreich.org 70 i- Err bitreich.org 70 i- Within a "VEVENT" calendar component, this property specifies a Err bitreich.org 70 i- priority for the event. This property may be useful when more Err bitreich.org 70 i- than one event is scheduled for a given time period. Err bitreich.org 70 i- Err bitreich.org 70 i- Within a "VTODO" calendar component, this property specified a Err bitreich.org 70 i- priority for the to-do. This property is useful in prioritizing Err bitreich.org 70 i- multiple action items for a given time period. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- priority = "PRIORITY" prioparam ":" priovalue CRLF Err bitreich.org 70 i- ;Default is zero (i.e., undefined). Err bitreich.org 70 i- Err bitreich.org 70 i- prioparam = *(";" other-param) Err bitreich.org 70 i- Err bitreich.org 70 i- priovalue = integer ;Must be in the range [0..9] Err bitreich.org 70 i- ; All other values are reserved for future use. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of a property with the highest Err bitreich.org 70 i- priority: Err bitreich.org 70 i- Err bitreich.org 70 i- PRIORITY:1 Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of a property with a next highest Err bitreich.org 70 i- priority: Err bitreich.org 70 i- Err bitreich.org 70 i- PRIORITY:2 Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of a property with no priority. This Err bitreich.org 70 i- is equivalent to not specifying the "PRIORITY" property: Err bitreich.org 70 i- Err bitreich.org 70 i- PRIORITY:0 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 90] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.1.10. Resources Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: RESOURCES Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property defines the equipment or resources Err bitreich.org 70 i- anticipated for an activity specified by a calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: TEXT Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA, non-standard, alternate text Err bitreich.org 70 i- representation, and language property parameters can be specified Err bitreich.org 70 i- on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property can be specified once in "VEVENT" or Err bitreich.org 70 i- "VTODO" calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: The property value is an arbitrary text. More than one Err bitreich.org 70 i- resource can be specified as a COMMA-separated list of resources. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- resources = "RESOURCES" resrcparam ":" text *("," text) CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- resrcparam = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" altrepparam) / (";" languageparam) / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" other-param) Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- RESOURCES:EASEL,PROJECTOR,VCR Err bitreich.org 70 i- Err bitreich.org 70 i- RESOURCES;LANGUAGE=fr:Nettoyeur haute pression Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 91] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.1.11. Status Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: STATUS Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property defines the overall status or confirmation Err bitreich.org 70 i- for the calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: TEXT Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA and non-standard property parameters can Err bitreich.org 70 i- be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property can be specified once in "VEVENT", Err bitreich.org 70 i- "VTODO", or "VJOURNAL" calendar components. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: In a group-scheduled calendar component, the property Err bitreich.org 70 i- is used by the "Organizer" to provide a confirmation of the event Err bitreich.org 70 i- to the "Attendees". For example in a "VEVENT" calendar component, Err bitreich.org 70 i- the "Organizer" can indicate that a meeting is tentative, Err bitreich.org 70 i- confirmed, or cancelled. In a "VTODO" calendar component, the Err bitreich.org 70 i- "Organizer" can indicate that an action item needs action, is Err bitreich.org 70 i- completed, is in process or being worked on, or has been Err bitreich.org 70 i- cancelled. In a "VJOURNAL" calendar component, the "Organizer" Err bitreich.org 70 i- can indicate that a journal entry is draft, final, or has been Err bitreich.org 70 i- cancelled or removed. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- status = "STATUS" statparam ":" statvalue CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- statparam = *(";" other-param) Err bitreich.org 70 i- Err bitreich.org 70 i- statvalue = (statvalue-event Err bitreich.org 70 i- / statvalue-todo Err bitreich.org 70 i- / statvalue-jour) Err bitreich.org 70 i- Err bitreich.org 70 i- statvalue-event = "TENTATIVE" ;Indicates event is tentative. Err bitreich.org 70 i- / "CONFIRMED" ;Indicates event is definite. Err bitreich.org 70 i- / "CANCELLED" ;Indicates event was cancelled. Err bitreich.org 70 i- ;Status values for a "VEVENT" Err bitreich.org 70 i- Err bitreich.org 70 i- statvalue-todo = "NEEDS-ACTION" ;Indicates to-do needs action. Err bitreich.org 70 i- / "COMPLETED" ;Indicates to-do completed. Err bitreich.org 70 i- / "IN-PROCESS" ;Indicates to-do in process of. Err bitreich.org 70 i- / "CANCELLED" ;Indicates to-do was cancelled. Err bitreich.org 70 i- ;Status values for "VTODO". Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 92] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- statvalue-jour = "DRAFT" ;Indicates journal is draft. Err bitreich.org 70 i- / "FINAL" ;Indicates journal is final. Err bitreich.org 70 i- / "CANCELLED" ;Indicates journal is removed. Err bitreich.org 70 i- ;Status values for "VJOURNAL". Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property for a "VEVENT" Err bitreich.org 70 i- calendar component: Err bitreich.org 70 i- Err bitreich.org 70 i- STATUS:TENTATIVE Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of this property for a "VTODO" Err bitreich.org 70 i- calendar component: Err bitreich.org 70 i- Err bitreich.org 70 i- STATUS:NEEDS-ACTION Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of this property for a "VJOURNAL" Err bitreich.org 70 i- calendar component: Err bitreich.org 70 i- Err bitreich.org 70 i- STATUS:DRAFT Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.1.12. Summary Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: SUMMARY Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property defines a short summary or subject for the Err bitreich.org 70 i- calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: TEXT Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA, non-standard, alternate text Err bitreich.org 70 i- representation, and language property parameters can be specified Err bitreich.org 70 i- on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: The property can be specified in "VEVENT", "VTODO", Err bitreich.org 70 i- "VJOURNAL", or "VALARM" calendar components. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This property is used in the "VEVENT", "VTODO", and Err bitreich.org 70 i- "VJOURNAL" calendar components to capture a short, one-line Err bitreich.org 70 i- summary about the activity or journal entry. Err bitreich.org 70 i- Err bitreich.org 70 i- This property is used in the "VALARM" calendar component to Err bitreich.org 70 i- capture the subject of an EMAIL category of alarm. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 93] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- summary = "SUMMARY" summparam ":" text CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- summparam = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" altrepparam) / (";" languageparam) / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" other-param) Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- SUMMARY:Department Party Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.2. Date and Time Component Properties Err bitreich.org 70 i- Err bitreich.org 70 i- The following properties specify date and time related information in Err bitreich.org 70 i- calendar components. Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.2.1. Date-Time Completed Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: COMPLETED Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property defines the date and time that a to-do was Err bitreich.org 70 i- actually completed. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: DATE-TIME Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA and non-standard property parameters can Err bitreich.org 70 i- be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: The property can be specified in a "VTODO" calendar Err bitreich.org 70 i- component. The value MUST be specified as a date with UTC time. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This property defines the date and time that a to-do Err bitreich.org 70 i- was actually completed. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 94] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- completed = "COMPLETED" compparam ":" date-time CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- compparam = *(";" other-param) Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- COMPLETED:19960401T150000Z Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.2.2. Date-Time End Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: DTEND Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property specifies the date and time that a calendar Err bitreich.org 70 i- component ends. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: The default value type is DATE-TIME. The value type can Err bitreich.org 70 i- be set to a DATE value type. Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA, non-standard, value data type, and time Err bitreich.org 70 i- zone identifier property parameters can be specified on this Err bitreich.org 70 i- property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property can be specified in "VEVENT" or Err bitreich.org 70 i- "VFREEBUSY" calendar components. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: Within the "VEVENT" calendar component, this property Err bitreich.org 70 i- defines the date and time by which the event ends. The value type Err bitreich.org 70 i- of this property MUST be the same as the "DTSTART" property, and Err bitreich.org 70 i- its value MUST be later in time than the value of the "DTSTART" Err bitreich.org 70 i- property. Furthermore, this property MUST be specified as a date Err bitreich.org 70 i- with local time if and only if the "DTSTART" property is also Err bitreich.org 70 i- specified as a date with local time. Err bitreich.org 70 i- Err bitreich.org 70 i- Within the "VFREEBUSY" calendar component, this property defines Err bitreich.org 70 i- the end date and time for the free or busy time information. The Err bitreich.org 70 i- time MUST be specified in the UTC time format. The value MUST be Err bitreich.org 70 i- later in time than the value of the "DTSTART" property. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 95] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- dtend = "DTEND" dtendparam ":" dtendval CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- dtendparam = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" "VALUE" "=" ("DATE-TIME" / "DATE")) / Err bitreich.org 70 i- (";" tzidparam) / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" other-param) Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- dtendval = date-time / date Err bitreich.org 70 i- ;Value MUST match value type Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- DTEND:19960401T150000Z Err bitreich.org 70 i- Err bitreich.org 70 i- DTEND;VALUE=DATE:19980704 Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.2.3. Date-Time Due Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: DUE Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property defines the date and time that a to-do is Err bitreich.org 70 i- expected to be completed. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: The default value type is DATE-TIME. The value type can Err bitreich.org 70 i- be set to a DATE value type. Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA, non-standard, value data type, and time Err bitreich.org 70 i- zone identifier property parameters can be specified on this Err bitreich.org 70 i- property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: The property can be specified once in a "VTODO" Err bitreich.org 70 i- calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This property defines the date and time before which a Err bitreich.org 70 i- to-do is expected to be completed. For cases where this property Err bitreich.org 70 i- is specified in a "VTODO" calendar component that also specifies a Err bitreich.org 70 i- "DTSTART" property, the value type of this property MUST be the Err bitreich.org 70 i- same as the "DTSTART" property, and the value of this property Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 96] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- MUST be later in time than the value of the "DTSTART" property. Err bitreich.org 70 i- Furthermore, this property MUST be specified as a date with local Err bitreich.org 70 i- time if and only if the "DTSTART" property is also specified as a Err bitreich.org 70 i- date with local time. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- due = "DUE" dueparam ":" dueval CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- dueparam = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" "VALUE" "=" ("DATE-TIME" / "DATE")) / Err bitreich.org 70 i- (";" tzidparam) / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" other-param) Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- dueval = date-time / date Err bitreich.org 70 i- ;Value MUST match value type Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- DUE:19980430T000000Z Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.2.4. Date-Time Start Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: DTSTART Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property specifies when the calendar component begins. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: The default value type is DATE-TIME. The time value Err bitreich.org 70 i- MUST be one of the forms defined for the DATE-TIME value type. Err bitreich.org 70 i- The value type can be set to a DATE value type. Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA, non-standard, value data type, and time Err bitreich.org 70 i- zone identifier property parameters can be specified on this Err bitreich.org 70 i- property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property can be specified once in the "VEVENT", Err bitreich.org 70 i- "VTODO", or "VFREEBUSY" calendar components as well as in the Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 97] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- "STANDARD" and "DAYLIGHT" sub-components. This property is Err bitreich.org 70 i- REQUIRED in all types of recurring calendar components that Err bitreich.org 70 i- specify the "RRULE" property. This property is also REQUIRED in Err bitreich.org 70 i- "VEVENT" calendar components contained in iCalendar objects that Err bitreich.org 70 i- don't specify the "METHOD" property. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: Within the "VEVENT" calendar component, this property Err bitreich.org 70 i- defines the start date and time for the event. Err bitreich.org 70 i- Err bitreich.org 70 i- Within the "VFREEBUSY" calendar component, this property defines Err bitreich.org 70 i- the start date and time for the free or busy time information. Err bitreich.org 70 i- The time MUST be specified in UTC time. Err bitreich.org 70 i- Err bitreich.org 70 i- Within the "STANDARD" and "DAYLIGHT" sub-components, this property Err bitreich.org 70 i- defines the effective start date and time for a time zone Err bitreich.org 70 i- specification. This property is REQUIRED within each "STANDARD" Err bitreich.org 70 i- and "DAYLIGHT" sub-components included in "VTIMEZONE" calendar Err bitreich.org 70 i- components and MUST be specified as a date with local time without Err bitreich.org 70 i- the "TZID" property parameter. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- dtstart = "DTSTART" dtstparam ":" dtstval CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- dtstparam = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" "VALUE" "=" ("DATE-TIME" / "DATE")) / Err bitreich.org 70 i- (";" tzidparam) / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" other-param) Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- dtstval = date-time / date Err bitreich.org 70 i- ;Value MUST match value type Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART:19980118T073000Z Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 98] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.2.5. Duration Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: DURATION Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property specifies a positive duration of time. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: DURATION Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA and non-standard property parameters can Err bitreich.org 70 i- be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property can be specified in "VEVENT", "VTODO", or Err bitreich.org 70 i- "VALARM" calendar components. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: In a "VEVENT" calendar component the property may be Err bitreich.org 70 i- used to specify a duration of the event, instead of an explicit Err bitreich.org 70 i- end DATE-TIME. In a "VTODO" calendar component the property may Err bitreich.org 70 i- be used to specify a duration for the to-do, instead of an Err bitreich.org 70 i- explicit due DATE-TIME. In a "VALARM" calendar component the Err bitreich.org 70 i- property may be used to specify the delay period prior to Err bitreich.org 70 i- repeating an alarm. When the "DURATION" property relates to a Err bitreich.org 70 i- "DTSTART" property that is specified as a DATE value, then the Err bitreich.org 70 i- "DURATION" property MUST be specified as a "dur-day" or "dur-week" Err bitreich.org 70 i- value. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- duration = "DURATION" durparam ":" dur-value CRLF Err bitreich.org 70 i- ;consisting of a positive duration of time. Err bitreich.org 70 i- Err bitreich.org 70 i- durparam = *(";" other-param) Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property that specifies Err bitreich.org 70 i- an interval of time of one hour and zero minutes and zero seconds: Err bitreich.org 70 i- Err bitreich.org 70 i- DURATION:PT1H0M0S Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of this property that specifies an Err bitreich.org 70 i- interval of time of 15 minutes. Err bitreich.org 70 i- Err bitreich.org 70 i- DURATION:PT15M Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 99] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.2.6. Free/Busy Time Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: FREEBUSY Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property defines one or more free or busy time Err bitreich.org 70 i- intervals. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: PERIOD Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA, non-standard, and free/busy time type Err bitreich.org 70 i- property parameters can be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: The property can be specified in a "VFREEBUSY" calendar Err bitreich.org 70 i- component. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: These time periods can be specified as either a start Err bitreich.org 70 i- and end DATE-TIME or a start DATE-TIME and DURATION. The date and Err bitreich.org 70 i- time MUST be a UTC time format. Err bitreich.org 70 i- Err bitreich.org 70 i- "FREEBUSY" properties within the "VFREEBUSY" calendar component Err bitreich.org 70 i- SHOULD be sorted in ascending order, based on start time and then Err bitreich.org 70 i- end time, with the earliest periods first. Err bitreich.org 70 i- Err bitreich.org 70 i- The "FREEBUSY" property can specify more than one value, separated Err bitreich.org 70 i- by the COMMA character. In such cases, the "FREEBUSY" property Err bitreich.org 70 i- values MUST all be of the same "FBTYPE" property parameter type Err bitreich.org 70 i- (e.g., all values of a particular "FBTYPE" listed together in a Err bitreich.org 70 i- single property). Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- freebusy = "FREEBUSY" fbparam ":" fbvalue CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- fbparam = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" fbtypeparam) / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" other-param) Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 100] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- fbvalue = period *("," period) Err bitreich.org 70 i- ;Time value MUST be in the UTC time format. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following are some examples of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- FREEBUSY;FBTYPE=BUSY-UNAVAILABLE:19970308T160000Z/PT8H30M Err bitreich.org 70 i- Err bitreich.org 70 i- FREEBUSY;FBTYPE=FREE:19970308T160000Z/PT3H,19970308T200000Z/PT1H Err bitreich.org 70 i- Err bitreich.org 70 i- FREEBUSY;FBTYPE=FREE:19970308T160000Z/PT3H,19970308T200000Z/PT1H Err bitreich.org 70 i- ,19970308T230000Z/19970309T000000Z Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.2.7. Time Transparency Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: TRANSP Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property defines whether or not an event is Err bitreich.org 70 i- transparent to busy time searches. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: TEXT Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA and non-standard property parameters can Err bitreich.org 70 i- be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property can be specified once in a "VEVENT" Err bitreich.org 70 i- calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: Time Transparency is the characteristic of an event Err bitreich.org 70 i- that determines whether it appears to consume time on a calendar. Err bitreich.org 70 i- Events that consume actual time for the individual or resource Err bitreich.org 70 i- associated with the calendar SHOULD be recorded as OPAQUE, Err bitreich.org 70 i- allowing them to be detected by free/busy time searches. Other Err bitreich.org 70 i- events, which do not take up the individual's (or resource's) time Err bitreich.org 70 i- SHOULD be recorded as TRANSPARENT, making them invisible to free/ Err bitreich.org 70 i- busy time searches. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- transp = "TRANSP" transparam ":" transvalue CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- transparam = *(";" other-param) Err bitreich.org 70 i- Err bitreich.org 70 i- transvalue = "OPAQUE" Err bitreich.org 70 i- ;Blocks or opaque on busy time searches. Err bitreich.org 70 i- / "TRANSPARENT" Err bitreich.org 70 i- ;Transparent on busy time searches. Err bitreich.org 70 i- ;Default value is OPAQUE Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 101] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property for an event Err bitreich.org 70 i- that is transparent or does not block on free/busy time searches: Err bitreich.org 70 i- Err bitreich.org 70 i- TRANSP:TRANSPARENT Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of this property for an event that is Err bitreich.org 70 i- opaque or blocks on free/busy time searches: Err bitreich.org 70 i- Err bitreich.org 70 i- TRANSP:OPAQUE Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.3. Time Zone Component Properties Err bitreich.org 70 i- Err bitreich.org 70 i- The following properties specify time zone information in calendar Err bitreich.org 70 i- components. Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.3.1. Time Zone Identifier Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: TZID Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property specifies the text value that uniquely Err bitreich.org 70 i- identifies the "VTIMEZONE" calendar component in the scope of an Err bitreich.org 70 i- iCalendar object. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: TEXT Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA and non-standard property parameters can Err bitreich.org 70 i- be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property MUST be specified in a "VTIMEZONE" Err bitreich.org 70 i- calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This is the label by which a time zone calendar Err bitreich.org 70 i- component is referenced by any iCalendar properties whose value Err bitreich.org 70 i- type is either DATE-TIME or TIME and not intended to specify a UTC Err bitreich.org 70 i- or a "floating" time. The presence of the SOLIDUS character as a Err bitreich.org 70 i- prefix, indicates that this "TZID" represents an unique ID in a Err bitreich.org 70 i- globally defined time zone registry (when such registry is Err bitreich.org 70 i- defined). Err bitreich.org 70 i- Err bitreich.org 70 i- Note: This document does not define a naming convention for Err bitreich.org 70 i- time zone identifiers. Implementers may want to use the naming Err bitreich.org 70 i- conventions defined in existing time zone specifications such Err bitreich.org 70 i- as the public-domain TZ database [TZDB]. The specification of Err bitreich.org 70 i- globally unique time zone identifiers is not addressed by this Err bitreich.org 70 i- document and is left for future study. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 102] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- tzid = "TZID" tzidpropparam ":" [tzidprefix] text CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- tzidpropparam = *(";" other-param) Err bitreich.org 70 i- Err bitreich.org 70 i- ;tzidprefix = "/" Err bitreich.org 70 i- ; Defined previously. Just listed here for reader convenience. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following are examples of non-globally unique time zone Err bitreich.org 70 i- identifiers: Err bitreich.org 70 i- Err bitreich.org 70 i- TZID:America/New_York Err bitreich.org 70 i- Err bitreich.org 70 i- TZID:America/Los_Angeles Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of a fictitious globally unique time Err bitreich.org 70 i- zone identifier: Err bitreich.org 70 i- Err bitreich.org 70 i- TZID:/example.org/America/New_York Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.3.2. Time Zone Name Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: TZNAME Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property specifies the customary designation for a Err bitreich.org 70 i- time zone description. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: TEXT Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA, non-standard, and language property Err bitreich.org 70 i- parameters can be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property can be specified in "STANDARD" and Err bitreich.org 70 i- "DAYLIGHT" sub-components. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This property specifies a customary name that can be Err bitreich.org 70 i- used when displaying dates that occur during the observance Err bitreich.org 70 i- defined by the time zone sub-component. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 103] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- tzname = "TZNAME" tznparam ":" text CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- tznparam = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" languageparam) / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" other-param) Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following are examples of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- TZNAME:EST Err bitreich.org 70 i- Err bitreich.org 70 i- TZNAME;LANGUAGE=fr-CA:HNE Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.3.3. Time Zone Offset From Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: TZOFFSETFROM Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property specifies the offset that is in use prior to Err bitreich.org 70 i- this time zone observance. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: UTC-OFFSET Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA and non-standard property parameters can Err bitreich.org 70 i- be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property MUST be specified in "STANDARD" and Err bitreich.org 70 i- "DAYLIGHT" sub-components. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This property specifies the offset that is in use prior Err bitreich.org 70 i- to this time observance. It is used to calculate the absolute Err bitreich.org 70 i- time at which the transition to a given observance takes place. Err bitreich.org 70 i- This property MUST only be specified in a "VTIMEZONE" calendar Err bitreich.org 70 i- component. A "VTIMEZONE" calendar component MUST include this Err bitreich.org 70 i- property. The property value is a signed numeric indicating the Err bitreich.org 70 i- number of hours and possibly minutes from UTC. Positive numbers Err bitreich.org 70 i- represent time zones east of the prime meridian, or ahead of UTC. Err bitreich.org 70 i- Negative numbers represent time zones west of the prime meridian, Err bitreich.org 70 i- or behind UTC. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 104] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- tzoffsetfrom = "TZOFFSETFROM" frmparam ":" utc-offset Err bitreich.org 70 i- CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- frmparam = *(";" other-param) Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following are examples of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- TZOFFSETFROM:-0500 Err bitreich.org 70 i- Err bitreich.org 70 i- TZOFFSETFROM:+1345 Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.3.4. Time Zone Offset To Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: TZOFFSETTO Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property specifies the offset that is in use in this Err bitreich.org 70 i- time zone observance. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: UTC-OFFSET Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA and non-standard property parameters can Err bitreich.org 70 i- be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property MUST be specified in "STANDARD" and Err bitreich.org 70 i- "DAYLIGHT" sub-components. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This property specifies the offset that is in use in Err bitreich.org 70 i- this time zone observance. It is used to calculate the absolute Err bitreich.org 70 i- time for the new observance. The property value is a signed Err bitreich.org 70 i- numeric indicating the number of hours and possibly minutes from Err bitreich.org 70 i- UTC. Positive numbers represent time zones east of the prime Err bitreich.org 70 i- meridian, or ahead of UTC. Negative numbers represent time zones Err bitreich.org 70 i- west of the prime meridian, or behind UTC. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- tzoffsetto = "TZOFFSETTO" toparam ":" utc-offset CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- toparam = *(";" other-param) Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 105] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following are examples of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- TZOFFSETTO:-0400 Err bitreich.org 70 i- Err bitreich.org 70 i- TZOFFSETTO:+1245 Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.3.5. Time Zone URL Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: TZURL Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property provides a means for a "VTIMEZONE" component Err bitreich.org 70 i- to point to a network location that can be used to retrieve an up- Err bitreich.org 70 i- to-date version of itself. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: URI Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA and non-standard property parameters can Err bitreich.org 70 i- be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property can be specified in a "VTIMEZONE" Err bitreich.org 70 i- calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This property provides a means for a "VTIMEZONE" Err bitreich.org 70 i- component to point to a network location that can be used to Err bitreich.org 70 i- retrieve an up-to-date version of itself. This provides a hook to Err bitreich.org 70 i- handle changes government bodies impose upon time zone Err bitreich.org 70 i- definitions. Retrieval of this resource results in an iCalendar Err bitreich.org 70 i- object containing a single "VTIMEZONE" component and a "METHOD" Err bitreich.org 70 i- property set to PUBLISH. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- tzurl = "TZURL" tzurlparam ":" uri CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- tzurlparam = *(";" other-param) Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- TZURL:http://timezones.example.org/tz/America-Los_Angeles.ics Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.4. Relationship Component Properties Err bitreich.org 70 i- Err bitreich.org 70 i- The following properties specify relationship information in calendar Err bitreich.org 70 i- components. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 106] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.4.1. Attendee Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: ATTENDEE Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property defines an "Attendee" within a calendar Err bitreich.org 70 i- component. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: CAL-ADDRESS Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA, non-standard, language, calendar user Err bitreich.org 70 i- type, group or list membership, participation role, participation Err bitreich.org 70 i- status, RSVP expectation, delegatee, delegator, sent by, common Err bitreich.org 70 i- name, or directory entry reference property parameters can be Err bitreich.org 70 i- specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property MUST be specified in an iCalendar object Err bitreich.org 70 i- that specifies a group-scheduled calendar entity. This property Err bitreich.org 70 i- MUST NOT be specified in an iCalendar object when publishing the Err bitreich.org 70 i- calendar information (e.g., NOT in an iCalendar object that Err bitreich.org 70 i- specifies the publication of a calendar user's busy time, event, Err bitreich.org 70 i- to-do, or journal). This property is not specified in an Err bitreich.org 70 i- iCalendar object that specifies only a time zone definition or Err bitreich.org 70 i- that defines calendar components that are not group-scheduled Err bitreich.org 70 i- components, but are components only on a single user's calendar. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This property MUST only be specified within calendar Err bitreich.org 70 i- components to specify participants, non-participants, and the Err bitreich.org 70 i- chair of a group-scheduled calendar entity. The property is Err bitreich.org 70 i- specified within an "EMAIL" category of the "VALARM" calendar Err bitreich.org 70 i- component to specify an email address that is to receive the email Err bitreich.org 70 i- type of iCalendar alarm. Err bitreich.org 70 i- Err bitreich.org 70 i- The property parameter "CN" is for the common or displayable name Err bitreich.org 70 i- associated with the calendar address; "ROLE", for the intended Err bitreich.org 70 i- role that the attendee will have in the calendar component; Err bitreich.org 70 i- "PARTSTAT", for the status of the attendee's participation; Err bitreich.org 70 i- "RSVP", for indicating whether the favor of a reply is requested; Err bitreich.org 70 i- "CUTYPE", to indicate the type of calendar user; "MEMBER", to Err bitreich.org 70 i- indicate the groups that the attendee belongs to; "DELEGATED-TO", Err bitreich.org 70 i- to indicate the calendar users that the original request was Err bitreich.org 70 i- delegated to; and "DELEGATED-FROM", to indicate whom the request Err bitreich.org 70 i- was delegated from; "SENT-BY", to indicate whom is acting on Err bitreich.org 70 i- behalf of the "ATTENDEE"; and "DIR", to indicate the URI that Err bitreich.org 70 i- points to the directory information corresponding to the attendee. Err bitreich.org 70 i- These property parameters can be specified on an "ATTENDEE" Err bitreich.org 70 i- property in either a "VEVENT", "VTODO", or "VJOURNAL" calendar Err bitreich.org 70 i- component. They MUST NOT be specified in an "ATTENDEE" property Err bitreich.org 70 i- in a "VFREEBUSY" or "VALARM" calendar component. If the Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 107] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- "LANGUAGE" property parameter is specified, the identified Err bitreich.org 70 i- language applies to the "CN" parameter. Err bitreich.org 70 i- Err bitreich.org 70 i- A recipient delegated a request MUST inherit the "RSVP" and "ROLE" Err bitreich.org 70 i- values from the attendee that delegated the request to them. Err bitreich.org 70 i- Err bitreich.org 70 i- Multiple attendees can be specified by including multiple Err bitreich.org 70 i- "ATTENDEE" properties within the calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- attendee = "ATTENDEE" attparam ":" cal-address CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- attparam = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" cutypeparam) / (";" memberparam) / Err bitreich.org 70 i- (";" roleparam) / (";" partstatparam) / Err bitreich.org 70 i- (";" rsvpparam) / (";" deltoparam) / Err bitreich.org 70 i- (";" delfromparam) / (";" sentbyparam) / Err bitreich.org 70 i- (";" cnparam) / (";" dirparam) / Err bitreich.org 70 i- (";" languageparam) / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" other-param) Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following are examples of this property's use for a Err bitreich.org 70 i- to-do: Err bitreich.org 70 i- Err bitreich.org 70 i- ATTENDEE;MEMBER="mailto:DEV-GROUP@example.com": Err bitreich.org 70 i- mailto:joecool@example.com Err bitreich.org 70 i- ATTENDEE;DELEGATED-FROM="mailto:immud@example.com": Err bitreich.org 70 i- mailto:ildoit@example.com Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 108] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of this property used for specifying Err bitreich.org 70 i- multiple attendees to an event: Err bitreich.org 70 i- Err bitreich.org 70 i- ATTENDEE;ROLE=REQ-PARTICIPANT;PARTSTAT=TENTATIVE;CN=Henry Err bitreich.org 70 i- Cabot:mailto:hcabot@example.com Err bitreich.org 70 i- ATTENDEE;ROLE=REQ-PARTICIPANT;DELEGATED-FROM="mailto:bob@ Err bitreich.org 70 i- example.com";PARTSTAT=ACCEPTED;CN=Jane Doe:mailto:jdoe@ Err bitreich.org 70 i- example.com Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of this property with a URI to the Err bitreich.org 70 i- directory information associated with the attendee: Err bitreich.org 70 i- Err bitreich.org 70 i- ATTENDEE;CN=John Smith;DIR="ldap://example.com:6666/o=ABC% Err bitreich.org 70 i- 20Industries,c=US???(cn=Jim%20Dolittle)":mailto:jimdo@ Err bitreich.org 70 i- example.com Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of this property with "delegatee" and Err bitreich.org 70 i- "delegator" information for an event: Err bitreich.org 70 i- Err bitreich.org 70 i- ATTENDEE;ROLE=REQ-PARTICIPANT;PARTSTAT=TENTATIVE;DELEGATED-FROM= Err bitreich.org 70 i- "mailto:iamboss@example.com";CN=Henry Cabot:mailto:hcabot@ Err bitreich.org 70 i- example.com Err bitreich.org 70 i- ATTENDEE;ROLE=NON-PARTICIPANT;PARTSTAT=DELEGATED;DELEGATED-TO= Err bitreich.org 70 i- "mailto:hcabot@example.com";CN=The Big Cheese:mailto:iamboss Err bitreich.org 70 i- @example.com Err bitreich.org 70 i- ATTENDEE;ROLE=REQ-PARTICIPANT;PARTSTAT=ACCEPTED;CN=Jane Doe Err bitreich.org 70 i- :mailto:jdoe@example.com Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property's use when Err bitreich.org 70 i- another calendar user is acting on behalf of the "Attendee": Err bitreich.org 70 i- Err bitreich.org 70 i- ATTENDEE;SENT-BY=mailto:jan_doe@example.com;CN=John Smith: Err bitreich.org 70 i- mailto:jsmith@example.com Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.4.2. Contact Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: CONTACT Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property is used to represent contact information or Err bitreich.org 70 i- alternately a reference to contact information associated with the Err bitreich.org 70 i- calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: TEXT Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA, non-standard, alternate text Err bitreich.org 70 i- representation, and language property parameters can be specified Err bitreich.org 70 i- on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 109] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property can be specified in a "VEVENT", "VTODO", Err bitreich.org 70 i- "VJOURNAL", or "VFREEBUSY" calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: The property value consists of textual contact Err bitreich.org 70 i- information. An alternative representation for the property value Err bitreich.org 70 i- can also be specified that refers to a URI pointing to an Err bitreich.org 70 i- alternate form, such as a vCard [RFC2426], for the contact Err bitreich.org 70 i- information. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- contact = "CONTACT" contparam ":" text CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- contparam = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" altrepparam) / (";" languageparam) / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" other-param) Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property referencing Err bitreich.org 70 i- textual contact information: Err bitreich.org 70 i- Err bitreich.org 70 i- CONTACT:Jim Dolittle\, ABC Industries\, +1-919-555-1234 Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of this property with an alternate Err bitreich.org 70 i- representation of an LDAP URI to a directory entry containing the Err bitreich.org 70 i- contact information: Err bitreich.org 70 i- Err bitreich.org 70 i- CONTACT;ALTREP="ldap://example.com:6666/o=ABC%20Industries\, Err bitreich.org 70 i- c=US???(cn=Jim%20Dolittle)":Jim Dolittle\, ABC Industries\, Err bitreich.org 70 i- +1-919-555-1234 Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of this property with an alternate Err bitreich.org 70 i- representation of a MIME body part containing the contact Err bitreich.org 70 i- information, such as a vCard [RFC2426] embedded in a text/ Err bitreich.org 70 i- directory media type [RFC2425]: Err bitreich.org 70 i- Err bitreich.org 70 i- CONTACT;ALTREP="CID:part3.msg970930T083000SILVER@example.com": Err bitreich.org 70 i- Jim Dolittle\, ABC Industries\, +1-919-555-1234 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 110] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of this property referencing a network Err bitreich.org 70 i- resource, such as a vCard [RFC2426] object containing the contact Err bitreich.org 70 i- information: Err bitreich.org 70 i- Err bitreich.org 70 i- CONTACT;ALTREP="http://example.com/pdi/jdoe.vcf":Jim Err bitreich.org 70 i- Dolittle\, ABC Industries\, +1-919-555-1234 Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.4.3. Organizer Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: ORGANIZER Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property defines the organizer for a calendar Err bitreich.org 70 i- component. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: CAL-ADDRESS Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA, non-standard, language, common name, Err bitreich.org 70 i- directory entry reference, and sent-by property parameters can be Err bitreich.org 70 i- specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property MUST be specified in an iCalendar object Err bitreich.org 70 i- that specifies a group-scheduled calendar entity. This property Err bitreich.org 70 i- MUST be specified in an iCalendar object that specifies the Err bitreich.org 70 i- publication of a calendar user's busy time. This property MUST Err bitreich.org 70 i- NOT be specified in an iCalendar object that specifies only a time Err bitreich.org 70 i- zone definition or that defines calendar components that are not Err bitreich.org 70 i- group-scheduled components, but are components only on a single Err bitreich.org 70 i- user's calendar. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This property is specified within the "VEVENT", Err bitreich.org 70 i- "VTODO", and "VJOURNAL" calendar components to specify the Err bitreich.org 70 i- organizer of a group-scheduled calendar entity. The property is Err bitreich.org 70 i- specified within the "VFREEBUSY" calendar component to specify the Err bitreich.org 70 i- calendar user requesting the free or busy time. When publishing a Err bitreich.org 70 i- "VFREEBUSY" calendar component, the property is used to specify Err bitreich.org 70 i- the calendar that the published busy time came from. Err bitreich.org 70 i- Err bitreich.org 70 i- The property has the property parameters "CN", for specifying the Err bitreich.org 70 i- common or display name associated with the "Organizer", "DIR", for Err bitreich.org 70 i- specifying a pointer to the directory information associated with Err bitreich.org 70 i- the "Organizer", "SENT-BY", for specifying another calendar user Err bitreich.org 70 i- that is acting on behalf of the "Organizer". The non-standard Err bitreich.org 70 i- parameters may also be specified on this property. If the Err bitreich.org 70 i- "LANGUAGE" property parameter is specified, the identified Err bitreich.org 70 i- language applies to the "CN" parameter value. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 111] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- organizer = "ORGANIZER" orgparam ":" Err bitreich.org 70 i- cal-address CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- orgparam = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" cnparam) / (";" dirparam) / (";" sentbyparam) / Err bitreich.org 70 i- (";" languageparam) / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" other-param) Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- ORGANIZER;CN=John Smith:mailto:jsmith@example.com Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of this property with a pointer to the Err bitreich.org 70 i- directory information associated with the organizer: Err bitreich.org 70 i- Err bitreich.org 70 i- ORGANIZER;CN=JohnSmith;DIR="ldap://example.com:6666/o=DC%20Ass Err bitreich.org 70 i- ociates,c=US???(cn=John%20Smith)":mailto:jsmith@example.com Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of this property used by another Err bitreich.org 70 i- calendar user who is acting on behalf of the organizer, with Err bitreich.org 70 i- responses intended to be sent back to the organizer, not the other Err bitreich.org 70 i- calendar user: Err bitreich.org 70 i- Err bitreich.org 70 i- ORGANIZER;SENT-BY="mailto:jane_doe@example.com": Err bitreich.org 70 i- mailto:jsmith@example.com Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.4.4. Recurrence ID Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: RECURRENCE-ID Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property is used in conjunction with the "UID" and Err bitreich.org 70 i- "SEQUENCE" properties to identify a specific instance of a Err bitreich.org 70 i- recurring "VEVENT", "VTODO", or "VJOURNAL" calendar component. Err bitreich.org 70 i- The property value is the original value of the "DTSTART" property Err bitreich.org 70 i- of the recurrence instance. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 112] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: The default value type is DATE-TIME. The value type can Err bitreich.org 70 i- be set to a DATE value type. This property MUST have the same Err bitreich.org 70 i- value type as the "DTSTART" property contained within the Err bitreich.org 70 i- recurring component. Furthermore, this property MUST be specified Err bitreich.org 70 i- as a date with local time if and only if the "DTSTART" property Err bitreich.org 70 i- contained within the recurring component is specified as a date Err bitreich.org 70 i- with local time. Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA, non-standard, value data type, time zone Err bitreich.org 70 i- identifier, and recurrence identifier range parameters can be Err bitreich.org 70 i- specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property can be specified in an iCalendar object Err bitreich.org 70 i- containing a recurring calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: The full range of calendar components specified by a Err bitreich.org 70 i- recurrence set is referenced by referring to just the "UID" Err bitreich.org 70 i- property value corresponding to the calendar component. The Err bitreich.org 70 i- "RECURRENCE-ID" property allows the reference to an individual Err bitreich.org 70 i- instance within the recurrence set. Err bitreich.org 70 i- Err bitreich.org 70 i- If the value of the "DTSTART" property is a DATE type value, then Err bitreich.org 70 i- the value MUST be the calendar date for the recurrence instance. Err bitreich.org 70 i- Err bitreich.org 70 i- The DATE-TIME value is set to the time when the original Err bitreich.org 70 i- recurrence instance would occur; meaning that if the intent is to Err bitreich.org 70 i- change a Friday meeting to Thursday, the DATE-TIME is still set to Err bitreich.org 70 i- the original Friday meeting. Err bitreich.org 70 i- Err bitreich.org 70 i- The "RECURRENCE-ID" property is used in conjunction with the "UID" Err bitreich.org 70 i- and "SEQUENCE" properties to identify a particular instance of a Err bitreich.org 70 i- recurring event, to-do, or journal. For a given pair of "UID" and Err bitreich.org 70 i- "SEQUENCE" property values, the "RECURRENCE-ID" value for a Err bitreich.org 70 i- recurrence instance is fixed. Err bitreich.org 70 i- Err bitreich.org 70 i- The "RANGE" parameter is used to specify the effective range of Err bitreich.org 70 i- recurrence instances from the instance specified by the Err bitreich.org 70 i- "RECURRENCE-ID" property value. The value for the range parameter Err bitreich.org 70 i- can only be "THISANDFUTURE" to indicate a range defined by the Err bitreich.org 70 i- given recurrence instance and all subsequent instances. Err bitreich.org 70 i- Subsequent instances are determined by their "RECURRENCE-ID" value Err bitreich.org 70 i- and not their current scheduled start time. Subsequent instances Err bitreich.org 70 i- defined in separate components are not impacted by the given Err bitreich.org 70 i- recurrence instance. When the given recurrence instance is Err bitreich.org 70 i- rescheduled, all subsequent instances are also rescheduled by the Err bitreich.org 70 i- same time difference. For instance, if the given recurrence Err bitreich.org 70 i- instance is rescheduled to start 2 hours later, then all Err bitreich.org 70 i- subsequent instances are also rescheduled 2 hours later. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 113] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Similarly, if the duration of the given recurrence instance is Err bitreich.org 70 i- modified, then all subsequence instances are also modified to have Err bitreich.org 70 i- this same duration. Err bitreich.org 70 i- Err bitreich.org 70 i- Note: The "RANGE" parameter may not be appropriate to Err bitreich.org 70 i- reschedule specific subsequent instances of complex recurring Err bitreich.org 70 i- calendar component. Assuming an unbounded recurring calendar Err bitreich.org 70 i- component scheduled to occur on Mondays and Wednesdays, the Err bitreich.org 70 i- "RANGE" parameter could not be used to reschedule only the Err bitreich.org 70 i- future Monday instances to occur on Tuesday instead. In such Err bitreich.org 70 i- cases, the calendar application could simply truncate the Err bitreich.org 70 i- unbounded recurring calendar component (i.e., with the "COUNT" Err bitreich.org 70 i- or "UNTIL" rule parts), and create two new unbounded recurring Err bitreich.org 70 i- calendar components for the future instances. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- recurid = "RECURRENCE-ID" ridparam ":" ridval CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- ridparam = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" "VALUE" "=" ("DATE-TIME" / "DATE")) / Err bitreich.org 70 i- (";" tzidparam) / (";" rangeparam) / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" other-param) Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- ridval = date-time / date Err bitreich.org 70 i- ;Value MUST match value type Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following are examples of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- RECURRENCE-ID;VALUE=DATE:19960401 Err bitreich.org 70 i- Err bitreich.org 70 i- RECURRENCE-ID;RANGE=THISANDFUTURE:19960120T120000Z Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 114] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.4.5. Related To Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: RELATED-TO Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property is used to represent a relationship or Err bitreich.org 70 i- reference between one calendar component and another. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: TEXT Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA, non-standard, and relationship type Err bitreich.org 70 i- property parameters can be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property can be specified in the "VEVENT", Err bitreich.org 70 i- "VTODO", and "VJOURNAL" calendar components. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: The property value consists of the persistent, globally Err bitreich.org 70 i- unique identifier of another calendar component. This value would Err bitreich.org 70 i- be represented in a calendar component by the "UID" property. Err bitreich.org 70 i- Err bitreich.org 70 i- By default, the property value points to another calendar Err bitreich.org 70 i- component that has a PARENT relationship to the referencing Err bitreich.org 70 i- object. The "RELTYPE" property parameter is used to either Err bitreich.org 70 i- explicitly state the default PARENT relationship type to the Err bitreich.org 70 i- referenced calendar component or to override the default PARENT Err bitreich.org 70 i- relationship type and specify either a CHILD or SIBLING Err bitreich.org 70 i- relationship. The PARENT relationship indicates that the calendar Err bitreich.org 70 i- component is a subordinate of the referenced calendar component. Err bitreich.org 70 i- The CHILD relationship indicates that the calendar component is a Err bitreich.org 70 i- superior of the referenced calendar component. The SIBLING Err bitreich.org 70 i- relationship indicates that the calendar component is a peer of Err bitreich.org 70 i- the referenced calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Changes to a calendar component referenced by this property can Err bitreich.org 70 i- have an implicit impact on the related calendar component. For Err bitreich.org 70 i- example, if a group event changes its start or end date or time, Err bitreich.org 70 i- then the related, dependent events will need to have their start Err bitreich.org 70 i- and end dates changed in a corresponding way. Similarly, if a Err bitreich.org 70 i- PARENT calendar component is cancelled or deleted, then there is Err bitreich.org 70 i- an implied impact to the related CHILD calendar components. This Err bitreich.org 70 i- property is intended only to provide information on the Err bitreich.org 70 i- relationship of calendar components. It is up to the target Err bitreich.org 70 i- calendar system to maintain any property implications of this Err bitreich.org 70 i- relationship. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 115] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- related = "RELATED-TO" relparam ":" text CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- relparam = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" reltypeparam) / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" other-param) Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- RELATED-TO:jsmith.part7.19960817T083000.xyzMail@example.com Err bitreich.org 70 i- Err bitreich.org 70 i- RELATED-TO:19960401-080045-4000F192713-0052@example.com Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.4.6. Uniform Resource Locator Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: URL Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property defines a Uniform Resource Locator (URL) Err bitreich.org 70 i- associated with the iCalendar object. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: URI Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA and non-standard property parameters can Err bitreich.org 70 i- be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property can be specified once in the "VEVENT", Err bitreich.org 70 i- "VTODO", "VJOURNAL", or "VFREEBUSY" calendar components. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This property may be used in a calendar component to Err bitreich.org 70 i- convey a location where a more dynamic rendition of the calendar Err bitreich.org 70 i- information associated with the calendar component can be found. Err bitreich.org 70 i- This memo does not attempt to standardize the form of the URI, nor Err bitreich.org 70 i- the format of the resource pointed to by the property value. If Err bitreich.org 70 i- the URL property and Content-Location MIME header are both Err bitreich.org 70 i- specified, they MUST point to the same resource. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 116] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- url = "URL" urlparam ":" uri CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- urlparam = *(";" other-param) Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- URL:http://example.com/pub/calendars/jsmith/mytime.ics Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.4.7. Unique Identifier Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: UID Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property defines the persistent, globally unique Err bitreich.org 70 i- identifier for the calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: TEXT Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA and non-standard property parameters can Err bitreich.org 70 i- be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: The property MUST be specified in the "VEVENT", Err bitreich.org 70 i- "VTODO", "VJOURNAL", or "VFREEBUSY" calendar components. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: The "UID" itself MUST be a globally unique identifier. Err bitreich.org 70 i- The generator of the identifier MUST guarantee that the identifier Err bitreich.org 70 i- is unique. There are several algorithms that can be used to Err bitreich.org 70 i- accomplish this. A good method to assure uniqueness is to put the Err bitreich.org 70 i- domain name or a domain literal IP address of the host on which Err bitreich.org 70 i- the identifier was created on the right-hand side of an "@", and Err bitreich.org 70 i- on the left-hand side, put a combination of the current calendar Err bitreich.org 70 i- date and time of day (i.e., formatted in as a DATE-TIME value) Err bitreich.org 70 i- along with some other currently unique (perhaps sequential) Err bitreich.org 70 i- identifier available on the system (for example, a process id Err bitreich.org 70 i- number). Using a DATE-TIME value on the left-hand side and a Err bitreich.org 70 i- domain name or domain literal on the right-hand side makes it Err bitreich.org 70 i- possible to guarantee uniqueness since no two hosts should be Err bitreich.org 70 i- using the same domain name or IP address at the same time. Though Err bitreich.org 70 i- other algorithms will work, it is RECOMMENDED that the right-hand Err bitreich.org 70 i- side contain some domain identifier (either of the host itself or Err bitreich.org 70 i- otherwise) such that the generator of the message identifier can Err bitreich.org 70 i- guarantee the uniqueness of the left-hand side within the scope of Err bitreich.org 70 i- that domain. Err bitreich.org 70 i- Err bitreich.org 70 i- This is the method for correlating scheduling messages with the Err bitreich.org 70 i- referenced "VEVENT", "VTODO", or "VJOURNAL" calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 117] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- The full range of calendar components specified by a recurrence Err bitreich.org 70 i- set is referenced by referring to just the "UID" property value Err bitreich.org 70 i- corresponding to the calendar component. The "RECURRENCE-ID" Err bitreich.org 70 i- property allows the reference to an individual instance within the Err bitreich.org 70 i- recurrence set. Err bitreich.org 70 i- Err bitreich.org 70 i- This property is an important method for group-scheduling Err bitreich.org 70 i- applications to match requests with later replies, modifications, Err bitreich.org 70 i- or deletion requests. Calendaring and scheduling applications Err bitreich.org 70 i- MUST generate this property in "VEVENT", "VTODO", and "VJOURNAL" Err bitreich.org 70 i- calendar components to assure interoperability with other group- Err bitreich.org 70 i- scheduling applications. This identifier is created by the Err bitreich.org 70 i- calendar system that generates an iCalendar object. Err bitreich.org 70 i- Err bitreich.org 70 i- Implementations MUST be able to receive and persist values of at Err bitreich.org 70 i- least 255 octets for this property, but they MUST NOT truncate Err bitreich.org 70 i- values in the middle of a UTF-8 multi-octet sequence. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- uid = "UID" uidparam ":" text CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- uidparam = *(";" other-param) Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- UID:19960401T080045Z-4000F192713-0052@example.com Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.5. Recurrence Component Properties Err bitreich.org 70 i- Err bitreich.org 70 i- The following properties specify recurrence information in calendar Err bitreich.org 70 i- components. Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.5.1. Exception Date-Times Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: EXDATE Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property defines the list of DATE-TIME exceptions for Err bitreich.org 70 i- recurring events, to-dos, journal entries, or time zone Err bitreich.org 70 i- definitions. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: The default value type for this property is DATE-TIME. Err bitreich.org 70 i- The value type can be set to DATE. Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA, non-standard, value data type, and time Err bitreich.org 70 i- zone identifier property parameters can be specified on this Err bitreich.org 70 i- property. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 118] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property can be specified in recurring "VEVENT", Err bitreich.org 70 i- "VTODO", and "VJOURNAL" calendar components as well as in the Err bitreich.org 70 i- "STANDARD" and "DAYLIGHT" sub-components of the "VTIMEZONE" Err bitreich.org 70 i- calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: The exception dates, if specified, are used in Err bitreich.org 70 i- computing the recurrence set. The recurrence set is the complete Err bitreich.org 70 i- set of recurrence instances for a calendar component. The Err bitreich.org 70 i- recurrence set is generated by considering the initial "DTSTART" Err bitreich.org 70 i- property along with the "RRULE", "RDATE", and "EXDATE" properties Err bitreich.org 70 i- contained within the recurring component. The "DTSTART" property Err bitreich.org 70 i- defines the first instance in the recurrence set. The "DTSTART" Err bitreich.org 70 i- property value SHOULD match the pattern of the recurrence rule, if Err bitreich.org 70 i- specified. The recurrence set generated with a "DTSTART" property Err bitreich.org 70 i- value that doesn't match the pattern of the rule is undefined. Err bitreich.org 70 i- The final recurrence set is generated by gathering all of the Err bitreich.org 70 i- start DATE-TIME values generated by any of the specified "RRULE" Err bitreich.org 70 i- and "RDATE" properties, and then excluding any start DATE-TIME Err bitreich.org 70 i- values specified by "EXDATE" properties. This implies that start Err bitreich.org 70 i- DATE-TIME values specified by "EXDATE" properties take precedence Err bitreich.org 70 i- over those specified by inclusion properties (i.e., "RDATE" and Err bitreich.org 70 i- "RRULE"). When duplicate instances are generated by the "RRULE" Err bitreich.org 70 i- and "RDATE" properties, only one recurrence is considered. Err bitreich.org 70 i- Duplicate instances are ignored. Err bitreich.org 70 i- Err bitreich.org 70 i- The "EXDATE" property can be used to exclude the value specified Err bitreich.org 70 i- in "DTSTART". However, in such cases, the original "DTSTART" date Err bitreich.org 70 i- MUST still be maintained by the calendaring and scheduling system Err bitreich.org 70 i- because the original "DTSTART" value has inherent usage Err bitreich.org 70 i- dependencies by other properties such as the "RECURRENCE-ID". Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 119] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- exdate = "EXDATE" exdtparam ":" exdtval *("," exdtval) CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- exdtparam = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" "VALUE" "=" ("DATE-TIME" / "DATE")) / Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" tzidparam) / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" other-param) Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- exdtval = date-time / date Err bitreich.org 70 i- ;Value MUST match value type Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- EXDATE:19960402T010000Z,19960403T010000Z,19960404T010000Z Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.5.2. Recurrence Date-Times Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: RDATE Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property defines the list of DATE-TIME values for Err bitreich.org 70 i- recurring events, to-dos, journal entries, or time zone Err bitreich.org 70 i- definitions. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: The default value type for this property is DATE-TIME. Err bitreich.org 70 i- The value type can be set to DATE or PERIOD. Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA, non-standard, value data type, and time Err bitreich.org 70 i- zone identifier property parameters can be specified on this Err bitreich.org 70 i- property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property can be specified in recurring "VEVENT", Err bitreich.org 70 i- "VTODO", and "VJOURNAL" calendar components as well as in the Err bitreich.org 70 i- "STANDARD" and "DAYLIGHT" sub-components of the "VTIMEZONE" Err bitreich.org 70 i- calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This property can appear along with the "RRULE" Err bitreich.org 70 i- property to define an aggregate set of repeating occurrences. Err bitreich.org 70 i- When they both appear in a recurring component, the recurrence Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 120] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- instances are defined by the union of occurrences defined by both Err bitreich.org 70 i- the "RDATE" and "RRULE". Err bitreich.org 70 i- Err bitreich.org 70 i- The recurrence dates, if specified, are used in computing the Err bitreich.org 70 i- recurrence set. The recurrence set is the complete set of Err bitreich.org 70 i- recurrence instances for a calendar component. The recurrence set Err bitreich.org 70 i- is generated by considering the initial "DTSTART" property along Err bitreich.org 70 i- with the "RRULE", "RDATE", and "EXDATE" properties contained Err bitreich.org 70 i- within the recurring component. The "DTSTART" property defines Err bitreich.org 70 i- the first instance in the recurrence set. The "DTSTART" property Err bitreich.org 70 i- value SHOULD match the pattern of the recurrence rule, if Err bitreich.org 70 i- specified. The recurrence set generated with a "DTSTART" property Err bitreich.org 70 i- value that doesn't match the pattern of the rule is undefined. Err bitreich.org 70 i- The final recurrence set is generated by gathering all of the Err bitreich.org 70 i- start DATE-TIME values generated by any of the specified "RRULE" Err bitreich.org 70 i- and "RDATE" properties, and then excluding any start DATE-TIME Err bitreich.org 70 i- values specified by "EXDATE" properties. This implies that start Err bitreich.org 70 i- DATE-TIME values specified by "EXDATE" properties take precedence Err bitreich.org 70 i- over those specified by inclusion properties (i.e., "RDATE" and Err bitreich.org 70 i- "RRULE"). Where duplicate instances are generated by the "RRULE" Err bitreich.org 70 i- and "RDATE" properties, only one recurrence is considered. Err bitreich.org 70 i- Duplicate instances are ignored. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- rdate = "RDATE" rdtparam ":" rdtval *("," rdtval) CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- rdtparam = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" "VALUE" "=" ("DATE-TIME" / "DATE" / "PERIOD")) / Err bitreich.org 70 i- (";" tzidparam) / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" other-param) Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- rdtval = date-time / date / period Err bitreich.org 70 i- ;Value MUST match value type Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 121] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following are examples of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- RDATE:19970714T123000Z Err bitreich.org 70 i- RDATE;TZID=America/New_York:19970714T083000 Err bitreich.org 70 i- Err bitreich.org 70 i- RDATE;VALUE=PERIOD:19960403T020000Z/19960403T040000Z, Err bitreich.org 70 i- 19960404T010000Z/PT3H Err bitreich.org 70 i- Err bitreich.org 70 i- RDATE;VALUE=DATE:19970101,19970120,19970217,19970421 Err bitreich.org 70 i- 19970526,19970704,19970901,19971014,19971128,19971129,19971225 Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.5.3. Recurrence Rule Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: RRULE Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property defines a rule or repeating pattern for Err bitreich.org 70 i- recurring events, to-dos, journal entries, or time zone Err bitreich.org 70 i- definitions. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: RECUR Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA and non-standard property parameters can Err bitreich.org 70 i- be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property can be specified in recurring "VEVENT", Err bitreich.org 70 i- "VTODO", and "VJOURNAL" calendar components as well as in the Err bitreich.org 70 i- "STANDARD" and "DAYLIGHT" sub-components of the "VTIMEZONE" Err bitreich.org 70 i- calendar component, but it SHOULD NOT be specified more than once. Err bitreich.org 70 i- The recurrence set generated with multiple "RRULE" properties is Err bitreich.org 70 i- undefined. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: The recurrence rule, if specified, is used in computing Err bitreich.org 70 i- the recurrence set. The recurrence set is the complete set of Err bitreich.org 70 i- recurrence instances for a calendar component. The recurrence set Err bitreich.org 70 i- is generated by considering the initial "DTSTART" property along Err bitreich.org 70 i- with the "RRULE", "RDATE", and "EXDATE" properties contained Err bitreich.org 70 i- within the recurring component. The "DTSTART" property defines Err bitreich.org 70 i- the first instance in the recurrence set. The "DTSTART" property Err bitreich.org 70 i- value SHOULD be synchronized with the recurrence rule, if Err bitreich.org 70 i- specified. The recurrence set generated with a "DTSTART" property Err bitreich.org 70 i- value not synchronized with the recurrence rule is undefined. The Err bitreich.org 70 i- final recurrence set is generated by gathering all of the start Err bitreich.org 70 i- DATE-TIME values generated by any of the specified "RRULE" and Err bitreich.org 70 i- "RDATE" properties, and then excluding any start DATE-TIME values Err bitreich.org 70 i- specified by "EXDATE" properties. This implies that start DATE- Err bitreich.org 70 i- TIME values specified by "EXDATE" properties take precedence over Err bitreich.org 70 i- those specified by inclusion properties (i.e., "RDATE" and Err bitreich.org 70 i- "RRULE"). Where duplicate instances are generated by the "RRULE" Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 122] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- and "RDATE" properties, only one recurrence is considered. Err bitreich.org 70 i- Duplicate instances are ignored. Err bitreich.org 70 i- Err bitreich.org 70 i- The "DTSTART" property specified within the iCalendar object Err bitreich.org 70 i- defines the first instance of the recurrence. In most cases, a Err bitreich.org 70 i- "DTSTART" property of DATE-TIME value type used with a recurrence Err bitreich.org 70 i- rule, should be specified as a date with local time and time zone Err bitreich.org 70 i- reference to make sure all the recurrence instances start at the Err bitreich.org 70 i- same local time regardless of time zone changes. Err bitreich.org 70 i- Err bitreich.org 70 i- If the duration of the recurring component is specified with the Err bitreich.org 70 i- "DTEND" or "DUE" property, then the same exact duration will apply Err bitreich.org 70 i- to all the members of the generated recurrence set. Else, if the Err bitreich.org 70 i- duration of the recurring component is specified with the Err bitreich.org 70 i- "DURATION" property, then the same nominal duration will apply to Err bitreich.org 70 i- all the members of the generated recurrence set and the exact Err bitreich.org 70 i- duration of each recurrence instance will depend on its specific Err bitreich.org 70 i- start time. For example, recurrence instances of a nominal Err bitreich.org 70 i- duration of one day will have an exact duration of more or less Err bitreich.org 70 i- than 24 hours on a day where a time zone shift occurs. The Err bitreich.org 70 i- duration of a specific recurrence may be modified in an exception Err bitreich.org 70 i- component or simply by using an "RDATE" property of PERIOD value Err bitreich.org 70 i- type. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- rrule = "RRULE" rrulparam ":" recur CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- rrulparam = *(";" other-param) Err bitreich.org 70 i- Err bitreich.org 70 i- Example: All examples assume the Eastern United States time zone. Err bitreich.org 70 i- Err bitreich.org 70 i- Daily for 10 occurrences: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970902T090000 Err bitreich.org 70 i- RRULE:FREQ=DAILY;COUNT=10 Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EDT) September 2-11 Err bitreich.org 70 i- Err bitreich.org 70 i- Daily until December 24, 1997: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970902T090000 Err bitreich.org 70 i- RRULE:FREQ=DAILY;UNTIL=19971224T000000Z Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EDT) September 2-30;October 1-25 Err bitreich.org 70 i- (1997 9:00 AM EST) October 26-31;November 1-30;December 1-23 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 123] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Every other day - forever: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970902T090000 Err bitreich.org 70 i- RRULE:FREQ=DAILY;INTERVAL=2 Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EDT) September 2,4,6,8...24,26,28,30; Err bitreich.org 70 i- October 2,4,6...20,22,24 Err bitreich.org 70 i- (1997 9:00 AM EST) October 26,28,30; Err bitreich.org 70 i- November 1,3,5,7...25,27,29; Err bitreich.org 70 i- December 1,3,... Err bitreich.org 70 i- Err bitreich.org 70 i- Every 10 days, 5 occurrences: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970902T090000 Err bitreich.org 70 i- RRULE:FREQ=DAILY;INTERVAL=10;COUNT=5 Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EDT) September 2,12,22; Err bitreich.org 70 i- October 2,12 Err bitreich.org 70 i- Err bitreich.org 70 i- Every day in January, for 3 years: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19980101T090000 Err bitreich.org 70 i- Err bitreich.org 70 i- RRULE:FREQ=YEARLY;UNTIL=20000131T140000Z; Err bitreich.org 70 i- BYMONTH=1;BYDAY=SU,MO,TU,WE,TH,FR,SA Err bitreich.org 70 i- or Err bitreich.org 70 i- RRULE:FREQ=DAILY;UNTIL=20000131T140000Z;BYMONTH=1 Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1998 9:00 AM EST)January 1-31 Err bitreich.org 70 i- (1999 9:00 AM EST)January 1-31 Err bitreich.org 70 i- (2000 9:00 AM EST)January 1-31 Err bitreich.org 70 i- Err bitreich.org 70 i- Weekly for 10 occurrences: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970902T090000 Err bitreich.org 70 i- RRULE:FREQ=WEEKLY;COUNT=10 Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EDT) September 2,9,16,23,30;October 7,14,21 Err bitreich.org 70 i- (1997 9:00 AM EST) October 28;November 4 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 124] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Weekly until December 24, 1997: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970902T090000 Err bitreich.org 70 i- RRULE:FREQ=WEEKLY;UNTIL=19971224T000000Z Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EDT) September 2,9,16,23,30; Err bitreich.org 70 i- October 7,14,21 Err bitreich.org 70 i- (1997 9:00 AM EST) October 28; Err bitreich.org 70 i- November 4,11,18,25; Err bitreich.org 70 i- December 2,9,16,23 Err bitreich.org 70 i- Err bitreich.org 70 i- Every other week - forever: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970902T090000 Err bitreich.org 70 i- RRULE:FREQ=WEEKLY;INTERVAL=2;WKST=SU Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EDT) September 2,16,30; Err bitreich.org 70 i- October 14 Err bitreich.org 70 i- (1997 9:00 AM EST) October 28; Err bitreich.org 70 i- November 11,25; Err bitreich.org 70 i- December 9,23 Err bitreich.org 70 i- (1998 9:00 AM EST) January 6,20; Err bitreich.org 70 i- February 3, 17 Err bitreich.org 70 i- ... Err bitreich.org 70 i- Err bitreich.org 70 i- Weekly on Tuesday and Thursday for five weeks: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970902T090000 Err bitreich.org 70 i- RRULE:FREQ=WEEKLY;UNTIL=19971007T000000Z;WKST=SU;BYDAY=TU,TH Err bitreich.org 70 i- Err bitreich.org 70 i- or Err bitreich.org 70 i- Err bitreich.org 70 i- RRULE:FREQ=WEEKLY;COUNT=10;WKST=SU;BYDAY=TU,TH Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EDT) September 2,4,9,11,16,18,23,25,30; Err bitreich.org 70 i- October 2 Err bitreich.org 70 i- Err bitreich.org 70 i- Every other week on Monday, Wednesday, and Friday until December Err bitreich.org 70 i- 24, 1997, starting on Monday, September 1, 1997: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970901T090000 Err bitreich.org 70 i- RRULE:FREQ=WEEKLY;INTERVAL=2;UNTIL=19971224T000000Z;WKST=SU; Err bitreich.org 70 i- BYDAY=MO,WE,FR Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EDT) September 1,3,5,15,17,19,29; Err bitreich.org 70 i- October 1,3,13,15,17 Err bitreich.org 70 i- (1997 9:00 AM EST) October 27,29,31; Err bitreich.org 70 i- November 10,12,14,24,26,28; Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 125] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- December 8,10,12,22 Err bitreich.org 70 i- Err bitreich.org 70 i- Every other week on Tuesday and Thursday, for 8 occurrences: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970902T090000 Err bitreich.org 70 i- RRULE:FREQ=WEEKLY;INTERVAL=2;COUNT=8;WKST=SU;BYDAY=TU,TH Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EDT) September 2,4,16,18,30; Err bitreich.org 70 i- October 2,14,16 Err bitreich.org 70 i- Err bitreich.org 70 i- Monthly on the first Friday for 10 occurrences: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970905T090000 Err bitreich.org 70 i- RRULE:FREQ=MONTHLY;COUNT=10;BYDAY=1FR Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EDT) September 5;October 3 Err bitreich.org 70 i- (1997 9:00 AM EST) November 7;December 5 Err bitreich.org 70 i- (1998 9:00 AM EST) January 2;February 6;March 6;April 3 Err bitreich.org 70 i- (1998 9:00 AM EDT) May 1;June 5 Err bitreich.org 70 i- Err bitreich.org 70 i- Monthly on the first Friday until December 24, 1997: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970905T090000 Err bitreich.org 70 i- RRULE:FREQ=MONTHLY;UNTIL=19971224T000000Z;BYDAY=1FR Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EDT) September 5; October 3 Err bitreich.org 70 i- (1997 9:00 AM EST) November 7; December 5 Err bitreich.org 70 i- Err bitreich.org 70 i- Every other month on the first and last Sunday of the month for 10 Err bitreich.org 70 i- occurrences: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970907T090000 Err bitreich.org 70 i- RRULE:FREQ=MONTHLY;INTERVAL=2;COUNT=10;BYDAY=1SU,-1SU Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EDT) September 7,28 Err bitreich.org 70 i- (1997 9:00 AM EST) November 2,30 Err bitreich.org 70 i- (1998 9:00 AM EST) January 4,25;March 1,29 Err bitreich.org 70 i- (1998 9:00 AM EDT) May 3,31 Err bitreich.org 70 i- Err bitreich.org 70 i- Monthly on the second-to-last Monday of the month for 6 months: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970922T090000 Err bitreich.org 70 i- RRULE:FREQ=MONTHLY;COUNT=6;BYDAY=-2MO Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EDT) September 22;October 20 Err bitreich.org 70 i- (1997 9:00 AM EST) November 17;December 22 Err bitreich.org 70 i- (1998 9:00 AM EST) January 19;February 16 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 126] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Monthly on the third-to-the-last day of the month, forever: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970928T090000 Err bitreich.org 70 i- RRULE:FREQ=MONTHLY;BYMONTHDAY=-3 Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EDT) September 28 Err bitreich.org 70 i- (1997 9:00 AM EST) October 29;November 28;December 29 Err bitreich.org 70 i- (1998 9:00 AM EST) January 29;February 26 Err bitreich.org 70 i- ... Err bitreich.org 70 i- Err bitreich.org 70 i- Monthly on the 2nd and 15th of the month for 10 occurrences: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970902T090000 Err bitreich.org 70 i- RRULE:FREQ=MONTHLY;COUNT=10;BYMONTHDAY=2,15 Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EDT) September 2,15;October 2,15 Err bitreich.org 70 i- (1997 9:00 AM EST) November 2,15;December 2,15 Err bitreich.org 70 i- (1998 9:00 AM EST) January 2,15 Err bitreich.org 70 i- Err bitreich.org 70 i- Monthly on the first and last day of the month for 10 occurrences: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970930T090000 Err bitreich.org 70 i- RRULE:FREQ=MONTHLY;COUNT=10;BYMONTHDAY=1,-1 Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EDT) September 30;October 1 Err bitreich.org 70 i- (1997 9:00 AM EST) October 31;November 1,30;December 1,31 Err bitreich.org 70 i- (1998 9:00 AM EST) January 1,31;February 1 Err bitreich.org 70 i- Err bitreich.org 70 i- Every 18 months on the 10th thru 15th of the month for 10 Err bitreich.org 70 i- occurrences: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970910T090000 Err bitreich.org 70 i- RRULE:FREQ=MONTHLY;INTERVAL=18;COUNT=10;BYMONTHDAY=10,11,12, Err bitreich.org 70 i- 13,14,15 Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EDT) September 10,11,12,13,14,15 Err bitreich.org 70 i- (1999 9:00 AM EST) March 10,11,12,13 Err bitreich.org 70 i- Err bitreich.org 70 i- Every Tuesday, every other month: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970902T090000 Err bitreich.org 70 i- RRULE:FREQ=MONTHLY;INTERVAL=2;BYDAY=TU Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EDT) September 2,9,16,23,30 Err bitreich.org 70 i- (1997 9:00 AM EST) November 4,11,18,25 Err bitreich.org 70 i- (1998 9:00 AM EST) January 6,13,20,27;March 3,10,17,24,31 Err bitreich.org 70 i- ... Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 127] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Yearly in June and July for 10 occurrences: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970610T090000 Err bitreich.org 70 i- RRULE:FREQ=YEARLY;COUNT=10;BYMONTH=6,7 Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EDT) June 10;July 10 Err bitreich.org 70 i- (1998 9:00 AM EDT) June 10;July 10 Err bitreich.org 70 i- (1999 9:00 AM EDT) June 10;July 10 Err bitreich.org 70 i- (2000 9:00 AM EDT) June 10;July 10 Err bitreich.org 70 i- (2001 9:00 AM EDT) June 10;July 10 Err bitreich.org 70 i- Err bitreich.org 70 i- Note: Since none of the BYDAY, BYMONTHDAY, or BYYEARDAY Err bitreich.org 70 i- components are specified, the day is gotten from "DTSTART". Err bitreich.org 70 i- Err bitreich.org 70 i- Every other year on January, February, and March for 10 Err bitreich.org 70 i- occurrences: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970310T090000 Err bitreich.org 70 i- RRULE:FREQ=YEARLY;INTERVAL=2;COUNT=10;BYMONTH=1,2,3 Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EST) March 10 Err bitreich.org 70 i- (1999 9:00 AM EST) January 10;February 10;March 10 Err bitreich.org 70 i- (2001 9:00 AM EST) January 10;February 10;March 10 Err bitreich.org 70 i- (2003 9:00 AM EST) January 10;February 10;March 10 Err bitreich.org 70 i- Err bitreich.org 70 i- Every third year on the 1st, 100th, and 200th day for 10 Err bitreich.org 70 i- occurrences: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970101T090000 Err bitreich.org 70 i- RRULE:FREQ=YEARLY;INTERVAL=3;COUNT=10;BYYEARDAY=1,100,200 Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EST) January 1 Err bitreich.org 70 i- (1997 9:00 AM EDT) April 10;July 19 Err bitreich.org 70 i- (2000 9:00 AM EST) January 1 Err bitreich.org 70 i- (2000 9:00 AM EDT) April 9;July 18 Err bitreich.org 70 i- (2003 9:00 AM EST) January 1 Err bitreich.org 70 i- (2003 9:00 AM EDT) April 10;July 19 Err bitreich.org 70 i- (2006 9:00 AM EST) January 1 Err bitreich.org 70 i- Err bitreich.org 70 i- Every 20th Monday of the year, forever: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970519T090000 Err bitreich.org 70 i- RRULE:FREQ=YEARLY;BYDAY=20MO Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EDT) May 19 Err bitreich.org 70 i- (1998 9:00 AM EDT) May 18 Err bitreich.org 70 i- (1999 9:00 AM EDT) May 17 Err bitreich.org 70 i- ... Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 128] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Monday of week number 20 (where the default start of the week is Err bitreich.org 70 i- Monday), forever: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970512T090000 Err bitreich.org 70 i- RRULE:FREQ=YEARLY;BYWEEKNO=20;BYDAY=MO Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EDT) May 12 Err bitreich.org 70 i- (1998 9:00 AM EDT) May 11 Err bitreich.org 70 i- (1999 9:00 AM EDT) May 17 Err bitreich.org 70 i- ... Err bitreich.org 70 i- Err bitreich.org 70 i- Every Thursday in March, forever: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970313T090000 Err bitreich.org 70 i- RRULE:FREQ=YEARLY;BYMONTH=3;BYDAY=TH Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EST) March 13,20,27 Err bitreich.org 70 i- (1998 9:00 AM EST) March 5,12,19,26 Err bitreich.org 70 i- (1999 9:00 AM EST) March 4,11,18,25 Err bitreich.org 70 i- ... Err bitreich.org 70 i- Err bitreich.org 70 i- Every Thursday, but only during June, July, and August, forever: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970605T090000 Err bitreich.org 70 i- RRULE:FREQ=YEARLY;BYDAY=TH;BYMONTH=6,7,8 Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EDT) June 5,12,19,26;July 3,10,17,24,31; Err bitreich.org 70 i- August 7,14,21,28 Err bitreich.org 70 i- (1998 9:00 AM EDT) June 4,11,18,25;July 2,9,16,23,30; Err bitreich.org 70 i- August 6,13,20,27 Err bitreich.org 70 i- (1999 9:00 AM EDT) June 3,10,17,24;July 1,8,15,22,29; Err bitreich.org 70 i- August 5,12,19,26 Err bitreich.org 70 i- ... Err bitreich.org 70 i- Err bitreich.org 70 i- Every Friday the 13th, forever: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970902T090000 Err bitreich.org 70 i- EXDATE;TZID=America/New_York:19970902T090000 Err bitreich.org 70 i- RRULE:FREQ=MONTHLY;BYDAY=FR;BYMONTHDAY=13 Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1998 9:00 AM EST) February 13;March 13;November 13 Err bitreich.org 70 i- (1999 9:00 AM EDT) August 13 Err bitreich.org 70 i- (2000 9:00 AM EDT) October 13 Err bitreich.org 70 i- ... Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 129] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- The first Saturday that follows the first Sunday of the month, Err bitreich.org 70 i- forever: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970913T090000 Err bitreich.org 70 i- RRULE:FREQ=MONTHLY;BYDAY=SA;BYMONTHDAY=7,8,9,10,11,12,13 Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EDT) September 13;October 11 Err bitreich.org 70 i- (1997 9:00 AM EST) November 8;December 13 Err bitreich.org 70 i- (1998 9:00 AM EST) January 10;February 7;March 7 Err bitreich.org 70 i- (1998 9:00 AM EDT) April 11;May 9;June 13... Err bitreich.org 70 i- ... Err bitreich.org 70 i- Err bitreich.org 70 i- Every 4 years, the first Tuesday after a Monday in November, Err bitreich.org 70 i- forever (U.S. Presidential Election day): Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19961105T090000 Err bitreich.org 70 i- RRULE:FREQ=YEARLY;INTERVAL=4;BYMONTH=11;BYDAY=TU; Err bitreich.org 70 i- BYMONTHDAY=2,3,4,5,6,7,8 Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1996 9:00 AM EST) November 5 Err bitreich.org 70 i- (2000 9:00 AM EST) November 7 Err bitreich.org 70 i- (2004 9:00 AM EST) November 2 Err bitreich.org 70 i- ... Err bitreich.org 70 i- Err bitreich.org 70 i- The third instance into the month of one of Tuesday, Wednesday, or Err bitreich.org 70 i- Thursday, for the next 3 months: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970904T090000 Err bitreich.org 70 i- RRULE:FREQ=MONTHLY;COUNT=3;BYDAY=TU,WE,TH;BYSETPOS=3 Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EDT) September 4;October 7 Err bitreich.org 70 i- (1997 9:00 AM EST) November 6 Err bitreich.org 70 i- Err bitreich.org 70 i- The second-to-last weekday of the month: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970929T090000 Err bitreich.org 70 i- RRULE:FREQ=MONTHLY;BYDAY=MO,TU,WE,TH,FR;BYSETPOS=-2 Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 9:00 AM EDT) September 29 Err bitreich.org 70 i- (1997 9:00 AM EST) October 30;November 27;December 30 Err bitreich.org 70 i- (1998 9:00 AM EST) January 29;February 26;March 30 Err bitreich.org 70 i- ... Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 130] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Every 3 hours from 9:00 AM to 5:00 PM on a specific day: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970902T090000 Err bitreich.org 70 i- RRULE:FREQ=HOURLY;INTERVAL=3;UNTIL=19970902T170000Z Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (September 2, 1997 EDT) 09:00,12:00,15:00 Err bitreich.org 70 i- Err bitreich.org 70 i- Every 15 minutes for 6 occurrences: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970902T090000 Err bitreich.org 70 i- RRULE:FREQ=MINUTELY;INTERVAL=15;COUNT=6 Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (September 2, 1997 EDT) 09:00,09:15,09:30,09:45,10:00,10:15 Err bitreich.org 70 i- Err bitreich.org 70 i- Every hour and a half for 4 occurrences: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970902T090000 Err bitreich.org 70 i- RRULE:FREQ=MINUTELY;INTERVAL=90;COUNT=4 Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (September 2, 1997 EDT) 09:00,10:30;12:00;13:30 Err bitreich.org 70 i- Err bitreich.org 70 i- Every 20 minutes from 9:00 AM to 4:40 PM every day: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970902T090000 Err bitreich.org 70 i- RRULE:FREQ=DAILY;BYHOUR=9,10,11,12,13,14,15,16;BYMINUTE=0,20,40 Err bitreich.org 70 i- or Err bitreich.org 70 i- RRULE:FREQ=MINUTELY;INTERVAL=20;BYHOUR=9,10,11,12,13,14,15,16 Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (September 2, 1997 EDT) 9:00,9:20,9:40,10:00,10:20, Err bitreich.org 70 i- ... 16:00,16:20,16:40 Err bitreich.org 70 i- (September 3, 1997 EDT) 9:00,9:20,9:40,10:00,10:20, Err bitreich.org 70 i- ...16:00,16:20,16:40 Err bitreich.org 70 i- ... Err bitreich.org 70 i- Err bitreich.org 70 i- An example where the days generated makes a difference because of Err bitreich.org 70 i- WKST: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970805T090000 Err bitreich.org 70 i- RRULE:FREQ=WEEKLY;INTERVAL=2;COUNT=4;BYDAY=TU,SU;WKST=MO Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 EDT) August 5,10,19,24 Err bitreich.org 70 i- Err bitreich.org 70 i- changing only WKST from MO to SU, yields different results... Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19970805T090000 Err bitreich.org 70 i- RRULE:FREQ=WEEKLY;INTERVAL=2;COUNT=4;BYDAY=TU,SU;WKST=SU Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (1997 EDT) August 5,17,19,31 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 131] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- An example where an invalid date (i.e., February 30) is ignored. Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTART;TZID=America/New_York:20070115T090000 Err bitreich.org 70 i- RRULE:FREQ=MONTHLY;BYMONTHDAY=15,30;COUNT=5 Err bitreich.org 70 i- Err bitreich.org 70 i- ==> (2007 EST) January 15,30 Err bitreich.org 70 i- (2007 EST) February 15 Err bitreich.org 70 i- (2007 EDT) March 15,30 Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.6. Alarm Component Properties Err bitreich.org 70 i- Err bitreich.org 70 i- The following properties specify alarm information in calendar Err bitreich.org 70 i- components. Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.6.1. Action Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: ACTION Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property defines the action to be invoked when an Err bitreich.org 70 i- alarm is triggered. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: TEXT Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA and non-standard property parameters can Err bitreich.org 70 i- be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property MUST be specified once in a "VALARM" Err bitreich.org 70 i- calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: Each "VALARM" calendar component has a particular type Err bitreich.org 70 i- of action with which it is associated. This property specifies Err bitreich.org 70 i- the type of action. Applications MUST ignore alarms with x-name Err bitreich.org 70 i- and iana-token values they don't recognize. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- action = "ACTION" actionparam ":" actionvalue CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- actionparam = *(";" other-param) Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- actionvalue = "AUDIO" / "DISPLAY" / "EMAIL" Err bitreich.org 70 i- / iana-token / x-name Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following are examples of this property in a "VALARM" Err bitreich.org 70 i- calendar component: Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 132] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- ACTION:AUDIO Err bitreich.org 70 i- Err bitreich.org 70 i- ACTION:DISPLAY Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.6.2. Repeat Count Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: REPEAT Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property defines the number of times the alarm should Err bitreich.org 70 i- be repeated, after the initial trigger. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: INTEGER Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA and non-standard property parameters can Err bitreich.org 70 i- be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property can be specified in a "VALARM" calendar Err bitreich.org 70 i- component. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This property defines the number of times an alarm Err bitreich.org 70 i- should be repeated after its initial trigger. If the alarm Err bitreich.org 70 i- triggers more than once, then this property MUST be specified Err bitreich.org 70 i- along with the "DURATION" property. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- repeat = "REPEAT" repparam ":" integer CRLF Err bitreich.org 70 i- ;Default is "0", zero. Err bitreich.org 70 i- Err bitreich.org 70 i- repparam = *(";" other-param) Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property for an alarm Err bitreich.org 70 i- that repeats 4 additional times with a 5-minute delay after the Err bitreich.org 70 i- initial triggering of the alarm: Err bitreich.org 70 i- Err bitreich.org 70 i- REPEAT:4 Err bitreich.org 70 i- DURATION:PT5M Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.6.3. Trigger Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: TRIGGER Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property specifies when an alarm will trigger. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: The default value type is DURATION. The value type can Err bitreich.org 70 i- be set to a DATE-TIME value type, in which case the value MUST Err bitreich.org 70 i- specify a UTC-formatted DATE-TIME value. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 133] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA, non-standard, value data type, time zone Err bitreich.org 70 i- identifier, or trigger relationship property parameters can be Err bitreich.org 70 i- specified on this property. The trigger relationship property Err bitreich.org 70 i- parameter MUST only be specified when the value type is Err bitreich.org 70 i- "DURATION". Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property MUST be specified in the "VALARM" Err bitreich.org 70 i- calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This property defines when an alarm will trigger. The Err bitreich.org 70 i- default value type is DURATION, specifying a relative time for the Err bitreich.org 70 i- trigger of the alarm. The default duration is relative to the Err bitreich.org 70 i- start of an event or to-do with which the alarm is associated. Err bitreich.org 70 i- The duration can be explicitly set to trigger from either the end Err bitreich.org 70 i- or the start of the associated event or to-do with the "RELATED" Err bitreich.org 70 i- parameter. A value of START will set the alarm to trigger off the Err bitreich.org 70 i- start of the associated event or to-do. A value of END will set Err bitreich.org 70 i- the alarm to trigger off the end of the associated event or to-do. Err bitreich.org 70 i- Err bitreich.org 70 i- Either a positive or negative duration may be specified for the Err bitreich.org 70 i- "TRIGGER" property. An alarm with a positive duration is Err bitreich.org 70 i- triggered after the associated start or end of the event or to-do. Err bitreich.org 70 i- An alarm with a negative duration is triggered before the Err bitreich.org 70 i- associated start or end of the event or to-do. Err bitreich.org 70 i- Err bitreich.org 70 i- The "RELATED" property parameter is not valid if the value type of Err bitreich.org 70 i- the property is set to DATE-TIME (i.e., for an absolute date and Err bitreich.org 70 i- time alarm trigger). If a value type of DATE-TIME is specified, Err bitreich.org 70 i- then the property value MUST be specified in the UTC time format. Err bitreich.org 70 i- If an absolute trigger is specified on an alarm for a recurring Err bitreich.org 70 i- event or to-do, then the alarm will only trigger for the specified Err bitreich.org 70 i- absolute DATE-TIME, along with any specified repeating instances. Err bitreich.org 70 i- Err bitreich.org 70 i- If the trigger is set relative to START, then the "DTSTART" Err bitreich.org 70 i- property MUST be present in the associated "VEVENT" or "VTODO" Err bitreich.org 70 i- calendar component. If an alarm is specified for an event with Err bitreich.org 70 i- the trigger set relative to the END, then the "DTEND" property or Err bitreich.org 70 i- the "DTSTART" and "DURATION " properties MUST be present in the Err bitreich.org 70 i- associated "VEVENT" calendar component. If the alarm is specified Err bitreich.org 70 i- for a to-do with a trigger set relative to the END, then either Err bitreich.org 70 i- the "DUE" property or the "DTSTART" and "DURATION " properties Err bitreich.org 70 i- MUST be present in the associated "VTODO" calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Alarms specified in an event or to-do that is defined in terms of Err bitreich.org 70 i- a DATE value type will be triggered relative to 00:00:00 of the Err bitreich.org 70 i- user's configured time zone on the specified date, or relative to Err bitreich.org 70 i- 00:00:00 UTC on the specified date if no configured time zone can Err bitreich.org 70 i- be found for the user. For example, if "DTSTART" is a DATE value Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 134] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- set to 19980205 then the duration trigger will be relative to Err bitreich.org 70 i- 19980205T000000 America/New_York for a user configured with the Err bitreich.org 70 i- America/New_York time zone. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- trigger = "TRIGGER" (trigrel / trigabs) CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- trigrel = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following are OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" "VALUE" "=" "DURATION") / Err bitreich.org 70 i- (";" trigrelparam) / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" other-param) Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) ":" dur-value Err bitreich.org 70 i- Err bitreich.org 70 i- trigabs = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is REQUIRED, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" "VALUE" "=" "DATE-TIME") / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" other-param) Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) ":" date-time Err bitreich.org 70 i- Err bitreich.org 70 i- Example: A trigger set 15 minutes prior to the start of the event or Err bitreich.org 70 i- to-do. Err bitreich.org 70 i- Err bitreich.org 70 i- TRIGGER:-PT15M Err bitreich.org 70 i- Err bitreich.org 70 i- A trigger set five minutes after the end of an event or the due Err bitreich.org 70 i- date of a to-do. Err bitreich.org 70 i- Err bitreich.org 70 i- TRIGGER;RELATED=END:PT5M Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 135] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- A trigger set to an absolute DATE-TIME. Err bitreich.org 70 i- Err bitreich.org 70 i- TRIGGER;VALUE=DATE-TIME:19980101T050000Z Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.7. Change Management Component Properties Err bitreich.org 70 i- Err bitreich.org 70 i- The following properties specify change management information in Err bitreich.org 70 i- calendar components. Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.7.1. Date-Time Created Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: CREATED Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property specifies the date and time that the calendar Err bitreich.org 70 i- information was created by the calendar user agent in the calendar Err bitreich.org 70 i- store. Err bitreich.org 70 i- Err bitreich.org 70 i- Note: This is analogous to the creation date and time for a Err bitreich.org 70 i- file in the file system. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: DATE-TIME Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA and non-standard property parameters can Err bitreich.org 70 i- be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: The property can be specified once in "VEVENT", Err bitreich.org 70 i- "VTODO", or "VJOURNAL" calendar components. The value MUST be Err bitreich.org 70 i- specified as a date with UTC time. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This property specifies the date and time that the Err bitreich.org 70 i- calendar information was created by the calendar user agent in the Err bitreich.org 70 i- calendar store. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- created = "CREATED" creaparam ":" date-time CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- creaparam = *(";" other-param) Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- CREATED:19960329T133000Z Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 136] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.7.2. Date-Time Stamp Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: DTSTAMP Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: In the case of an iCalendar object that specifies a Err bitreich.org 70 i- "METHOD" property, this property specifies the date and time that Err bitreich.org 70 i- the instance of the iCalendar object was created. In the case of Err bitreich.org 70 i- an iCalendar object that doesn't specify a "METHOD" property, this Err bitreich.org 70 i- property specifies the date and time that the information Err bitreich.org 70 i- associated with the calendar component was last revised in the Err bitreich.org 70 i- calendar store. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: DATE-TIME Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA and non-standard property parameters can Err bitreich.org 70 i- be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property MUST be included in the "VEVENT", Err bitreich.org 70 i- "VTODO", "VJOURNAL", or "VFREEBUSY" calendar components. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: The value MUST be specified in the UTC time format. Err bitreich.org 70 i- Err bitreich.org 70 i- This property is also useful to protocols such as [2447bis] that Err bitreich.org 70 i- have inherent latency issues with the delivery of content. This Err bitreich.org 70 i- property will assist in the proper sequencing of messages Err bitreich.org 70 i- containing iCalendar objects. Err bitreich.org 70 i- Err bitreich.org 70 i- In the case of an iCalendar object that specifies a "METHOD" Err bitreich.org 70 i- property, this property differs from the "CREATED" and "LAST- Err bitreich.org 70 i- MODIFIED" properties. These two properties are used to specify Err bitreich.org 70 i- when the particular calendar data in the calendar store was Err bitreich.org 70 i- created and last modified. This is different than when the Err bitreich.org 70 i- iCalendar object representation of the calendar service Err bitreich.org 70 i- information was created or last modified. Err bitreich.org 70 i- Err bitreich.org 70 i- In the case of an iCalendar object that doesn't specify a "METHOD" Err bitreich.org 70 i- property, this property is equivalent to the "LAST-MODIFIED" Err bitreich.org 70 i- property. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- dtstamp = "DTSTAMP" stmparam ":" date-time CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- stmparam = *(";" other-param) Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 137] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Example: Err bitreich.org 70 i- Err bitreich.org 70 i- DTSTAMP:19971210T080000Z Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.7.3. Last Modified Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: LAST-MODIFIED Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property specifies the date and time that the Err bitreich.org 70 i- information associated with the calendar component was last Err bitreich.org 70 i- revised in the calendar store. Err bitreich.org 70 i- Err bitreich.org 70 i- Note: This is analogous to the modification date and time for a Err bitreich.org 70 i- file in the file system. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: DATE-TIME Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA and non-standard property parameters can Err bitreich.org 70 i- be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property can be specified in the "VEVENT", Err bitreich.org 70 i- "VTODO", "VJOURNAL", or "VTIMEZONE" calendar components. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: The property value MUST be specified in the UTC time Err bitreich.org 70 i- format. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- last-mod = "LAST-MODIFIED" lstparam ":" date-time CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- lstparam = *(";" other-param) Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property: Err bitreich.org 70 i- Err bitreich.org 70 i- LAST-MODIFIED:19960817T133000Z Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.7.4. Sequence Number Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: SEQUENCE Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property defines the revision sequence number of the Err bitreich.org 70 i- calendar component within a sequence of revisions. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: INTEGER Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA and non-standard property parameters can Err bitreich.org 70 i- be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 138] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: The property can be specified in "VEVENT", "VTODO", or Err bitreich.org 70 i- "VJOURNAL" calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: When a calendar component is created, its sequence Err bitreich.org 70 i- number is 0. It is monotonically incremented by the "Organizer's" Err bitreich.org 70 i- CUA each time the "Organizer" makes a significant revision to the Err bitreich.org 70 i- calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- The "Organizer" includes this property in an iCalendar object that Err bitreich.org 70 i- it sends to an "Attendee" to specify the current version of the Err bitreich.org 70 i- calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- The "Attendee" includes this property in an iCalendar object that Err bitreich.org 70 i- it sends to the "Organizer" to specify the version of the calendar Err bitreich.org 70 i- component to which the "Attendee" is referring. Err bitreich.org 70 i- Err bitreich.org 70 i- A change to the sequence number is not the mechanism that an Err bitreich.org 70 i- "Organizer" uses to request a response from the "Attendees". The Err bitreich.org 70 i- "RSVP" parameter on the "ATTENDEE" property is used by the Err bitreich.org 70 i- "Organizer" to indicate that a response from the "Attendees" is Err bitreich.org 70 i- requested. Err bitreich.org 70 i- Err bitreich.org 70 i- Recurrence instances of a recurring component MAY have different Err bitreich.org 70 i- sequence numbers. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- seq = "SEQUENCE" seqparam ":" integer CRLF Err bitreich.org 70 i- ; Default is "0" Err bitreich.org 70 i- Err bitreich.org 70 i- seqparam = *(";" other-param) Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following is an example of this property for a calendar Err bitreich.org 70 i- component that was just created by the "Organizer": Err bitreich.org 70 i- Err bitreich.org 70 i- SEQUENCE:0 Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of this property for a calendar Err bitreich.org 70 i- component that has been revised two different times by the Err bitreich.org 70 i- "Organizer": Err bitreich.org 70 i- Err bitreich.org 70 i- SEQUENCE:2 Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.8. Miscellaneous Component Properties Err bitreich.org 70 i- Err bitreich.org 70 i- The following properties specify information about a number of Err bitreich.org 70 i- miscellaneous features of calendar components. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 139] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.8.1. IANA Properties Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: An IANA-registered property name Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: The default value type is TEXT. The value type can be Err bitreich.org 70 i- set to any value type. Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: Any parameter can be specified on this Err bitreich.org 70 i- property. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This specification allows other properties registered Err bitreich.org 70 i- with IANA to be specified in any calendar components. Compliant Err bitreich.org 70 i- applications are expected to be able to parse these other IANA- Err bitreich.org 70 i- registered properties but can ignore them. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- iana-prop = iana-token *(";" icalparameter) ":" value CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following are examples of properties that might be Err bitreich.org 70 i- registered to IANA: Err bitreich.org 70 i- Err bitreich.org 70 i- DRESSCODE:CASUAL Err bitreich.org 70 i- Err bitreich.org 70 i- NON-SMOKING;VALUE=BOOLEAN:TRUE Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.8.2. Non-Standard Properties Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: Any property name with a "X-" prefix Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This class of property provides a framework for defining Err bitreich.org 70 i- non-standard properties. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: The default value type is TEXT. The value type can be Err bitreich.org 70 i- set to any value type. Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA, non-standard, and language property Err bitreich.org 70 i- parameters can be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This property can be specified in any calendar Err bitreich.org 70 i- component. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: The MIME Calendaring and Scheduling Content Type Err bitreich.org 70 i- provides a "standard mechanism for doing non-standard things". Err bitreich.org 70 i- This extension support is provided for implementers to "push the Err bitreich.org 70 i- envelope" on the existing version of the memo. Extension Err bitreich.org 70 i- properties are specified by property and/or property parameter Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 140] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- names that have the prefix text of "X-" (the two-character Err bitreich.org 70 i- sequence: LATIN CAPITAL LETTER X character followed by the HYPHEN- Err bitreich.org 70 i- MINUS character). It is recommended that vendors concatenate onto Err bitreich.org 70 i- this sentinel another short prefix text to identify the vendor. Err bitreich.org 70 i- This will facilitate readability of the extensions and minimize Err bitreich.org 70 i- possible collision of names between different vendors. User Err bitreich.org 70 i- agents that support this content type are expected to be able to Err bitreich.org 70 i- parse the extension properties and property parameters but can Err bitreich.org 70 i- ignore them. Err bitreich.org 70 i- Err bitreich.org 70 i- At present, there is no registration authority for names of Err bitreich.org 70 i- extension properties and property parameters. The value type for Err bitreich.org 70 i- this property is TEXT. Optionally, the value type can be any of Err bitreich.org 70 i- the other valid value types. Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- x-prop = x-name *(";" icalparameter) ":" value CRLF Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following might be the ABC vendor's extension for an Err bitreich.org 70 i- audio-clip form of subject property: Err bitreich.org 70 i- Err bitreich.org 70 i- X-ABC-MMSUBJ;VALUE=URI;FMTTYPE=audio/basic:http://www.example. Err bitreich.org 70 i- org/mysubj.au Err bitreich.org 70 i- Err bitreich.org 70 i-3.8.8.3. Request Status Err bitreich.org 70 i- Err bitreich.org 70 i- Property Name: REQUEST-STATUS Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This property defines the status code returned for a Err bitreich.org 70 i- scheduling request. Err bitreich.org 70 i- Err bitreich.org 70 i- Value Type: TEXT Err bitreich.org 70 i- Err bitreich.org 70 i- Property Parameters: IANA, non-standard, and language property Err bitreich.org 70 i- parameters can be specified on this property. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: The property can be specified in the "VEVENT", "VTODO", Err bitreich.org 70 i- "VJOURNAL", or "VFREEBUSY" calendar component. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: This property is used to return status code information Err bitreich.org 70 i- related to the processing of an associated iCalendar object. The Err bitreich.org 70 i- value type for this property is TEXT. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 141] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- The value consists of a short return status component, a longer Err bitreich.org 70 i- return status description component, and optionally a status- Err bitreich.org 70 i- specific data component. The components of the value are Err bitreich.org 70 i- separated by the SEMICOLON character. Err bitreich.org 70 i- Err bitreich.org 70 i- The short return status is a PERIOD character separated pair or Err bitreich.org 70 i- 3-tuple of integers. For example, "3.1" or "3.1.1". The Err bitreich.org 70 i- successive levels of integers provide for a successive level of Err bitreich.org 70 i- status code granularity. Err bitreich.org 70 i- Err bitreich.org 70 i- The following are initial classes for the return status code. Err bitreich.org 70 i- Individual iCalendar object methods will define specific return Err bitreich.org 70 i- status codes for these classes. In addition, other classes for Err bitreich.org 70 i- the return status code may be defined using the registration Err bitreich.org 70 i- process defined later in this memo. Err bitreich.org 70 i- Err bitreich.org 70 i- +--------+----------------------------------------------------------+ Err bitreich.org 70 i- | Short | Longer Return Status Description | Err bitreich.org 70 i- | Return | | Err bitreich.org 70 i- | Status | | Err bitreich.org 70 i- | Code | | Err bitreich.org 70 i- +--------+----------------------------------------------------------+ Err bitreich.org 70 i- | 1.xx | Preliminary success. This class of status code | Err bitreich.org 70 i- | | indicates that the request has been initially processed | Err bitreich.org 70 i- | | but that completion is pending. | Err bitreich.org 70 i- | | | Err bitreich.org 70 i- | 2.xx | Successful. This class of status code indicates that | Err bitreich.org 70 i- | | the request was completed successfully. However, the | Err bitreich.org 70 i- | | exact status code can indicate that a fallback has been | Err bitreich.org 70 i- | | taken. | Err bitreich.org 70 i- | | | Err bitreich.org 70 i- | 3.xx | Client Error. This class of status code indicates that | Err bitreich.org 70 i- | | the request was not successful. The error is the result | Err bitreich.org 70 i- | | of either a syntax or a semantic error in the client- | Err bitreich.org 70 i- | | formatted request. Request should not be retried until | Err bitreich.org 70 i- | | the condition in the request is corrected. | Err bitreich.org 70 i- | | | Err bitreich.org 70 i- | 4.xx | Scheduling Error. This class of status code indicates | Err bitreich.org 70 i- | | that the request was not successful. Some sort of error | Err bitreich.org 70 i- | | occurred within the calendaring and scheduling service, | Err bitreich.org 70 i- | | not directly related to the request itself. | Err bitreich.org 70 i- +--------+----------------------------------------------------------+ Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 142] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Format Definition: This property is defined by the following Err bitreich.org 70 i- notation: Err bitreich.org 70 i- Err bitreich.org 70 i- rstatus = "REQUEST-STATUS" rstatparam ":" Err bitreich.org 70 i- statcode ";" statdesc [";" extdata] Err bitreich.org 70 i- Err bitreich.org 70 i- rstatparam = *( Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; but MUST NOT occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" languageparam) / Err bitreich.org 70 i- ; Err bitreich.org 70 i- ; The following is OPTIONAL, Err bitreich.org 70 i- ; and MAY occur more than once. Err bitreich.org 70 i- ; Err bitreich.org 70 i- (";" other-param) Err bitreich.org 70 i- ; Err bitreich.org 70 i- ) Err bitreich.org 70 i- Err bitreich.org 70 i- statcode = 1*DIGIT 1*2("." 1*DIGIT) Err bitreich.org 70 i- ;Hierarchical, numeric return status code Err bitreich.org 70 i- Err bitreich.org 70 i- statdesc = text Err bitreich.org 70 i- ;Textual status description Err bitreich.org 70 i- Err bitreich.org 70 i- extdata = text Err bitreich.org 70 i- ;Textual exception data. For example, the offending property Err bitreich.org 70 i- ;name and value or complete property line. Err bitreich.org 70 i- Err bitreich.org 70 i- Example: The following are some possible examples of this property. Err bitreich.org 70 i- Err bitreich.org 70 i- The COMMA and SEMICOLON separator characters in the property value Err bitreich.org 70 i- are BACKSLASH character escaped because they appear in a text Err bitreich.org 70 i- value. Err bitreich.org 70 i- Err bitreich.org 70 i- REQUEST-STATUS:2.0;Success Err bitreich.org 70 i- Err bitreich.org 70 i- REQUEST-STATUS:3.1;Invalid property value;DTSTART:96-Apr-01 Err bitreich.org 70 i- Err bitreich.org 70 i- REQUEST-STATUS:2.8; Success\, repeating event ignored. Scheduled Err bitreich.org 70 i- as a single event.;RRULE:FREQ=WEEKLY\;INTERVAL=2 Err bitreich.org 70 i- Err bitreich.org 70 i- REQUEST-STATUS:4.1;Event conflict. Date-time is busy. Err bitreich.org 70 i- Err bitreich.org 70 i- REQUEST-STATUS:3.7;Invalid calendar user;ATTENDEE: Err bitreich.org 70 i- mailto:jsmith@example.com Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 143] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-4. iCalendar Object Examples Err bitreich.org 70 i- Err bitreich.org 70 i- The following examples are provided as an informational source of Err bitreich.org 70 i- illustrative iCalendar objects consistent with this content type. Err bitreich.org 70 i- Err bitreich.org 70 i- The following example specifies a three-day conference that begins at Err bitreich.org 70 i- 2:30 P.M. UTC, September 18, 1996 and ends at 10:00 P.M. UTC, Err bitreich.org 70 i- September 20, 1996. Err bitreich.org 70 i- Err bitreich.org 70 i- BEGIN:VCALENDAR Err bitreich.org 70 i- PRODID:-//xyz Corp//NONSGML PDA Calendar Version 1.0//EN Err bitreich.org 70 i- VERSION:2.0 Err bitreich.org 70 i- BEGIN:VEVENT Err bitreich.org 70 i- DTSTAMP:19960704T120000Z Err bitreich.org 70 i- UID:uid1@example.com Err bitreich.org 70 i- ORGANIZER:mailto:jsmith@example.com Err bitreich.org 70 i- DTSTART:19960918T143000Z Err bitreich.org 70 i- DTEND:19960920T220000Z Err bitreich.org 70 i- STATUS:CONFIRMED Err bitreich.org 70 i- CATEGORIES:CONFERENCE Err bitreich.org 70 i- SUMMARY:Networld+Interop Conference Err bitreich.org 70 i- DESCRIPTION:Networld+Interop Conference Err bitreich.org 70 i- and Exhibit\nAtlanta World Congress Center\n Err bitreich.org 70 i- Atlanta\, Georgia Err bitreich.org 70 i- END:VEVENT Err bitreich.org 70 i- END:VCALENDAR Err bitreich.org 70 i- Err bitreich.org 70 i- The following example specifies a group-scheduled meeting that begins Err bitreich.org 70 i- at 8:30 AM EST on March 12, 1998 and ends at 9:30 AM EST on March 12, Err bitreich.org 70 i- 1998. The "Organizer" has scheduled the meeting with one or more Err bitreich.org 70 i- calendar users in a group. A time zone specification for Eastern Err bitreich.org 70 i- United States has been specified. Err bitreich.org 70 i- Err bitreich.org 70 i- BEGIN:VCALENDAR Err bitreich.org 70 i- PRODID:-//RDU Software//NONSGML HandCal//EN Err bitreich.org 70 i- VERSION:2.0 Err bitreich.org 70 i- BEGIN:VTIMEZONE Err bitreich.org 70 i- TZID:America/New_York Err bitreich.org 70 i- BEGIN:STANDARD Err bitreich.org 70 i- DTSTART:19981025T020000 Err bitreich.org 70 i- TZOFFSETFROM:-0400 Err bitreich.org 70 i- TZOFFSETTO:-0500 Err bitreich.org 70 i- TZNAME:EST Err bitreich.org 70 i- END:STANDARD Err bitreich.org 70 i- BEGIN:DAYLIGHT Err bitreich.org 70 i- DTSTART:19990404T020000 Err bitreich.org 70 i- TZOFFSETFROM:-0500 Err bitreich.org 70 i- TZOFFSETTO:-0400 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 144] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- TZNAME:EDT Err bitreich.org 70 i- END:DAYLIGHT Err bitreich.org 70 i- END:VTIMEZONE Err bitreich.org 70 i- BEGIN:VEVENT Err bitreich.org 70 i- DTSTAMP:19980309T231000Z Err bitreich.org 70 i- UID:guid-1.example.com Err bitreich.org 70 i- ORGANIZER:mailto:mrbig@example.com Err bitreich.org 70 i- ATTENDEE;RSVP=TRUE;ROLE=REQ-PARTICIPANT;CUTYPE=GROUP: Err bitreich.org 70 i- mailto:employee-A@example.com Err bitreich.org 70 i- DESCRIPTION:Project XYZ Review Meeting Err bitreich.org 70 i- CATEGORIES:MEETING Err bitreich.org 70 i- CLASS:PUBLIC Err bitreich.org 70 i- CREATED:19980309T130000Z Err bitreich.org 70 i- SUMMARY:XYZ Project Review Err bitreich.org 70 i- DTSTART;TZID=America/New_York:19980312T083000 Err bitreich.org 70 i- DTEND;TZID=America/New_York:19980312T093000 Err bitreich.org 70 i- LOCATION:1CP Conference Room 4350 Err bitreich.org 70 i- END:VEVENT Err bitreich.org 70 i- END:VCALENDAR Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of an iCalendar object passed in a MIME Err bitreich.org 70 i- message with a single body part consisting of a "text/calendar" Err bitreich.org 70 i- Content Type. Err bitreich.org 70 i- Err bitreich.org 70 i- TO:jsmith@example.com Err bitreich.org 70 i- FROM:jdoe@example.com Err bitreich.org 70 i- MIME-VERSION:1.0 Err bitreich.org 70 i- MESSAGE-ID: Err bitreich.org 70 i- CONTENT-TYPE:text/calendar; method="xyz"; component="VEVENT" Err bitreich.org 70 i- Err bitreich.org 70 i- BEGIN:VCALENDAR Err bitreich.org 70 i- METHOD:xyz Err bitreich.org 70 i- VERSION:2.0 Err bitreich.org 70 i- PRODID:-//ABC Corporation//NONSGML My Product//EN Err bitreich.org 70 i- BEGIN:VEVENT Err bitreich.org 70 i- DTSTAMP:19970324T120000Z Err bitreich.org 70 i- SEQUENCE:0 Err bitreich.org 70 i- UID:uid3@example.com Err bitreich.org 70 i- ORGANIZER:mailto:jdoe@example.com Err bitreich.org 70 i- ATTENDEE;RSVP=TRUE:mailto:jsmith@example.com Err bitreich.org 70 i- DTSTART:19970324T123000Z Err bitreich.org 70 i- DTEND:19970324T210000Z Err bitreich.org 70 i- CATEGORIES:MEETING,PROJECT Err bitreich.org 70 i- CLASS:PUBLIC Err bitreich.org 70 i- SUMMARY:Calendaring Interoperability Planning Meeting Err bitreich.org 70 i- DESCRIPTION:Discuss how we can test c&s interoperability\n Err bitreich.org 70 i- using iCalendar and other IETF standards. Err bitreich.org 70 i- LOCATION:LDB Lobby Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 145] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- ATTACH;FMTTYPE=application/postscript:ftp://example.com/pub/ Err bitreich.org 70 i- conf/bkgrnd.ps Err bitreich.org 70 i- END:VEVENT Err bitreich.org 70 i- END:VCALENDAR Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of a to-do due on April 15, 1998. An Err bitreich.org 70 i- audio alarm has been specified to remind the calendar user at noon, Err bitreich.org 70 i- the day before the to-do is expected to be completed and repeat Err bitreich.org 70 i- hourly, four additional times. The to-do definition has been Err bitreich.org 70 i- modified twice since it was initially created. Err bitreich.org 70 i- Err bitreich.org 70 i- BEGIN:VCALENDAR Err bitreich.org 70 i- VERSION:2.0 Err bitreich.org 70 i- PRODID:-//ABC Corporation//NONSGML My Product//EN Err bitreich.org 70 i- BEGIN:VTODO Err bitreich.org 70 i- DTSTAMP:19980130T134500Z Err bitreich.org 70 i- SEQUENCE:2 Err bitreich.org 70 i- UID:uid4@example.com Err bitreich.org 70 i- ORGANIZER:mailto:unclesam@example.com Err bitreich.org 70 i- ATTENDEE;PARTSTAT=ACCEPTED:mailto:jqpublic@example.com Err bitreich.org 70 i- DUE:19980415T000000 Err bitreich.org 70 i- STATUS:NEEDS-ACTION Err bitreich.org 70 i- SUMMARY:Submit Income Taxes Err bitreich.org 70 i- BEGIN:VALARM Err bitreich.org 70 i- ACTION:AUDIO Err bitreich.org 70 i- TRIGGER:19980403T120000Z Err bitreich.org 70 i- ATTACH;FMTTYPE=audio/basic:http://example.com/pub/audio- Err bitreich.org 70 i- files/ssbanner.aud Err bitreich.org 70 i- REPEAT:4 Err bitreich.org 70 i- DURATION:PT1H Err bitreich.org 70 i- END:VALARM Err bitreich.org 70 i- END:VTODO Err bitreich.org 70 i- END:VCALENDAR Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of a journal entry: Err bitreich.org 70 i- Err bitreich.org 70 i- BEGIN:VCALENDAR Err bitreich.org 70 i- VERSION:2.0 Err bitreich.org 70 i- PRODID:-//ABC Corporation//NONSGML My Product//EN Err bitreich.org 70 i- BEGIN:VJOURNAL Err bitreich.org 70 i- DTSTAMP:19970324T120000Z Err bitreich.org 70 i- UID:uid5@example.com Err bitreich.org 70 i- ORGANIZER:mailto:jsmith@example.com Err bitreich.org 70 i- STATUS:DRAFT Err bitreich.org 70 i- CLASS:PUBLIC Err bitreich.org 70 i- CATEGORIES:Project Report,XYZ,Weekly Meeting Err bitreich.org 70 i- DESCRIPTION:Project xyz Review Meeting Minutes\n Err bitreich.org 70 i- Agenda\n1. Review of project version 1.0 requirements.\n2. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 146] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Definition Err bitreich.org 70 i- of project processes.\n3. Review of project schedule.\n Err bitreich.org 70 i- Participants: John Smith\, Jane Doe\, Jim Dandy\n-It was Err bitreich.org 70 i- decided that the requirements need to be signed off by Err bitreich.org 70 i- product marketing.\n-Project processes were accepted.\n Err bitreich.org 70 i- -Project schedule needs to account for scheduled holidays Err bitreich.org 70 i- and employee vacation time. Check with HR for specific Err bitreich.org 70 i- dates.\n-New schedule will be distributed by Friday.\n- Err bitreich.org 70 i- Next weeks meeting is cancelled. No meeting until 3/23. Err bitreich.org 70 i- END:VJOURNAL Err bitreich.org 70 i- END:VCALENDAR Err bitreich.org 70 i- Err bitreich.org 70 i- The following is an example of published busy time information. The Err bitreich.org 70 i- iCalendar object might be placed in the network resource Err bitreich.org 70 i- http://www.example.com/calendar/busytime/jsmith.ifb. Err bitreich.org 70 i- Err bitreich.org 70 i- BEGIN:VCALENDAR Err bitreich.org 70 i- VERSION:2.0 Err bitreich.org 70 i- PRODID:-//RDU Software//NONSGML HandCal//EN Err bitreich.org 70 i- BEGIN:VFREEBUSY Err bitreich.org 70 i- ORGANIZER:mailto:jsmith@example.com Err bitreich.org 70 i- DTSTART:19980313T141711Z Err bitreich.org 70 i- DTEND:19980410T141711Z Err bitreich.org 70 i- FREEBUSY:19980314T233000Z/19980315T003000Z Err bitreich.org 70 i- FREEBUSY:19980316T153000Z/19980316T163000Z Err bitreich.org 70 i- FREEBUSY:19980318T030000Z/19980318T040000Z Err bitreich.org 70 i- URL:http://www.example.com/calendar/busytime/jsmith.ifb Err bitreich.org 70 i- END:VFREEBUSY Err bitreich.org 70 i- END:VCALENDAR Err bitreich.org 70 i- Err bitreich.org 70 i-5. Recommended Practices Err bitreich.org 70 i- Err bitreich.org 70 i- These recommended practices should be followed in order to assure Err bitreich.org 70 i- consistent handling of the following cases for an iCalendar object. Err bitreich.org 70 i- Err bitreich.org 70 i- 1. Content lines longer than 75 octets SHOULD be folded. Err bitreich.org 70 i- Err bitreich.org 70 i- 2. When the combination of the "RRULE" and "RDATE" properties in a Err bitreich.org 70 i- recurring component produces multiple instances having the same Err bitreich.org 70 i- start DATE-TIME value, they should be collapsed to, and Err bitreich.org 70 i- considered as, a single instance. If the "RDATE" property is Err bitreich.org 70 i- specified as a PERIOD value the duration of the recurrence Err bitreich.org 70 i- instance will be the one specified by the "RDATE" property, and Err bitreich.org 70 i- not the duration of the recurrence instance defined by the Err bitreich.org 70 i- "DTSTART" property. Err bitreich.org 70 i- Err bitreich.org 70 i- 3. When a calendar user receives multiple requests for the same Err bitreich.org 70 i- calendar component (e.g., REQUEST for a "VEVENT" calendar Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 147] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- component) as a result of being on multiple mailing lists Err bitreich.org 70 i- specified by "ATTENDEE" properties in the request, they SHOULD Err bitreich.org 70 i- respond to only one of the requests. The calendar user SHOULD Err bitreich.org 70 i- also specify (using the "MEMBER" parameter of the "ATTENDEE" Err bitreich.org 70 i- property) of which mailing list they are a member. Err bitreich.org 70 i- Err bitreich.org 70 i- 4. An implementation can truncate a "SUMMARY" property value to 255 Err bitreich.org 70 i- octets, but it MUST NOT truncate the value in the middle of a Err bitreich.org 70 i- UTF-8 multi-octet sequence. Err bitreich.org 70 i- Err bitreich.org 70 i- 5. If seconds of the minute are not supported by an implementation, Err bitreich.org 70 i- then a value of "00" SHOULD be specified for the seconds Err bitreich.org 70 i- component in a time value. Err bitreich.org 70 i- Err bitreich.org 70 i- 6. "TZURL" values SHOULD NOT be specified as a file URI type. This Err bitreich.org 70 i- URI form can be useful within an organization, but is problematic Err bitreich.org 70 i- in the Internet. Err bitreich.org 70 i- Err bitreich.org 70 i- 7. Some possible English values for "CATEGORIES" property include: Err bitreich.org 70 i- "ANNIVERSARY", "APPOINTMENT", "BUSINESS", "EDUCATION", "HOLIDAY", Err bitreich.org 70 i- "MEETING", "MISCELLANEOUS", "NON-WORKING HOURS", "NOT IN OFFICE", Err bitreich.org 70 i- "PERSONAL", "PHONE CALL", "SICK DAY", "SPECIAL OCCASION", Err bitreich.org 70 i- "TRAVEL", "VACATION". Categories can be specified in any Err bitreich.org 70 i- registered language. Err bitreich.org 70 i- Err bitreich.org 70 i- 8. Some possible English values for the "RESOURCES" property Err bitreich.org 70 i- include: "CATERING", "CHAIRS", "COMPUTER PROJECTOR", "EASEL", Err bitreich.org 70 i- "OVERHEAD PROJECTOR", "SPEAKER PHONE", "TABLE", "TV", "VCR", Err bitreich.org 70 i- "VIDEO PHONE", "VEHICLE". Resources can be specified in any Err bitreich.org 70 i- registered language. Err bitreich.org 70 i- Err bitreich.org 70 i-6. Internationalization Considerations Err bitreich.org 70 i- Err bitreich.org 70 i- Applications MUST generate iCalendar streams in the UTF-8 charset and Err bitreich.org 70 i- MUST accept an iCalendar stream in the UTF-8 or US-ASCII charset. Err bitreich.org 70 i- Err bitreich.org 70 i-7. Security Considerations Err bitreich.org 70 i- Err bitreich.org 70 i- Because calendaring and scheduling information is very privacy- Err bitreich.org 70 i- sensitive, the protocol used for the transmission of calendaring and Err bitreich.org 70 i- scheduling information should have capabilities to protect the Err bitreich.org 70 i- information from possible threats, such as eavesdropping, replay, Err bitreich.org 70 i- message insertion, deletion, modification, and man-in-the-middle Err bitreich.org 70 i- attacks. Err bitreich.org 70 i- Err bitreich.org 70 i- As this document only defines the data format and media type of text/ Err bitreich.org 70 i- calendar that is independent of any calendar service or protocol, it Err bitreich.org 70 i- is up to the actual protocol specifications such as iTIP [2446bis], Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 148] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- iMIP [2447bis], and "Calendaring Extensions to WebDAV (CalDAV)" Err bitreich.org 70 i- [RFC4791] to describe the threats that the above attacks present, as Err bitreich.org 70 i- well as ways in which to mitigate them. Err bitreich.org 70 i- Err bitreich.org 70 i-8. IANA Considerations Err bitreich.org 70 i- Err bitreich.org 70 i-8.1. iCalendar Media Type Registration Err bitreich.org 70 i- Err bitreich.org 70 i- The Calendaring and Scheduling Core Object Specification is intended Err bitreich.org 70 i- for use as a MIME content type. Err bitreich.org 70 i- Err bitreich.org 70 i- To: ietf-types@iana.org Err bitreich.org 70 i- Err bitreich.org 70 i- Subject: Registration of media type text/calendar Err bitreich.org 70 i- Err bitreich.org 70 i- Type name: text Err bitreich.org 70 i- Err bitreich.org 70 i- Subtype name: calendar Err bitreich.org 70 i- Err bitreich.org 70 i- Required parameters: none Err bitreich.org 70 i- Err bitreich.org 70 i- Optional parameters: charset, method, component, and optinfo Err bitreich.org 70 i- Err bitreich.org 70 i- The "charset" parameter is defined in [RFC2046] for subtypes of Err bitreich.org 70 i- the "text" media type. It is used to indicate the charset used in Err bitreich.org 70 i- the body part. The charset supported by this revision of Err bitreich.org 70 i- iCalendar is UTF-8. The use of any other charset is deprecated by Err bitreich.org 70 i- this revision of iCalendar; however, note that this revision Err bitreich.org 70 i- requires that compliant applications MUST accept iCalendar streams Err bitreich.org 70 i- using either the UTF-8 or US-ASCII charset. Err bitreich.org 70 i- Err bitreich.org 70 i- The "method" parameter is used to convey the iCalendar object Err bitreich.org 70 i- method or transaction semantics for the calendaring and scheduling Err bitreich.org 70 i- information. It also is an identifier for the restricted set of Err bitreich.org 70 i- properties and values of which the iCalendar object consists. The Err bitreich.org 70 i- parameter is to be used as a guide for applications interpreting Err bitreich.org 70 i- the information contained within the body part. It SHOULD NOT be Err bitreich.org 70 i- used to exclude or require particular pieces of information unless Err bitreich.org 70 i- the identified method definition specifically calls for this Err bitreich.org 70 i- behavior. Unless specifically forbidden by a particular method Err bitreich.org 70 i- definition, a text/calendar content type can contain any set of Err bitreich.org 70 i- properties permitted by the Calendaring and Scheduling Core Object Err bitreich.org 70 i- Specification. The "method" parameter MUST be specified and MUST Err bitreich.org 70 i- be set to the same value as the "METHOD" component property of the Err bitreich.org 70 i- iCalendar objects of the iCalendar stream if and only if the Err bitreich.org 70 i- iCalendar objects in the iCalendar stream all have a "METHOD" Err bitreich.org 70 i- component property set to the same value. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 149] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- The value for the "method" parameter is defined as follows: Err bitreich.org 70 i- Err bitreich.org 70 i- method = 1*(ALPHA / DIGIT / "-") Err bitreich.org 70 i- ; IANA-registered iCalendar object method Err bitreich.org 70 i- Err bitreich.org 70 i- The "component" parameter conveys the type of iCalendar calendar Err bitreich.org 70 i- component within the body part. If the iCalendar object contains Err bitreich.org 70 i- more than one calendar component type, then multiple component Err bitreich.org 70 i- parameters MUST be specified. Err bitreich.org 70 i- Err bitreich.org 70 i- The value for the "component" parameter is defined as follows: Err bitreich.org 70 i- Err bitreich.org 70 i- component = "VEVENT" Err bitreich.org 70 i- / "VTODO" Err bitreich.org 70 i- / "VJOURNAL" Err bitreich.org 70 i- / "VFREEBUSY" Err bitreich.org 70 i- / "VTIMEZONE" Err bitreich.org 70 i- / iana-token Err bitreich.org 70 i- / x-name Err bitreich.org 70 i- Err bitreich.org 70 i- The "optinfo" parameter conveys optional information about the Err bitreich.org 70 i- iCalendar object within the body part. This parameter can only Err bitreich.org 70 i- specify semantics already specified by the iCalendar object and Err bitreich.org 70 i- that can be otherwise determined by parsing the body part. In Err bitreich.org 70 i- addition, the optional information specified by this parameter Err bitreich.org 70 i- MUST be consistent with that information specified by the Err bitreich.org 70 i- iCalendar object. For example, it can be used to convey the Err bitreich.org 70 i- "Attendee" response status to a meeting request. The parameter Err bitreich.org 70 i- value consists of a string value. Err bitreich.org 70 i- Err bitreich.org 70 i- The parameter can be specified multiple times. Err bitreich.org 70 i- Err bitreich.org 70 i- The value for the "optinfo" parameter is defined as follows: Err bitreich.org 70 i- Err bitreich.org 70 i- optinfo = infovalue / qinfovalue Err bitreich.org 70 i- Err bitreich.org 70 i- infovalue = iana-token / x-name Err bitreich.org 70 i- Err bitreich.org 70 i- qinfovalue = DQUOTE (infovalue) DQUOTE Err bitreich.org 70 i- Err bitreich.org 70 i- Encoding considerations: This media type can contain 8bit Err bitreich.org 70 i- characters, so the use of quoted-printable or base64 MIME Content- Err bitreich.org 70 i- Transfer-Encodings might be necessary when iCalendar objects are Err bitreich.org 70 i- transferred across protocols restricted to the 7bit repertoire. Err bitreich.org 70 i- Note that a text valued property in the content entity can also Err bitreich.org 70 i- have content encoding of special characters using a BACKSLASH Err bitreich.org 70 i- character escapement technique. This means that content values Err bitreich.org 70 i- can end up being encoded twice. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 150] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Security considerations: See Section 7. Err bitreich.org 70 i- Err bitreich.org 70 i- Interoperability considerations: This media type is intended to Err bitreich.org 70 i- define a common format for conveying calendaring and scheduling Err bitreich.org 70 i- information between different systems. It is heavily based on the Err bitreich.org 70 i- earlier [VCAL] industry specification. Err bitreich.org 70 i- Err bitreich.org 70 i- Published specification: This specification. Err bitreich.org 70 i- Err bitreich.org 70 i- Applications that use this media type: This media type is designed Err bitreich.org 70 i- for widespread use by Internet calendaring and scheduling Err bitreich.org 70 i- applications. In addition, applications in the workflow and Err bitreich.org 70 i- document management area might find this content-type applicable. Err bitreich.org 70 i- The iTIP [2446bis], iMIP [2447bis], and CalDAV [RFC4791] Internet Err bitreich.org 70 i- protocols directly use this media type also. Err bitreich.org 70 i- Err bitreich.org 70 i- Additional information: Err bitreich.org 70 i- Err bitreich.org 70 i- Magic number(s): None. Err bitreich.org 70 i- Err bitreich.org 70 i- File extension(s): The file extension of "ics" is to be used to Err bitreich.org 70 i- designate a file containing (an arbitrary set of) calendaring Err bitreich.org 70 i- and scheduling information consistent with this MIME content Err bitreich.org 70 i- type. Err bitreich.org 70 i- Err bitreich.org 70 i- The file extension of "ifb" is to be used to designate a file Err bitreich.org 70 i- containing free or busy time information consistent with this Err bitreich.org 70 i- MIME content type. Err bitreich.org 70 i- Err bitreich.org 70 i- Macintosh file type code(s): The file type code of "iCal" is to Err bitreich.org 70 i- be used in Apple MacIntosh operating system environments to Err bitreich.org 70 i- designate a file containing calendaring and scheduling Err bitreich.org 70 i- information consistent with this MIME media type. Err bitreich.org 70 i- Err bitreich.org 70 i- The file type code of "iFBf" is to be used in Apple MacIntosh Err bitreich.org 70 i- operating system environments to designate a file containing Err bitreich.org 70 i- free or busy time information consistent with this MIME media Err bitreich.org 70 i- type. Err bitreich.org 70 i- Err bitreich.org 70 i- Person & email address to contact for further information: See the Err bitreich.org 70 i- "Author's Address" section of this document. Err bitreich.org 70 i- Err bitreich.org 70 i- Intended usage: COMMON Err bitreich.org 70 i- Err bitreich.org 70 i- Restrictions on usage: There are no restrictions on where this media Err bitreich.org 70 i- type can be used. Err bitreich.org 70 i- Err bitreich.org 70 i- Author: See the "Author's Address" section of this document. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 151] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Change controller: IETF Err bitreich.org 70 i- Err bitreich.org 70 i-8.2. New iCalendar Elements Registration Err bitreich.org 70 i- Err bitreich.org 70 i- This section defines the process to register new or modified Err bitreich.org 70 i- iCalendar elements, that is, components, properties, parameters, Err bitreich.org 70 i- value data types, and values, with IANA. Err bitreich.org 70 i- Err bitreich.org 70 i-8.2.1. iCalendar Elements Registration Procedure Err bitreich.org 70 i- Err bitreich.org 70 i- The IETF will create a mailing list, icalendar@ietf.org, which can be Err bitreich.org 70 i- used for public discussion of iCalendar elements proposals prior to Err bitreich.org 70 i- registration. Use of the mailing list is strongly encouraged. The Err bitreich.org 70 i- IESG will appoint a designated expert who will monitor the Err bitreich.org 70 i- icalendar@ietf.org mailing list and review registrations. Err bitreich.org 70 i- Err bitreich.org 70 i- Registration of new iCalendar elements MUST be reviewed by the Err bitreich.org 70 i- designated expert and published in an RFC. A Standards Track RFC is Err bitreich.org 70 i- REQUIRED for the registration of new value data types that modify Err bitreich.org 70 i- existing properties, as well as for the registration of participation Err bitreich.org 70 i- status values to be used in "VEVENT" calendar components. A Err bitreich.org 70 i- Standards Track RFC is also REQUIRED for registration of iCalendar Err bitreich.org 70 i- elements that modify iCalendar elements previously documented in a Err bitreich.org 70 i- Standards Track RFC. Err bitreich.org 70 i- Err bitreich.org 70 i- The registration procedure begins when a completed registration Err bitreich.org 70 i- template, defined in the sections below, is sent to Err bitreich.org 70 i- icalendar@ietf.org and iana@iana.org. The designated expert is Err bitreich.org 70 i- expected to tell IANA and the submitter of the registration within Err bitreich.org 70 i- two weeks whether the registration is approved, approved with minor Err bitreich.org 70 i- changes, or rejected with cause. When a registration is rejected Err bitreich.org 70 i- with cause, it can be re-submitted if the concerns listed in the Err bitreich.org 70 i- cause are addressed. Decisions made by the designated expert can be Err bitreich.org 70 i- appealed to the IESG Applications Area Director, then to the IESG. Err bitreich.org 70 i- They follow the normal appeals procedure for IESG decisions. Err bitreich.org 70 i- Err bitreich.org 70 i-8.2.2. Registration Template for Components Err bitreich.org 70 i- Err bitreich.org 70 i- A component is defined by completing the following template. Err bitreich.org 70 i- Err bitreich.org 70 i- Component name: The name of the component. Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: The purpose of the component. Give a short but clear Err bitreich.org 70 i- description. Err bitreich.org 70 i- Err bitreich.org 70 i- Format definition: The ABNF for the component definition needs to be Err bitreich.org 70 i- specified. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 152] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Description: Any special notes about the component, how it is to be Err bitreich.org 70 i- used, etc. Err bitreich.org 70 i- Err bitreich.org 70 i- Example(s): One or more examples of instances of the component need Err bitreich.org 70 i- to be specified. Err bitreich.org 70 i- Err bitreich.org 70 i-8.2.3. Registration Template for Properties Err bitreich.org 70 i- Err bitreich.org 70 i- A property is defined by completing the following template. Err bitreich.org 70 i- Err bitreich.org 70 i- Property name: The name of the property. Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: The purpose of the property. Give a short but clear Err bitreich.org 70 i- description. Err bitreich.org 70 i- Err bitreich.org 70 i- Value type: Any of the valid value types for the property value need Err bitreich.org 70 i- to be specified. The default value type also needs to be Err bitreich.org 70 i- specified. Err bitreich.org 70 i- Err bitreich.org 70 i- Property parameters: Any of the valid property parameters for the Err bitreich.org 70 i- property MUST be specified. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: The calendar components in which the property can Err bitreich.org 70 i- appear MUST be specified. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: Any special notes about the property, how it is to be Err bitreich.org 70 i- used, etc. Err bitreich.org 70 i- Err bitreich.org 70 i- Format definition: The ABNF for the property definition needs to be Err bitreich.org 70 i- specified. Err bitreich.org 70 i- Err bitreich.org 70 i- Example(s): One or more examples of instances of the property need Err bitreich.org 70 i- to be specified. Err bitreich.org 70 i- Err bitreich.org 70 i-8.2.4. Registration Template for Parameters Err bitreich.org 70 i- Err bitreich.org 70 i- A parameter is defined by completing the following template. Err bitreich.org 70 i- Err bitreich.org 70 i- Parameter name: The name of the parameter. Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: The purpose of the parameter. Give a short but clear Err bitreich.org 70 i- description. Err bitreich.org 70 i- Err bitreich.org 70 i- Format definition: The ABNF for the parameter definition needs to be Err bitreich.org 70 i- specified. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: Any special notes about the parameter, how it is to be Err bitreich.org 70 i- used, etc. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 153] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Example(s): One or more examples of instances of the parameter need Err bitreich.org 70 i- to be specified. Err bitreich.org 70 i- Err bitreich.org 70 i-8.2.5. Registration Template for Value Data Types Err bitreich.org 70 i- Err bitreich.org 70 i- A value data type is defined by completing the following template. Err bitreich.org 70 i- Err bitreich.org 70 i- Value name: The name of the value type. Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: The purpose of the value type. Give a short but clear Err bitreich.org 70 i- description. Err bitreich.org 70 i- Err bitreich.org 70 i- Format definition: The ABNF for the value type definition needs to Err bitreich.org 70 i- be specified. Err bitreich.org 70 i- Err bitreich.org 70 i- Description: Any special notes about the value type, how it is to be Err bitreich.org 70 i- used, etc. Err bitreich.org 70 i- Err bitreich.org 70 i- Example(s): One or more examples of instances of the value type need Err bitreich.org 70 i- to be specified. Err bitreich.org 70 i- Err bitreich.org 70 i-8.2.6. Registration Template for Values Err bitreich.org 70 i- Err bitreich.org 70 i- A value is defined by completing the following template. Err bitreich.org 70 i- Err bitreich.org 70 i- Value: The value literal. Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: The purpose of the value. Give a short but clear Err bitreich.org 70 i- description. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: The calendar properties and/or parameters that can take Err bitreich.org 70 i- this value need to be specified. Err bitreich.org 70 i- Err bitreich.org 70 i- Example(s): One or more examples of instances of the value need to Err bitreich.org 70 i- be specified. Err bitreich.org 70 i- Err bitreich.org 70 i- The following is a fictitious example of a registration of an Err bitreich.org 70 i- iCalendar value: Err bitreich.org 70 i- Err bitreich.org 70 i- Value: TOP-SECRET Err bitreich.org 70 i- Err bitreich.org 70 i- Purpose: This value is used to specify the access classification of Err bitreich.org 70 i- top-secret calendar components. Err bitreich.org 70 i- Err bitreich.org 70 i- Conformance: This value can be used with the "CLASS" property. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 154] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Example(s): The following is an example of this value used with the Err bitreich.org 70 i- "CLASS" property: Err bitreich.org 70 i- Err bitreich.org 70 i- CLASS:TOP-SECRET Err bitreich.org 70 i- Err bitreich.org 70 i-8.3. Initial iCalendar Elements Registries Err bitreich.org 70 i- Err bitreich.org 70 i- The IANA created and maintains the following registries for iCalendar Err bitreich.org 70 i- elements with pointers to appropriate reference documents. Err bitreich.org 70 i- Err bitreich.org 70 i-8.3.1. Components Registry Err bitreich.org 70 i- Err bitreich.org 70 i- The following table has been used to initialize the components Err bitreich.org 70 i- registry. Err bitreich.org 70 i- Err bitreich.org 70 i- +-----------+---------+-------------------------+ Err bitreich.org 70 i- | Component | Status | Reference | Err bitreich.org 70 i- +-----------+---------+-------------------------+ Err bitreich.org 70 i- | VCALENDAR | Current | RFC 5545, Section 3.4 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | VEVENT | Current | RFC 5545, Section 3.6.1 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | VTODO | Current | RFC 5545, Section 3.6.2 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | VJOURNAL | Current | RFC 5545, Section 3.6.3 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | VFREEBUSY | Current | RFC 5545, Section 3.6.4 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | VTIMEZONE | Current | RFC 5545, Section 3.6.5 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | VALARM | Current | RFC 5545, Section 3.6.6 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | STANDARD | Current | RFC 5545, Section 3.6.5 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | DAYLIGHT | Current | RFC 5545, Section 3.6.5 | Err bitreich.org 70 i- +-----------+---------+-------------------------+ Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 155] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-8.3.2. Properties Registry Err bitreich.org 70 i- Err bitreich.org 70 i- The following table is has been used to initialize the properties Err bitreich.org 70 i- registry. Err bitreich.org 70 i- Err bitreich.org 70 i- +------------------+------------+----------------------------+ Err bitreich.org 70 i- | Property | Status | Reference | Err bitreich.org 70 i- +------------------+------------+----------------------------+ Err bitreich.org 70 i- | CALSCALE | Current | RFC 5545, Section 3.7.1 | Err bitreich.org 70 i- | METHOD | Current | RFC 5545, Section 3.7.2 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | PRODID | Current | RFC 5545, Section 3.7.3 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | VERSION | Current | RFC 5545, Section 3.7.4 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | ATTACH | Current | RFC 5545, Section 3.8.1.1 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | CATEGORIES | Current | RFC 5545, Section 3.8.1.2 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | CLASS | Current | RFC 5545, Section 3.8.1.3 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | COMMENT | Current | RFC 5545, Section 3.8.1.4 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | DESCRIPTION | Current | RFC 5545, Section 3.8.1.5 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | GEO | Current | RFC 5545, Section 3.8.1.6 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | LOCATION | Current | RFC 5545, Section 3.8.1.7 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | PERCENT-COMPLETE | Current | RFC 5545, Section 3.8.1.8 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | PRIORITY | Current | RFC 5545, Section 3.8.1.9 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | RESOURCES | Current | RFC 5545, Section 3.8.1.10 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | STATUS | Current | RFC 5545, Section 3.8.1.11 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | SUMMARY | Current | RFC 5545, Section 3.8.1.12 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | COMPLETED | Current | RFC 5545, Section 3.8.2.1 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | DTEND | Current | RFC 5545, Section 3.8.2.2 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | DUE | Current | RFC 5545, Section 3.8.2.3 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | DTSTART | Current | RFC 5545, Section 3.8.2.4 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | DURATION | Current | RFC 5545, Section 3.8.2.5 | Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 156] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | FREEBUSY | Current | RFC 5545, Section 3.8.2.6 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | TRANSP | Current | RFC 5545, Section 3.8.2.7 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | TZID | Current | RFC 5545, Section 3.8.3.1 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | TZNAME | Current | RFC 5545, Section 3.8.3.2 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | TZOFFSETFROM | Current | RFC 5545, Section 3.8.3.3 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | TZOFFSETTO | Current | RFC 5545, Section 3.8.3.4 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | TZURL | Current | RFC 5545, Section 3.8.3.5 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | ATTENDEE | Current | RFC 5545, Section 3.8.4.1 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | CONTACT | Current | RFC 5545, Section 3.8.4.2 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | ORGANIZER | Current | RFC 5545, Section 3.8.4.3 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | RECURRENCE-ID | Current | RFC 5545, Section 3.8.4.4 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | RELATED-TO | Current | RFC 5545, Section 3.8.4.5 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | URL | Current | RFC 5545, Section 3.8.4.6 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | UID | Current | RFC 5545, Section 3.8.4.7 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | EXDATE | Current | RFC 5545, Section 3.8.5.1 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | EXRULE | Deprecated | [RFC2445], Section 4.8.5.2 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | RDATE | Current | RFC 5545, Section 3.8.5.2 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | RRULE | Current | RFC 5545, Section 3.8.5.3 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | ACTION | Current | RFC 5545, Section 3.8.6.1 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | REPEAT | Current | RFC 5545, Section 3.8.6.2 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | TRIGGER | Current | RFC 5545, Section 3.8.6.3 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | CREATED | Current | RFC 5545, Section 3.8.7.1 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | DTSTAMP | Current | RFC 5545, Section 3.8.7.2 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | LAST-MODIFIED | Current | RFC 5545, Section 3.8.7.3 | Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 157] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | SEQUENCE | Current | RFC 5545, Section 3.8.7.4 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | REQUEST-STATUS | Current | RFC 5545, Section 3.8.8.3 | Err bitreich.org 70 i- +------------------+------------+----------------------------+ Err bitreich.org 70 i- Err bitreich.org 70 i-8.3.3. Parameters Registry Err bitreich.org 70 i- Err bitreich.org 70 i- The following table has been used to initialize the parameters Err bitreich.org 70 i- registry. Err bitreich.org 70 i- Err bitreich.org 70 i- +----------------+---------+--------------------------+ Err bitreich.org 70 i- | Parameter | Status | Reference | Err bitreich.org 70 i- +----------------+---------+--------------------------+ Err bitreich.org 70 i- | ALTREP | Current | RFC 5545, Section 3.2.1 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | CN | Current | RFC 5545, Section 3.2.2 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | CUTYPE | Current | RFC 5545, Section 3.2.3 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | DELEGATED-FROM | Current | RFC 5545, Section 3.2.4 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | DELEGATED-TO | Current | RFC 5545, Section 3.2.5 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | DIR | Current | RFC 5545, Section 3.2.6 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | ENCODING | Current | RFC 5545, Section 3.2.7 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | FMTTYPE | Current | RFC 5545, Section 3.2.8 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | FBTYPE | Current | RFC 5545, Section 3.2.9 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | LANGUAGE | Current | RFC 5545, Section 3.2.10 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | MEMBER | Current | RFC 5545, Section 3.2.11 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | PARTSTAT | Current | RFC 5545, Section 3.2.12 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | RANGE | Current | RFC 5545, Section 3.2.13 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | RELATED | Current | RFC 5545, Section 3.2.14 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | RELTYPE | Current | RFC 5545, Section 3.2.15 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | ROLE | Current | RFC 5545, Section 3.2.16 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | RSVP | Current | RFC 5545, Section 3.2.17 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 158] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- | SENT-BY | Current | RFC 5545, Section 3.2.18 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | TZID | Current | RFC 5545, Section 3.2.19 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | VALUE | Current | RFC 5545, Section 3.2.20 | Err bitreich.org 70 i- +----------------+---------+--------------------------+ Err bitreich.org 70 i- Err bitreich.org 70 i-8.3.4. Value Data Types Registry Err bitreich.org 70 i- Err bitreich.org 70 i- The following table has been used to initialize the value data types Err bitreich.org 70 i- registry. Err bitreich.org 70 i- Err bitreich.org 70 i- +-----------------+---------+--------------------------+ Err bitreich.org 70 i- | Value Data Type | Status | Reference | Err bitreich.org 70 i- +-----------------+---------+--------------------------+ Err bitreich.org 70 i- | BINARY | Current | RFC 5545, Section 3.3.1 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | BOOLEAN | Current | RFC 5545, Section 3.3.2 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | CAL-ADDRESS | Current | RFC 5545, Section 3.3.3 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | DATE | Current | RFC 5545, Section 3.3.4 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | DATE-TIME | Current | RFC 5545, Section 3.3.5 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | DURATION | Current | RFC 5545, Section 3.3.6 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | FLOAT | Current | RFC 5545, Section 3.3.7 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | INTEGER | Current | RFC 5545, Section 3.3.8 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | PERIOD | Current | RFC 5545, Section 3.3.9 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | RECUR | Current | RFC 5545, Section 3.3.10 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | TEXT | Current | RFC 5545, Section 3.3.11 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | TIME | Current | RFC 5545, Section 3.3.12 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | URI | Current | RFC 5545, Section 3.3.13 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | UTC-OFFSET | Current | RFC 5545, Section 3.3.14 | Err bitreich.org 70 i- +-----------------+---------+--------------------------+ Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 159] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-8.3.5. Calendar User Types Registry Err bitreich.org 70 i- Err bitreich.org 70 i- The following table has been used to initialize the calendar user Err bitreich.org 70 i- types registry. Err bitreich.org 70 i- Err bitreich.org 70 i- +--------------------+---------+-------------------------+ Err bitreich.org 70 i- | Calendar User Type | Status | Reference | Err bitreich.org 70 i- +--------------------+---------+-------------------------+ Err bitreich.org 70 i- | INDIVIDUAL | Current | RFC 5545, Section 3.2.3 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | GROUP | Current | RFC 5545, Section 3.2.3 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | RESOURCE | Current | RFC 5545, Section 3.2.3 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | ROOM | Current | RFC 5545, Section 3.2.3 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | UNKNOWN | Current | RFC 5545, Section 3.2.3 | Err bitreich.org 70 i- +--------------------+---------+-------------------------+ Err bitreich.org 70 i- Err bitreich.org 70 i-8.3.6. Free/Busy Time Types Registry Err bitreich.org 70 i- Err bitreich.org 70 i- The following table has been used to initialize the free/busy time Err bitreich.org 70 i- types registry. Err bitreich.org 70 i- Err bitreich.org 70 i- +---------------------+---------+-------------------------+ Err bitreich.org 70 i- | Free/Busy Time Type | Status | Reference | Err bitreich.org 70 i- +---------------------+---------+-------------------------+ Err bitreich.org 70 i- | FREE | Current | RFC 5545, Section 3.2.9 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | BUSY | Current | RFC 5545, Section 3.2.9 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | BUSY-UNAVAILABLE | Current | RFC 5545, Section 3.2.9 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | BUSY-TENTATIVE | Current | RFC 5545, Section 3.2.9 | Err bitreich.org 70 i- +---------------------+---------+-------------------------+ Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 160] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-8.3.7. Participation Statuses Registry Err bitreich.org 70 i- Err bitreich.org 70 i- The following table has been used to initialize the participation Err bitreich.org 70 i- statuses registry. Err bitreich.org 70 i- Err bitreich.org 70 i- +--------------------+---------+--------------------------+ Err bitreich.org 70 i- | Participant Status | Status | Reference | Err bitreich.org 70 i- +--------------------+---------+--------------------------+ Err bitreich.org 70 i- | NEEDS-ACTION | Current | RFC 5545, Section 3.2.12 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | ACCEPTED | Current | RFC 5545, Section 3.2.12 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | DECLINED | Current | RFC 5545, Section 3.2.12 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | TENTATIVE | Current | RFC 5545, Section 3.2.12 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | DELEGATED | Current | RFC 5545, Section 3.2.12 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | COMPLETED | Current | RFC 5545, Section 3.2.12 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | IN-PROCESS | Current | RFC 5545, Section 3.2.12 | Err bitreich.org 70 i- +--------------------+---------+--------------------------+ Err bitreich.org 70 i- Err bitreich.org 70 i-8.3.8. Relationship Types Registry Err bitreich.org 70 i- Err bitreich.org 70 i- The following table has been used to initialize the relationship Err bitreich.org 70 i- types registry. Err bitreich.org 70 i- Err bitreich.org 70 i- +-------------------+---------+--------------------------+ Err bitreich.org 70 i- | Relationship Type | Status | Reference | Err bitreich.org 70 i- +-------------------+---------+--------------------------+ Err bitreich.org 70 i- | CHILD | Current | RFC 5545, Section 3.2.15 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | PARENT | Current | RFC 5545, Section 3.2.15 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | SIBLING | Current | RFC 5545, Section 3.2.15 | Err bitreich.org 70 i- +-------------------+---------+--------------------------+ Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 161] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-8.3.9. Participation Roles Registry Err bitreich.org 70 i- Err bitreich.org 70 i- The following table has been used to initialize the participation Err bitreich.org 70 i- roles registry. Err bitreich.org 70 i- Err bitreich.org 70 i- +-----------------+---------+--------------------------+ Err bitreich.org 70 i- | Role Type | Status | Reference | Err bitreich.org 70 i- +-----------------+---------+--------------------------+ Err bitreich.org 70 i- | CHAIR | Current | RFC 5545, Section 3.2.16 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | REQ-PARTICIPANT | Current | RFC 5545, Section 3.2.16 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | OPT-PARTICIPANT | Current | RFC 5545, Section 3.2.16 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | NON-PARTICIPANT | Current | RFC 5545, Section 3.2.16 | Err bitreich.org 70 i- +-----------------+---------+--------------------------+ Err bitreich.org 70 i- Err bitreich.org 70 i-8.3.10. Actions Registry Err bitreich.org 70 i- Err bitreich.org 70 i- The following table has been used to initialize the actions registry. Err bitreich.org 70 i- Err bitreich.org 70 i- +-----------+------------+----------------------------+ Err bitreich.org 70 i- | Action | Status | Reference | Err bitreich.org 70 i- +-----------+------------+----------------------------+ Err bitreich.org 70 i- | AUDIO | Current | RFC 5545, Section 3.8.6.1 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | DISPLAY | Current | RFC 5545, Section 3.8.6.1 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | EMAIL | Current | RFC 5545, Section 3.8.6.1 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | PROCEDURE | Deprecated | [RFC2445], Section 4.8.6.1 | Err bitreich.org 70 i- +-----------+------------+----------------------------+ Err bitreich.org 70 i- Err bitreich.org 70 i-8.3.11. Classifications Registry Err bitreich.org 70 i- Err bitreich.org 70 i- The following table has been used to initialize the classifications Err bitreich.org 70 i- registry. Err bitreich.org 70 i- Err bitreich.org 70 i- +----------------+---------+---------------------------+ Err bitreich.org 70 i- | Classification | Status | Reference | Err bitreich.org 70 i- +----------------+---------+---------------------------+ Err bitreich.org 70 i- | PUBLIC | Current | RFC 5545, Section 3.8.1.3 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | PRIVATE | Current | RFC 5545, Section 3.8.1.3 | Err bitreich.org 70 i- | | | | Err bitreich.org 70 i- | CONFIDENTIAL | Current | RFC 5545, Section 3.8.1.3 | Err bitreich.org 70 i- +----------------+---------+---------------------------+ Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 162] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-8.3.12. Methods Registry Err bitreich.org 70 i- Err bitreich.org 70 i- No values are defined in this document for the "METHOD" property. Err bitreich.org 70 i- Err bitreich.org 70 i-9. Acknowledgments Err bitreich.org 70 i- Err bitreich.org 70 i- The editor of this document wishes to thank Frank Dawson and Derik Err bitreich.org 70 i- Stenerson, the original authors of RFC 2445, as well as the following Err bitreich.org 70 i- individuals who have participated in the drafting, review, and Err bitreich.org 70 i- discussion of this memo: Err bitreich.org 70 i- Err bitreich.org 70 i- Joe Abley, Hervey Allen, Steve Allen, Jay Batson, Oliver Block, Err bitreich.org 70 i- Stephane Bortzmeyer, Chris Bryant, Tantek Celik, Mark Crispin, Cyrus Err bitreich.org 70 i- Daboo, Mike Douglass, Andrew N. Dowden, Lisa Dusseault, Lars Eggert, Err bitreich.org 70 i- Gren Eliot, Pasi Eronen, Ben Fortuna, Ned Freed, Neal Gafter, Ted Err bitreich.org 70 i- Hardie, Tim Hare, Jeffrey Harris, Helge Hess, Paul B. Hill, Thomas Err bitreich.org 70 i- Hnetila, Russ Housley, Leif Johansson, Ciny Joy, Bruce Kahn, Reinhold Err bitreich.org 70 i- Kainhofer, Martin Kiff, Patrice Lapierre, Michiel van Leeuwen, Err bitreich.org 70 i- Jonathan Lennox, Jeff McCullough, Bill McQuillan, Alexey Melnikov, Err bitreich.org 70 i- John W. Noerenberg II, Chuck Norris, Mark Paterson, Simon Pilette, Err bitreich.org 70 i- Arnaud Quillaud, Robert Ransdell, Julian F. Reschke, Caleb Err bitreich.org 70 i- Richardson, Sam Roberts, Dan Romascanu, Mike Samuel, George Sexton, Err bitreich.org 70 i- Nigel Swinson, Clint Talbert, Simon Vaillancourt, Magnus Westerlund, Err bitreich.org 70 i- and Sandy Wills. Err bitreich.org 70 i- Err bitreich.org 70 i- A special thanks to the working group chairs Aki Niemi and Eliot Lear Err bitreich.org 70 i- for their support and guidance. Err bitreich.org 70 i- Err bitreich.org 70 i- The editor would also like to thank the Calendaring and Scheduling Err bitreich.org 70 i- Consortium for advice with this specification, and for organizing Err bitreich.org 70 i- interoperability testing events to help refine it. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 163] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-10. References Err bitreich.org 70 i- Err bitreich.org 70 i-10.1. Normative References Err bitreich.org 70 i- Err bitreich.org 70 i- [ISO.8601.2004] International Organization for Err bitreich.org 70 i- Standardization, "Data elements and Err bitreich.org 70 i- interchange formats -- Information interchange Err bitreich.org 70 i- -- Representation of dates and times", 2004. Err bitreich.org 70 i- Err bitreich.org 70 i- [ISO.9070.1991] International Organization for Err bitreich.org 70 i- Standardization, "Information Technology_SGML Err bitreich.org 70 i- Support Facilities -- Registration Procedures Err bitreich.org 70 i- for Public Text Owner Identifiers, Second Err bitreich.org 70 i- Edition", April 1991. Err bitreich.org 70 i- Err bitreich.org 70 i- [RFC2045] Freed, N. and N. Borenstein, "Multipurpose Err bitreich.org 70 i- Internet Mail Extensions (MIME) Part One: Err bitreich.org 70 i- Format of Internet Message Bodies", RFC 2045, Err bitreich.org 70 i- November 1996. Err bitreich.org 70 i- Err bitreich.org 70 i- [RFC2046] Freed, N. and N. Borenstein, "Multipurpose Err bitreich.org 70 i- Internet Mail Extensions (MIME) Part Two: Err bitreich.org 70 i- Media Types", RFC 2046, November 1996. Err bitreich.org 70 i- Err bitreich.org 70 i- [RFC2119] Bradner, S., "Key words for use in RFCs to Err bitreich.org 70 i- Indicate Requirement Levels", BCP 14, Err bitreich.org 70 i- RFC 2119, March 1997. Err bitreich.org 70 i- Err bitreich.org 70 i- [RFC2368] Hoffman, P., Masinter, L., and J. Zawinski, Err bitreich.org 70 i- "The mailto URL scheme", RFC 2368, July 1998. Err bitreich.org 70 i- Err bitreich.org 70 i- [RFC3629] Yergeau, F., "UTF-8, a transformation format Err bitreich.org 70 i- of ISO 10646", STD 63, RFC 3629, Err bitreich.org 70 i- November 2003. Err bitreich.org 70 i- Err bitreich.org 70 i- [RFC3986] Berners-Lee, T., Fielding, R., and L. Err bitreich.org 70 i- Masinter, "Uniform Resource Identifier (URI): Err bitreich.org 70 i- Generic Syntax", STD 66, RFC 3986, Err bitreich.org 70 i- January 2005. Err bitreich.org 70 i- Err bitreich.org 70 i- [RFC4288] Freed, N. and J. Klensin, "Media Type Err bitreich.org 70 i- Specifications and Registration Procedures", Err bitreich.org 70 i- BCP 13, RFC 4288, December 2005. Err bitreich.org 70 i- Err bitreich.org 70 i- [RFC4648] Josefsson, S., "The Base16, Base32, and Base64 Err bitreich.org 70 i- Data Encodings", RFC 4648, October 2006. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 164] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- [RFC5234] Crocker, D. and P. Overell, "Augmented BNF for Err bitreich.org 70 i- Syntax Specifications: ABNF", STD 68, Err bitreich.org 70 i- RFC 5234, January 2008. Err bitreich.org 70 i- Err bitreich.org 70 i- [RFC5646] Phillips, A., Ed., and M. Davis, Ed., "Tags Err bitreich.org 70 i- for Identifying Languages", BCP 47, RFC 5646, Err bitreich.org 70 i- September 2009. Err bitreich.org 70 i- Err bitreich.org 70 i- [US-ASCII] American National Standards Institute, "Coded Err bitreich.org 70 i- Character Set - 7-bit American Standard Code Err bitreich.org 70 i- for Information Interchange", ANSI X3.4, 1986. Err bitreich.org 70 i- Err bitreich.org 70 i-10.2. Informative References Err bitreich.org 70 i- Err bitreich.org 70 i- [2446bis] Daboo, C., "iCalendar Transport-Independent Err bitreich.org 70 i- Interoperability Protocol (iTIP)", Work Err bitreich.org 70 i- in Progress, April 2009. Err bitreich.org 70 i- Err bitreich.org 70 i- [2447bis] Melnikov, A., "iCalendar Message-Based Err bitreich.org 70 i- Interoperability Protocol (iMIP)", Work Err bitreich.org 70 i- in Progress, June 2008. Err bitreich.org 70 i- Err bitreich.org 70 i- [ANSI INCITS 61-1986] International Committee for Information Err bitreich.org 70 i- Technology, "Representation of Geographic Err bitreich.org 70 i- Point Locations for Information Interchange Err bitreich.org 70 i- (formerly ANSI X3.61-1986 (R1997))", ANSI Err bitreich.org 70 i- INCITS 61-1986 (R2007), 2007. Err bitreich.org 70 i- Err bitreich.org 70 i- [RFC1738] Berners-Lee, T., Masinter, L., and M. Err bitreich.org 70 i- McCahill, "Uniform Resource Locators (URL)", Err bitreich.org 70 i- RFC 1738, December 1994. Err bitreich.org 70 i- Err bitreich.org 70 i- [RFC2392] Levinson, E., "Content-ID and Message-ID Err bitreich.org 70 i- Uniform Resource Locators", RFC 2392, Err bitreich.org 70 i- August 1998. Err bitreich.org 70 i- Err bitreich.org 70 i- [RFC2397] Masinter, L., "The "data" URL scheme", Err bitreich.org 70 i- RFC 2397, August 1998. Err bitreich.org 70 i- Err bitreich.org 70 i- [RFC2425] Howes, T., Smith, M., and F. Dawson, "A MIME Err bitreich.org 70 i- Content-Type for Directory Information", Err bitreich.org 70 i- RFC 2425, September 1998. Err bitreich.org 70 i- Err bitreich.org 70 i- [RFC2426] Dawson, F. and T. Howes, "vCard MIME Directory Err bitreich.org 70 i- Profile", RFC 2426, September 1998. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 165] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- [RFC2445] Dawson, F. and Stenerson, D., "Internet Err bitreich.org 70 i- Calendaring and Scheduling Core Object Err bitreich.org 70 i- Specification (iCalendar)", RFC 2445, Err bitreich.org 70 i- November 1998. Err bitreich.org 70 i- Err bitreich.org 70 i- [RFC2616] Fielding, R., Gettys, J., Mogul, J., Frystyk, Err bitreich.org 70 i- H., Masinter, L., Leach, P., and T. Berners- Err bitreich.org 70 i- Lee, "Hypertext Transfer Protocol -- Err bitreich.org 70 i- HTTP/1.1", RFC 2616, June 1999. Err bitreich.org 70 i- Err bitreich.org 70 i- [RFC2818] Rescorla, E., "HTTP Over TLS", RFC 2818, Err bitreich.org 70 i- May 2000. Err bitreich.org 70 i- Err bitreich.org 70 i- [RFC4516] Smith, M. and T. Howes, "Lightweight Directory Err bitreich.org 70 i- Access Protocol (LDAP): Uniform Resource Err bitreich.org 70 i- Locator", RFC 4516, June 2006. Err bitreich.org 70 i- Err bitreich.org 70 i- [RFC4791] Daboo, C., Desruisseaux, B., and L. Dusseault, Err bitreich.org 70 i- "Calendaring Extensions to WebDAV (CalDAV)", Err bitreich.org 70 i- RFC 4791, March 2007. Err bitreich.org 70 i- Err bitreich.org 70 i- [TZDB] Eggert, P. and A.D. Olson, "Sources for Time Err bitreich.org 70 i- Zone and Daylight Saving Time Data", Err bitreich.org 70 i- July 2009, Err bitreich.org 70 i- . Err bitreich.org 70 i- Err bitreich.org 70 i- [VCAL] Internet Mail Consortium, "vCalendar: The Err bitreich.org 70 i- Electronic Calendaring and Scheduling Exchange Err bitreich.org 70 i- Format", September 1996, Err bitreich.org 70 i- . Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 166] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Appendix A. Differences from RFC 2445 Err bitreich.org 70 i- Err bitreich.org 70 i- This appendix contains a list of changes that have been made in the Err bitreich.org 70 i- Internet Calendaring and Scheduling Core Object Specification from Err bitreich.org 70 i- RFC 2445. Err bitreich.org 70 i- Err bitreich.org 70 i-A.1. New Restrictions Err bitreich.org 70 i- Err bitreich.org 70 i- 1. The "DTSTART" property SHOULD be synchronized with the recurrence Err bitreich.org 70 i- rule, if specified. Err bitreich.org 70 i- Err bitreich.org 70 i- 2. The "RRULE" property SHOULD NOT occur more than once in a Err bitreich.org 70 i- component. Err bitreich.org 70 i- Err bitreich.org 70 i- 3. The BYHOUR, BYMINUTE, and BYSECOND rule parts MUST NOT be Err bitreich.org 70 i- specified in the "RRULE" property when the "DTSTART" property is Err bitreich.org 70 i- specified as a DATE value. Err bitreich.org 70 i- Err bitreich.org 70 i- 4. The value type of the "DTEND" or "DUE" properties MUST match the Err bitreich.org 70 i- value type of "DTSTART" property. Err bitreich.org 70 i- Err bitreich.org 70 i- 5. The "DURATION" property can no longer appear in "VFREEBUSY" Err bitreich.org 70 i- components. Err bitreich.org 70 i- Err bitreich.org 70 i-A.2. Restrictions Removed Err bitreich.org 70 i- Err bitreich.org 70 i- 1. The "DTSTART" and "DTEND" properties are no longer required to be Err bitreich.org 70 i- specified as date with local time and time zone reference when Err bitreich.org 70 i- used with a recurrence rule. Err bitreich.org 70 i- Err bitreich.org 70 i-A.3. Deprecated Features Err bitreich.org 70 i- Err bitreich.org 70 i- 1. The "EXRULE" property can no longer be specified in a component. Err bitreich.org 70 i- Err bitreich.org 70 i- 2. The "THISANDPRIOR" value can no longer be used with the "RANGE" Err bitreich.org 70 i- parameter. Err bitreich.org 70 i- Err bitreich.org 70 i- 3. The "PROCEDURE" value can no longer be used with the "ACTION" Err bitreich.org 70 i- property. Err bitreich.org 70 i- Err bitreich.org 70 i- 4. The value type RECUR no longer allows multiple values to be Err bitreich.org 70 i- specified by a COMMA-separated list of values. Err bitreich.org 70 i- Err bitreich.org 70 i- 5. x-name rule parts can no longer be specified in properties of Err bitreich.org 70 i- RECUR value type (e.g., "RRULE"). x-param can be used on RECUR Err bitreich.org 70 i- value type properties instead. Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 167] Err bitreich.org 70 i- Err bitreich.org 70 i-RFC 5545 iCalendar September 2009 Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Author's Address Err bitreich.org 70 i- Err bitreich.org 70 i- Bernard Desruisseaux (editor) Err bitreich.org 70 i- Oracle Corporation Err bitreich.org 70 i- 600 blvd. de Maisonneuve West Err bitreich.org 70 i- Suite 1900 Err bitreich.org 70 i- Montreal, QC H3A 3J2 Err bitreich.org 70 i- CANADA Err bitreich.org 70 i- Err bitreich.org 70 i- EMail: bernard.desruisseaux@oracle.com Err bitreich.org 70 i- URI: http://www.oracle.com/ Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Desruisseaux Standards Track [Page 168] Err bitreich.org 70 i- Err bitreich.org 70 1diff --git a/ics2txt b/ics2txt /scm/ics2txt/file/ics2txt.gph bitreich.org 70 i@@ -1,89 +1,90 @@ Err bitreich.org 70 i #!/usr/bin/awk -f Err bitreich.org 70 i-# handle ical agenda and display them in plain text Err bitreich.org 70 i+ Err bitreich.org 70 i+# display iCal entries in plain text Err bitreich.org 70 i Err bitreich.org 70 i function leap(yrs) Err bitreich.org 70 i { Err bitreich.org 70 i- return (yrs % 4 == 0) && (yrs % 100 != 0) || (yrs % 400 == 0); Err bitreich.org 70 i+ return (yrs % 4 == 0) && (yrs % 100 != 0) || (yrs % 400 == 0) Err bitreich.org 70 i } Err bitreich.org 70 i Err bitreich.org 70 i function days_per_month(mth, yrs) Err bitreich.org 70 i { Err bitreich.org 70 i if (mth == 2) Err bitreich.org 70 i- return 28 + leap(yrs); Err bitreich.org 70 i+ return 28 + leap(yrs) Err bitreich.org 70 i else Err bitreich.org 70 i- return 30 + (mth - (mth > 7)) % 2; Err bitreich.org 70 i+ return 30 + (mth - (mth > 7)) % 2 Err bitreich.org 70 i } Err bitreich.org 70 i Err bitreich.org 70 i function to_sec(yrs, mth, day, hrs, min, sec) Err bitreich.org 70 i { Err bitreich.org 70 i while (--mth >= 1) Err bitreich.org 70 i- day += days_per_month(mth, yrs); Err bitreich.org 70 i+ day += days_per_month(mth, yrs) Err bitreich.org 70 i while (--yrs >= 1970) Err bitreich.org 70 i- day += 365 + leap(yrs); Err bitreich.org 70 i- return (((((day - 1) * 24) + hrs) * 60) + min) * 60 + sec; Err bitreich.org 70 i+ day += 365 + leap(yrs) Err bitreich.org 70 i+ return (((((day - 1) * 24) + hrs) * 60) + min) * 60 + sec Err bitreich.org 70 i } Err bitreich.org 70 i Err bitreich.org 70 i function to_date(fmt, sec) Err bitreich.org 70 i { Err bitreich.org 70 i for (yrs = 1970; sec >= (s = 3600 * 24 * (365 + leap(yrs))); yrs++) Err bitreich.org 70 i- sec -= s; Err bitreich.org 70 i+ sec -= s Err bitreich.org 70 i for (mth = 1; sec >= (s = 3600 * 24 * days_per_month(mth, yrs)); mth++) Err bitreich.org 70 i- sec -= s; Err bitreich.org 70 i+ sec -= s Err bitreich.org 70 i for (day = 1; sec >= (s = 3600 * 24); day++) Err bitreich.org 70 i- sec -= s; Err bitreich.org 70 i+ sec -= s Err bitreich.org 70 i for (hrs = 0; sec >= 3600; hrs++) Err bitreich.org 70 i- sec -= 3600; Err bitreich.org 70 i+ sec -= 3600 Err bitreich.org 70 i for (min = 0; sec >= 60; min++) Err bitreich.org 70 i- sec -= 60; Err bitreich.org 70 i- return sprintf(fmt, yrs, mth, day, hrs, min, sec); Err bitreich.org 70 i+ sec -= 60 Err bitreich.org 70 i+ return sprintf(fmt, yrs, mth, day, hrs, min, sec) Err bitreich.org 70 i } Err bitreich.org 70 i Err bitreich.org 70 i function date_ical(str, offset) { Err bitreich.org 70 i- yrs = substr(str, 1, 4); Err bitreich.org 70 i- mth = substr(str, 5, 2); Err bitreich.org 70 i- day = substr(str, 7, 2); Err bitreich.org 70 i- hrs = substr(str, 10, 2); Err bitreich.org 70 i- min = substr(str, 12, 2); Err bitreich.org 70 i+ yrs = substr(str, 1, 4) Err bitreich.org 70 i+ mth = substr(str, 5, 2) Err bitreich.org 70 i+ day = substr(str, 7, 2) Err bitreich.org 70 i+ hrs = substr(str, 10, 2) Err bitreich.org 70 i+ min = substr(str, 12, 2) Err bitreich.org 70 i if (substr(str, 16, 1) == "Z") Err bitreich.org 70 i- return to_sec(yrs, mth, day, hrs, min, 0); Err bitreich.org 70 i+ return to_sec(yrs, mth, day, hrs, min, 0) Err bitreich.org 70 i else Err bitreich.org 70 i- return to_sec(yrs, mth, day, hrs, min, 0) - offset; Err bitreich.org 70 i+ return to_sec(yrs, mth, day, hrs, min, 0) - offset Err bitreich.org 70 i } Err bitreich.org 70 i Err bitreich.org 70 i function date_iso8601(date, offset) Err bitreich.org 70 i { Err bitreich.org 70 i- yrs = substr(date, 1, 4); Err bitreich.org 70 i- mth = substr(date, 6, 2); Err bitreich.org 70 i- day = substr(date, 9, 2); Err bitreich.org 70 i- hrs = substr(date, 12, 2); Err bitreich.org 70 i- min = substr(date, 15, 2); Err bitreich.org 70 i- return to_sec(yrs, mth, day, hrs, min, 0) - offset; Err bitreich.org 70 i+ yrs = substr(date, 1, 4) Err bitreich.org 70 i+ mth = substr(date, 6, 2) Err bitreich.org 70 i+ day = substr(date, 9, 2) Err bitreich.org 70 i+ hrs = substr(date, 12, 2) Err bitreich.org 70 i+ min = substr(date, 15, 2) Err bitreich.org 70 i+ return to_sec(yrs, mth, day, hrs, min, 0) - offset Err bitreich.org 70 i } Err bitreich.org 70 i Err bitreich.org 70 i function swap(array, a, b) Err bitreich.org 70 i { Err bitreich.org 70 i- tmp = array[a]; Err bitreich.org 70 i- array[a] = array[b]; Err bitreich.org 70 i- array[b] = tmp; Err bitreich.org 70 i+ tmp = array[a] Err bitreich.org 70 i+ array[a] = array[b] Err bitreich.org 70 i+ array[b] = tmp Err bitreich.org 70 i } Err bitreich.org 70 i Err bitreich.org 70 i function sort(array, beg, end) Err bitreich.org 70 i { Err bitreich.org 70 i if (beg >= end) # end recursion Err bitreich.org 70 i- return; Err bitreich.org 70 i+ return Err bitreich.org 70 i Err bitreich.org 70 i a = beg + 1; # #1 is the pivot Err bitreich.org 70 i- b = end; Err bitreich.org 70 i+ b = end Err bitreich.org 70 i while (a < b) { Err bitreich.org 70 i while (a < b && array[a] <= array[beg]) # beg: skip lesser Err bitreich.org 70 i- a++; Err bitreich.org 70 i+ a++ Err bitreich.org 70 i while (a < b && array[b] > array[beg]) # end: skip greater Err bitreich.org 70 i- b--; Err bitreich.org 70 i+ b-- Err bitreich.org 70 i swap(array, a, b); # found 2 misplaced Err bitreich.org 70 i } Err bitreich.org 70 i Err bitreich.org 70 i if (array[beg] > array[a]) # put the pivot back Err bitreich.org 70 i- swap(array, beg, a); Err bitreich.org 70 i+ swap(array, beg, a) Err bitreich.org 70 i Err bitreich.org 70 i sort(array, beg, a - 1); # sort lower half Err bitreich.org 70 i sort(array, a, end); # sort higher half Err bitreich.org 70 i@@ -91,99 +92,77 @@ function sort(array, beg, end) Err bitreich.org 70 i Err bitreich.org 70 i function parse_ical(list, offset) Err bitreich.org 70 i { Err bitreich.org 70 i- FS = "[:;]"; Err bitreich.org 70 i+ FS = "[:;]" Err bitreich.org 70 i Err bitreich.org 70 i while (getline) { Err bitreich.org 70 i- gsub("\r", " "); gsub("\\\\[ntr]", " "); gsub("\\\\", ""); Err bitreich.org 70 i- gsub("^ *", ""); gsub(" *$", ""); Err bitreich.org 70 i- gsub(" *<[a-zA-Z0-9/]*>* *", ""); Err bitreich.org 70 i+ gsub("\r", " "); gsub("\\\\[ntr]", " "); gsub("\\\\", "") Err bitreich.org 70 i+ gsub("^ *", ""); gsub(" *$", "") Err bitreich.org 70 i+ gsub(" *<[a-zA-Z0-9/]*>* *", "") Err bitreich.org 70 i Err bitreich.org 70 i if (match($0, "^ ")) { Err bitreich.org 70 i- event[type] = event[type] substr($0, 2, length($0) - 1); Err bitreich.org 70 i+ event[type] = event[type] substr($0, 2, length($0) - 1) Err bitreich.org 70 i } else { Err bitreich.org 70 i- type = $1; Err bitreich.org 70 i- i = index($0, ":"); Err bitreich.org 70 i- event[type] = substr($0, i + 1, length($0) - i); Err bitreich.org 70 i+ type = $1 Err bitreich.org 70 i+ i = index($0, ":") Err bitreich.org 70 i+ event[type] = substr($0, i + 1, length($0) - i) Err bitreich.org 70 i } Err bitreich.org 70 i Err bitreich.org 70 i if ($0 ~ /END:VEVENT/) Err bitreich.org 70 i- list[++nb] = sprintf("%d\t%d\t%s\t%s\t%s\t%s", Err bitreich.org 70 i+ list[++n] = sprintf("%d\t%d\t%s\t%s\t%s\t%s", Err bitreich.org 70 i date_ical(event["DTSTART"], offset), Err bitreich.org 70 i date_ical(event["DTEND"], offset), Err bitreich.org 70 i- event["CATEGORIES"], Err bitreich.org 70 i event["SUMMARY"], Err bitreich.org 70 i event["LOCATION"], Err bitreich.org 70 i- event["DESCRIPTION"]); Err bitreich.org 70 i- } Err bitreich.org 70 i- sort(list, 1, nb); Err bitreich.org 70 i- return nb; Err bitreich.org 70 i-} Err bitreich.org 70 i- Err bitreich.org 70 i-function txt_one(beg, end, cat, sum, loc, des, offset) { Err bitreich.org 70 i- b = to_date("%04d/%02d/%02d %02d:%02d", beg + offset); Err bitreich.org 70 i- e = to_date("%04d/%02d/%02d %02d:%02d", end + offset); Err bitreich.org 70 i- b_mth = substr(b, 1, 7); Err bitreich.org 70 i- b_day = substr(b, 9, 2); Err bitreich.org 70 i- e_day = substr(e, 9, 2); Err bitreich.org 70 i- b_hrs = substr(b, 12); Err bitreich.org 70 i- e_hrs = substr(e, 12); Err bitreich.org 70 i- Err bitreich.org 70 i- printf("%s\n%2s %2s %s\n%2s %2s %s%s\n", Err bitreich.org 70 i- (b_mth != l_mth) ? ("\n[" b_mth "]\n") : (""), Err bitreich.org 70 i- (b_day != l_day) ? (b_day) : (""), b_hrs, sum, Err bitreich.org 70 i- (b_day != e_day) ? (e_day) : (""), e_hrs, Err bitreich.org 70 i- (cat) ? ("[" cat "] ") : (""), loc); Err bitreich.org 70 i- Err bitreich.org 70 i- while ((line = substr(des, 1, 66)) != "") { Err bitreich.org 70 i- if (length(line) == 66) Err bitreich.org 70 i- sub(" +[^ ]*$", "", line); Err bitreich.org 70 i- des = substr(des, length(line) + 2); Err bitreich.org 70 i- sub("^ *", "", line); Err bitreich.org 70 i- sub("^ *", "", des); Err bitreich.org 70 i- printf(" %s\n", line); Err bitreich.org 70 i+ event["DESCRIPTION"]) Err bitreich.org 70 i } Err bitreich.org 70 i- l_mth = b_mth; Err bitreich.org 70 i- l_day = b_day; Err bitreich.org 70 i+ sort(list, 1, n) Err bitreich.org 70 i+ return n Err bitreich.org 70 i } Err bitreich.org 70 i Err bitreich.org 70 i-function txt(offset) Err bitreich.org 70 i+function print_fold(prefix, s, n) Err bitreich.org 70 i { Err bitreich.org 70 i- nb = parse_ical(list, offset); Err bitreich.org 70 i- for (i = 1; i <= nb; i++) { Err bitreich.org 70 i- split(list[i], arr, "\t"); Err bitreich.org 70 i- txt_one(arr[1], arr[2], arr[3], arr[4], arr[5], arr[6], offset); Err bitreich.org 70 i+ while (s != "") { Err bitreich.org 70 i+ line = substr(s, 1, n) Err bitreich.org 70 i+ if (length(s) > n) sub(" +[^ \t\r\n]*$", "", line) Err bitreich.org 70 i+ print prefix line Err bitreich.org 70 i+ s = substr(s, length(line) + 2) Err bitreich.org 70 i } Err bitreich.org 70 i } Err bitreich.org 70 i Err bitreich.org 70 i-function tsv(offset) Err bitreich.org 70 i+function print_entry(beg, end, summary, location, description, offset) Err bitreich.org 70 i { Err bitreich.org 70 i- nb = parse_ical(list, offset); Err bitreich.org 70 i- for (i = 1; i <= nb; i++) Err bitreich.org 70 i- print(list[i]); Err bitreich.org 70 i-} Err bitreich.org 70 i+ b = to_date("%04d-%02d-%02d %02d:%02d", beg + offset) Err bitreich.org 70 i+ e = to_date("%04d-%02d-%02d %02d:%02d", end + offset) Err bitreich.org 70 i+ date = substr(b, 1, 10) Err bitreich.org 70 i+ hour_beg = substr(b, 12) Err bitreich.org 70 i+ hour_end = substr(e, 12) Err bitreich.org 70 i+ Err bitreich.org 70 i+ if (date != last_date) print "\n" date Err bitreich.org 70 i+ print "\n" hour_beg "\t" summary Err bitreich.org 70 i+ done = 0 Err bitreich.org 70 i+ if (category) printf("%s\t%s\n", !done++ ? hour_end : "", category) Err bitreich.org 70 i+ if (location) printf("%s\t%s\n", !done++ ? hour_end : "", location) Err bitreich.org 70 i+ if (description) { Err bitreich.org 70 i+ printf("%s", !done++ ? hour_end : "") Err bitreich.org 70 i+ print_fold("\t", description, 70) Err bitreich.org 70 i+ } Err bitreich.org 70 i Err bitreich.org 70 i-function usage() Err bitreich.org 70 i-{ Err bitreich.org 70 i- print("usage: ics2txt txt file.ics..."); Err bitreich.org 70 i- print(" ics2txt tsv file.ics..."); Err bitreich.org 70 i+ last_date = date Err bitreich.org 70 i } Err bitreich.org 70 i Err bitreich.org 70 i BEGIN { Err bitreich.org 70 i- "date +%z" | getline offset_str; Err bitreich.org 70 i- close("date +%z"); Err bitreich.org 70 i+ "date +%z" | getline offset_str Err bitreich.org 70 i+ close("date +%z") Err bitreich.org 70 i Err bitreich.org 70 i- offset = substr(offset_str, 2, 2) * 3600; Err bitreich.org 70 i- offset += substr(offset_str, 4, 2) * 60; Err bitreich.org 70 i+ offset = substr(offset_str, 2, 2) * 3600 Err bitreich.org 70 i+ offset += substr(offset_str, 4, 2) * 60 Err bitreich.org 70 i if (substr(offset_str, 1, 1) == "-") Err bitreich.org 70 i- offset *= -1; Err bitreich.org 70 i- Err bitreich.org 70 i- if (ARGV[1] == "txt") { Err bitreich.org 70 i- ARGV[1] = ARGV[--ARGC]; Err bitreich.org 70 i- txt(offset); Err bitreich.org 70 i- } else if (ARGV[1] == "tsv") { Err bitreich.org 70 i- ARGV[1] = ARGV[--ARGC]; Err bitreich.org 70 i- tsv(offset); Err bitreich.org 70 i- } else { Err bitreich.org 70 i- usage(); Err bitreich.org 70 i+ offset *= -1 Err bitreich.org 70 i+ Err bitreich.org 70 i+ n = parse_ical(list, offset) Err bitreich.org 70 i+ for (i = 1; i <= n; i++) { Err bitreich.org 70 i+ split(list[i], arr, "\t") Err bitreich.org 70 i+ print_entry(arr[1], arr[2], arr[3], arr[4], arr[5], arr[6], offset) Err bitreich.org 70 i } Err bitreich.org 70 i+ print "" Err bitreich.org 70 i } Err bitreich.org 70 1diff --git a/ics2txt.1 b/ics2txt.1 /scm/ics2txt/file/ics2txt.1.gph bitreich.org 70 i@@ -6,13 +6,12 @@ Err bitreich.org 70 i .Sh NAME Err bitreich.org 70 i . Err bitreich.org 70 i .Nm ics2txt Err bitreich.org 70 i-.Nd convert ics file to plain text or TSV Err bitreich.org 70 i+.Nd convert ics file to a simple plain text format Err bitreich.org 70 i . Err bitreich.org 70 i . Err bitreich.org 70 i .Sh SYNOPSIS Err bitreich.org 70 i . Err bitreich.org 70 i-.Nm Ic txt Oo +- Oc Ns Ar offset Op Ar ics file... Err bitreich.org 70 i-.Nm Ic tsv Oo +- Oc Ns Ar offset Op Ar ics file... Err bitreich.org 70 i+.Nm Ar ics-file... Err bitreich.org 70 i . Err bitreich.org 70 i . Err bitreich.org 70 i .Sh DESCRIPTION Err bitreich.org 70 i@@ -23,42 +22,6 @@ displays iCalendar Err bitreich.org 70 i .Ar file Err bitreich.org 70 i or stdin if not specified in the format described by the command: Err bitreich.org 70 i . Err bitreich.org 70 i-.Bl -tag -width indent Err bitreich.org 70 i-. Err bitreich.org 70 i-.It Ic txt Err bitreich.org 70 i-Display the ics2txt(s) Err bitreich.org 70 i-.Ar file Err bitreich.org 70 i-as plain text sorted by date. Err bitreich.org 70 i-. Err bitreich.org 70 i-.It Ic tsv Err bitreich.org 70 i-Display the ics2txt(s) Err bitreich.org 70 i-.Ar file Err bitreich.org 70 i-as a tab-separated values Err bitreich.org 70 i-.Pq tsv Err bitreich.org 70 i-one entry per line, with the following fields in order: Err bitreich.org 70 i-. Err bitreich.org 70 i-.Bl -tag -width xDESCRIPTIONx -compact Err bitreich.org 70 i-. Err bitreich.org 70 i-.It Dq Li DTSTART Err bitreich.org 70 i-begin date as an UNIX timestamp Err bitreich.org 70 i-. Err bitreich.org 70 i-.It Dq Li DTEND Err bitreich.org 70 i-end date as an UNIX timestamp Err bitreich.org 70 i-. Err bitreich.org 70 i-.It Dq Li CATEGORY Err bitreich.org 70 i-category Err bitreich.org 70 i-. Err bitreich.org 70 i-.It Dq Li SUMMARY Err bitreich.org 70 i-symmary Err bitreich.org 70 i-. Err bitreich.org 70 i-.It Dq Li LOCATION Err bitreich.org 70 i-location Err bitreich.org 70 i-. Err bitreich.org 70 i-.It Dq Li DESCRIPTION Err bitreich.org 70 i-description Err bitreich.org 70 i-. Err bitreich.org 70 i-.El Err bitreich.org 70 i-. Err bitreich.org 70 i . Err bitreich.org 70 i .Sh ENVIRONMENT Err bitreich.org 70 i . Err bitreich.org 70 i@@ -74,8 +37,7 @@ Timezone to use for printing the dates. Err bitreich.org 70 i . Err bitreich.org 70 i .Xr cal 1 , Err bitreich.org 70 i .Xr calendar 1 , Err bitreich.org 70 i-.Xr date 1 , Err bitreich.org 70 i-.Xr txt2ics 1 Err bitreich.org 70 i+.Xr date 1 Err bitreich.org 70 i . Err bitreich.org 70 i .Sh STANDARDS Err bitreich.org 70 i . Err bitreich.org 70 1diff --git a/txt2ics b/txt2ics /scm/ics2txt/file/txt2ics.gph bitreich.org 70 i@@ -1,93 +0,0 @@ Err bitreich.org 70 i-#!/usr/bin/awk -f Err bitreich.org 70 i- Err bitreich.org 70 i-function prompt(msg) Err bitreich.org 70 i-{ Err bitreich.org 70 i- if (TTY) Err bitreich.org 70 i- printf("%s", msg) >"/dev/stderr"; Err bitreich.org 70 i- if (!getline str) Err bitreich.org 70 i- exit(1); Err bitreich.org 70 i- return str; Err bitreich.org 70 i-} Err bitreich.org 70 i- Err bitreich.org 70 i-function parse_date(str, tm) Err bitreich.org 70 i-{ Err bitreich.org 70 i- if (length(str) == 5) { Err bitreich.org 70 i- "date +%Y/%m/%d" | getline date Err bitreich.org 70 i- str = date " " str ; Err bitreich.org 70 i- close("date +%Y/%m/%d"); Err bitreich.org 70 i- } Err bitreich.org 70 i- Err bitreich.org 70 i- if (length(str) != 16) { Err bitreich.org 70 i- print("invalid date length") >"/dev/stderr"; Err bitreich.org 70 i- return -1; Err bitreich.org 70 i- } Err bitreich.org 70 i- Err bitreich.org 70 i- tm["yrs"] = substr(str, 1, 4); Err bitreich.org 70 i- if (! match(tm["yrs"], "^[0-9]+$")) { Err bitreich.org 70 i- print("invalid year: " tm["yrs"]) >"/dev/stderr"; Err bitreich.org 70 i- return -1; Err bitreich.org 70 i- } Err bitreich.org 70 i- Err bitreich.org 70 i- tm["mth"] = substr(str, 6, 2); Err bitreich.org 70 i- if (! match(tm["mth"], "^[0-1][0-9]$")) { Err bitreich.org 70 i- print("invalid month: " tm["mth"]) >"/dev/stderr"; Err bitreich.org 70 i- return -1; Err bitreich.org 70 i- } Err bitreich.org 70 i- Err bitreich.org 70 i- tm["day"] = substr(str, 9, 2); Err bitreich.org 70 i- if (! match(tm["day"], "^[0-3][0-9]$")) { Err bitreich.org 70 i- print("invalid day: " tm["day"]) >"/dev/stderr"; Err bitreich.org 70 i- return -1; Err bitreich.org 70 i- } Err bitreich.org 70 i- Err bitreich.org 70 i- tm["hrs"] = substr(str, 12, 2); Err bitreich.org 70 i- if (! match(tm["hrs"], "^[0-2][0-9]$")) { Err bitreich.org 70 i- print("invalid hours: " tm["hrs"]) >"/dev/stderr"; Err bitreich.org 70 i- return -1; Err bitreich.org 70 i- } Err bitreich.org 70 i- Err bitreich.org 70 i- tm["min"] = substr(str, 15, 2); Err bitreich.org 70 i- if (! match(tm["min"], "^[0-6][0-9]$")) { Err bitreich.org 70 i- print("invalid minutes: " tm["min"]) >"/dev/stderr"; Err bitreich.org 70 i- return -1; Err bitreich.org 70 i- } Err bitreich.org 70 i- Err bitreich.org 70 i- return 0; Err bitreich.org 70 i-} Err bitreich.org 70 i- Err bitreich.org 70 i-BEGIN { Err bitreich.org 70 i- TTY = !system("tty >/dev/null"); Err bitreich.org 70 i- Err bitreich.org 70 i- if (TTY) { Err bitreich.org 70 i- "date +%Y" | getline yrs Err bitreich.org 70 i- close("date +%Y"); Err bitreich.org 70 i- system("cal " yrs ">/dev/stderr"); Err bitreich.org 70 i- system("date >/dev/stderr"); Err bitreich.org 70 i- system("date +'%Y/%m/%d %H:%M' >/dev/stderr"); Err bitreich.org 70 i- print("") >"/dev/stderr"; Err bitreich.org 70 i- } Err bitreich.org 70 i- Err bitreich.org 70 i- do beg = prompt("Start [YYYY/MM/DD HH:MM] or [HH:MM] for today: "); Err bitreich.org 70 i- while (parse_date(beg, tm_beg) == -1); Err bitreich.org 70 i- Err bitreich.org 70 i- do end = prompt("End [YYYY/MM/DD HH:MM] or [HH:MM] for same day: "); Err bitreich.org 70 i- while (parse_date(end, tm_end) == -1); Err bitreich.org 70 i- Err bitreich.org 70 i- sum = prompt("Summary: "); Err bitreich.org 70 i- cat = prompt("Category: "); Err bitreich.org 70 i- loc = prompt("Location: "); Err bitreich.org 70 i- des = prompt("Description: "); Err bitreich.org 70 i- Err bitreich.org 70 i- print("BEGIN:VEVENT"); Err bitreich.org 70 i- print("DTSTART:" \ Err bitreich.org 70 i- tm_beg["yrs"] tm_beg["mth"] tm_beg["day"] "T" \ Err bitreich.org 70 i- tm_beg["hrs"] tm_beg["min"] "00"); Err bitreich.org 70 i- print("DTEND:" \ Err bitreich.org 70 i- tm_end["yrs"] tm_end["mth"] tm_end["day"] "T" \ Err bitreich.org 70 i- tm_end["hrs"] tm_end["min"] "00"); Err bitreich.org 70 i- if (cat) print("CATEGORIES:" cat); Err bitreich.org 70 i- if (sum) print("SUMMARY:" sum); Err bitreich.org 70 i- if (des) print("DESCRIPTION:" des); Err bitreich.org 70 i- if (loc) print("LOCATION:" loc); Err bitreich.org 70 i- print("END:VEVENT"); Err bitreich.org 70 i-} Err bitreich.org 70 1diff --git a/txt2ics.1 b/txt2ics.1 /scm/ics2txt/file/txt2ics.1.gph bitreich.org 70 i@@ -1,51 +0,0 @@ Err bitreich.org 70 i-.Dd $Mdocdate: May 30 2018$ Err bitreich.org 70 i-.Dt TXT2ICS 1 Err bitreich.org 70 i-.Os Err bitreich.org 70 i-. Err bitreich.org 70 i-. Err bitreich.org 70 i-.Sh NAME Err bitreich.org 70 i-. Err bitreich.org 70 i-.Nm txt2ics Err bitreich.org 70 i-.Nd convert plain text to an ics file Err bitreich.org 70 i-. Err bitreich.org 70 i-. Err bitreich.org 70 i-.Sh SYNOPSIS Err bitreich.org 70 i-. Err bitreich.org 70 i-.Nm Err bitreich.org 70 i-. Err bitreich.org 70 i-. Err bitreich.org 70 i-.Sh DESCRIPTION Err bitreich.org 70 i-. Err bitreich.org 70 i-.Nm Err bitreich.org 70 i-prompts the user for event information and print them in the iCalendar format. Err bitreich.org 70 i-If stdin is ont a TTY, it will not print the prompt string and act as a Err bitreich.org 70 i-converter tool. Err bitreich.org 70 i-. Err bitreich.org 70 i-.Pp Err bitreich.org 70 i-It uses Err bitreich.org 70 i-.Dq floating events : Err bitreich.org 70 i-If it is 12:30, it will always be 12:30 of the country he resides in: if he moves Err bitreich.org 70 i-to another time zone, it will be 12:30 of this new time zone. Err bitreich.org 70 i-See this as the time zone where the event happen. Err bitreich.org 70 i-. Err bitreich.org 70 i-. Err bitreich.org 70 i-.Sh SEE ALSO Err bitreich.org 70 i-. Err bitreich.org 70 i-.Xr cal 1 , Err bitreich.org 70 i-.Xr calendar 1 , Err bitreich.org 70 i-.Xr date 1 , Err bitreich.org 70 i-.Xr ics2txt 1 Err bitreich.org 70 i-. Err bitreich.org 70 i-.Sh STANDARDS Err bitreich.org 70 i-. Err bitreich.org 70 i-.Rs Err bitreich.org 70 i-.%A Desruisseaux Err bitreich.org 70 i-.%D September 2009 Err bitreich.org 70 i-.%T Internet Calendaring and Scheduling Core Object Specification (iCalendar) Err bitreich.org 70 i-.%R RFC 5545 Err bitreich.org 70 i-.Re Err bitreich.org 70 i-. Err bitreich.org 70 i-. Err bitreich.org 70 i-.Sh AUTHORS Err bitreich.org 70 i-. Err bitreich.org 70 i-.An Josuah Demangeon Aq Mt mail@josuah.net Err bitreich.org 70 .