Event

This entity represents an event.

See also: EventParticipation

Properties

Property Type (Length) Description
author diaspora* ID The diaspora* ID of the author of the event.
guid GUID The GUID of the event.
summary String (255) The summary of the event.
start Timestamp The start time of the event (in UTC).

Optional Properties

Property Type (Length) Description
end Timestamp The end time of the event (in UTC). If missing it is an open-end or a single all_day event.
all_day Boolean true if it is an all day event. Time/timezone is ignored. false by default.
timezone Timezone If the event is fixed to a specific timezone, this can be set. The start/end timestamps are then displayed in this timezone. This is useful for local events. If missing or empty the timestamps are displayed in the timezone of the user.
description Markdown (65535) Description of the event.
location Location Location of the event.

Examples

With start, end and timezone

<event>
  <author>alice@example.org</author>
  <guid>bb8371f0b1c901342ebd55853a9b5d75</guid>
  <summary>Cool event</summary>
  <start>2016-12-27T12:00:00Z</start>
  <end>2016-12-27T13:00:00Z</end>
  <all_day>false</all_day>
  <timezone>Europe/Berlin</timezone>
  <description>You need to see this!</description>
  <location>
    <address>Vienna, Austria</address>
    <lat>48.208174</lat>
    <lng>16.373819</lng>
  </location>
</event>

All day event

<event>
  <author>alice@example.org</author>
  <guid>bb8371f0b1c901342ebd55853a9b5d75</guid>
  <summary>Cool event</summary>
  <start>2016-12-27T00:00:00Z</start>
  <end/>
  <all_day>true</all_day>
  <timezone/>
  <description>You need to see this!</description>
  <location>
    <address>Vienna, Austria</address>
    <lat>48.208174</lat>
    <lng>16.373819</lng>
  </location>
</event>