getEvents

Returns the calendar's event list. With no arguments it returns every stored event. With start and end, it returns only events that overlap that range.

Usage

getEvents(start?: Date, end?: Date): CalendarEvent[];

Parameters:

Parameter	Type	Description
start	Date	Optional range start. Returns events ending at or after this date.
end	Date	Optional range end. Returns events starting at or before this date.

Returns: CalendarEvent[].

Field	Type	Description
id	string | number	Unique event id.
start	Date	Event start time.
end	Date	Event end time.
allDay	boolean	Optional. All-day flag.
[key]	any	Custom fields preserved on the event.

When recurring is enabled, the returned list contains expanded occurrences, not master events. Each generated occurrence gets an id built with encodeId(masterId, { eventDate }) - a #-delimited string such as "42###2026-03-09", not "masterId:YYYY-MM-DD".

Example

<script setup lang="ts">
    import { ref } from "vue";
    import { Calendar } from "@svar-ui/vue-calendar";
    import type { CalendarInstanceApi } from "@svar-ui/vue-calendar";

    const api = ref<CalendarInstanceApi | undefined>();

    function exportAll() {
        const all = api.value.getEvents();
        console.log(all);
    }

    function exportThisWeek() {
        const start = new Date();
        const end = new Date();
        end.setDate(start.getDate() + 7);
        const events = api.value.getEvents(start, end);
        console.log(events);
    }
</script>

<template>
    <Calendar :events="events" ref="api" />
    <button :onclick="exportAll">All events</button>
    <button :onclick="exportThisWeek">This week</button>
</template>

Related articles

• getEvent — look up a single event by id.
• events — the source array.
• recurring — when enabled, this method returns expanded instances.
• serializeICal — pair with getEvents() to export as .ics.
• Loading — event shape, loading from JSON or iCal, and exporting back to .ics.