JSCalendar: Converting from and to iCalendar
draft-ietf-calext-jscalendar-icalendar-01

Document Type Active Internet-Draft (calext WG)
Last updated 2019-06-29
Stream IETF
Intended RFC status Informational
Formats plain text xml pdf htmlized bibtex
Stream WG state WG Document
Document shepherd No shepherd assigned
IESG IESG state I-D Exists
Consensus Boilerplate Unknown
Telechat date
Responsible AD (None)
Send notices to (None)
Calendaring extensions                                        N. Jenkins
Internet-Draft                                               R. Stepanek
Intended status: Informational                                  FastMail
Expires: December 31, 2019                                 June 29, 2019

              JSCalendar: Converting from and to iCalendar
               draft-ietf-calext-jscalendar-icalendar-01

Abstract

   This document provides an informational guideline for converting
   JSCalendar from and to iCalendar.

Status of This Memo

   This Internet-Draft is submitted in full conformance with the
   provisions of BCP 78 and BCP 79.

   Internet-Drafts are working documents of the Internet Engineering
   Task Force (IETF).  Note that other groups may also distribute
   working documents as Internet-Drafts.  The list of current Internet-
   Drafts is at https://datatracker.ietf.org/drafts/current/.

   Internet-Drafts are draft documents valid for a maximum of six months
   and may be updated, replaced, or obsoleted by other documents at any
   time.  It is inappropriate to use Internet-Drafts as reference
   material or to cite them other than as "work in progress."

   This Internet-Draft will expire on December 31, 2019.

Copyright Notice

   Copyright (c) 2019 IETF Trust and the persons identified as the
   document authors.  All rights reserved.

   This document is subject to BCP 78 and the IETF Trust's Legal
   Provisions Relating to IETF Documents
   (https://trustee.ietf.org/license-info) in effect on the date of
   publication of this document.  Please review these documents
   carefully, as they describe your rights and restrictions with respect
   to this document.  Code Components extracted from this document must
   include Simplified BSD License text as described in Section 4.e of
   the Trust Legal Provisions and are provided without warranty as
   described in the Simplified BSD License.

Jenkins & Stepanek      Expires December 31, 2019               [Page 1]
Internet-Draft                 JSCalendar                      June 2019

Table of Contents

   1.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   2
     1.1.  Motivation  . . . . . . . . . . . . . . . . . . . . . . .   2
     1.2.  Scope and caveats . . . . . . . . . . . . . . . . . . . .   3
     1.3.  Notational Conventions  . . . . . . . . . . . . . . . . .   3
   2.  New iCalendar parameters  . . . . . . . . . . . . . . . . . .   3
     2.1.  SUBSECOND parameter . . . . . . . . . . . . . . . . . . .   3
   3.  JSEvent . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
   4.  JSTask  . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
   5.  JSGroup . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
   6.  Common properties . . . . . . . . . . . . . . . . . . . . . .   5
     6.1.  Time properties and types . . . . . . . . . . . . . . . .   8
     6.2.  Locations . . . . . . . . . . . . . . . . . . . . . . . .   9
     6.3.  Participants  . . . . . . . . . . . . . . . . . . . . . .  10
   7.  Custom properties . . . . . . . . . . . . . . . . . . . . . .  12
   8.  Security Considerations . . . . . . . . . . . . . . . . . . .  12
   9.  IANA Considerations . . . . . . . . . . . . . . . . . . . . .  12
   10. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . .  12
   11. References  . . . . . . . . . . . . . . . . . . . . . . . . .  12
     11.1.  Normative References . . . . . . . . . . . . . . . . . .  12
     11.2.  Informative References . . . . . . . . . . . . . . . . .  13
   Authors' Addresses  . . . . . . . . . . . . . . . . . . . . . . .  13

1.  Introduction

1.1.  Motivation

   The JSCalendar [draft-ietf-calext-jscalendar] data format is used to
   represent calendar data, and is meant as an alternative to the widely
   deployed iCalendar [RFC5545] data format.

   While new calendaring services and applications might use JSCalendar
   as their main data format to exchange calendaring data, they are
   likely to interoperate with services and clients that just support
   iCalendar.  Similarly, existing calendaring data is stored in
   iCalendar format in databases and other calendar stores, and
   providers and users might want to represent this data also in
   JSCalendar.  Lastly, some implementations might want to preserve
   custom iCalendar properties, that have no equivalent in JSCalendar
   when converting between these formats.

   To facilitate these use cases, this document provides an
   informational guide how to convert JSCalendar data from and to
   iCalendar.

Jenkins & Stepanek      Expires December 31, 2019               [Page 2]
Internet-Draft                 JSCalendar                      June 2019

1.2.  Scope and caveats

   JSCalendar and iCalendar have a lot of semantics in common, but they
   are not interchangeable formats:

   o  JSCalendar contains a richer data model to express calendar
      information such as event locations and participants; while future
Show full document text