WOLFRAM

Wolfram Language & System Documentation Center

VCS (.vcs)

  • Import fully supports VCS version 1.

Background & Context

    • MIME types: text/calendar
    • VCS vCalendar format.
    • Used for the storage and exchange of calendar information and in personal information management applications.
    • Superseded by the ICS format.
    • Plain text format.
    • Stores multiple events and tasks in a single file.
    • Developed in 1996.

Import

  • Import["file.vcs"] imports all events from a VCS file.
  • Import["file.vcs"] gives a list of rules for each event stored in the file.
  • Import["file.vcs",elem] imports the specified element from a VCS file.
  • Import["file.vcs",{elem,sub,…}] imports a subelement.
  • Import["file.vcs",{{elem1,elem2,…}}] imports multiple elements.
  • The import format can be specified with Import["file","VCS"] or Import["file",{"VCS",elem,…}].
  • See the following reference pages for full general information:
  • Importimport from a file
    CloudImportimport from a cloud object
    ImportStringimport from a string
    ImportByteArrayimport from a byte array

Import Elements

  • General Import elements:
  • "Elements" list of elements and options available in this file
    "Summary"summary of the file
    "Rules"list of rules for all available elements
  • Data representation elements:
  • "Events"event data, given as lists of rules
    "Tasks"task data, given as lists of rules
    "TimeZone"time zone information, given as a list of rules
  • Import uses the "Events" element by default.
  • Import["file.vcs"] reads all events and returns them as a list of a list of rules.
  • Meta-information elements:
  • "Creator"application that created this file
    "GeoPosition"location of the system used to create the calendar

Options

  • Import options:
  • "EmptyField"Automatichow missing information is represented

Examples

open all close all

Basic Examples  (3)

Import the first event in a VCS file:

Wolfram Language code: Import["ExampleData/calendar.vcs", {"Events", 1}]

Import tasks from VCS:

Wolfram Language code: Import["ExampleData/calendar.vcs", "Tasks"]

Get time zone information from a file:

Wolfram Language code: Import["ExampleData/calendar.vcs", "TimeZone"]

Scope  (1)

Import all event summaries and start dates from a file, and display them in table form:

Wolfram Language code: TableForm[Import["ExampleData/calendar.vcs", {"Events", All, {"Summary", "StartDate", "StartDateTimeZone"}}], TableHeadings -> {None, {"Event", "Date", "Time Zone"}}, TableDepth -> 2]