# events (as a function)

> FullCalendar v1 documentation, for an old release. Web version: https://legacy.fullcalendar.io/v1/events-function
>
> Latest version (v7): https://fullcalendar.io/docs/events-function.md

A custom function for programmatically generating [Event Objects](https://legacy.fullcalendar.io/v1/event-object.md).

<div class='spec' markdown='1'>
function( *start*, *end*, *callback* ) { }
</div>

FullCalendar will call this function whenever it needs new event data. This is triggered when the user clicks prev/next or switches views.

This function will be given `start` and `end` parameters, which are Date objects denoting the range the calendar needs events for.

It will also be given `callback`, a function that must be called when the custom event function has generated its events. It is the event function's responsibility to make sure `callback` is being called with an array of [Event Objects](https://legacy.fullcalendar.io/v1/event-object.md).

Here is an example showing how to use an event function to fetch events from a hypothetical XML feed:

```js
$('#calendar').fullCalendar({
  events: function(start, end, callback) {
    $.ajax({
      url: 'myxmlfeed.php',
      dataType: 'xml',
      data: {
        // our hypothetical feed requires UNIX timestamps
        start: Math.round(start.getTime() / 1000),
        end: Math.round(end.getTime() / 1000)
      },
      success: function(doc) {
        var events = [];
        $(doc).find('event').each(function() {
          events.push({
            title: $(this).attr('title'),
            start: $(this).attr('start') // will be parsed
          });
        });
        callback(events);
      }
    });
  }
});
```

However, if you have the choice, JSON is a better idea because you can just specify a [feed URL](https://legacy.fullcalendar.io/v1/events-json-feed.md).

## Extended Form

Since version 1.5, you are able to specify [Event Source options](https://legacy.fullcalendar.io/v1/event-source-object.md#options).
This often comes in handy when you are using the [eventSources](https://legacy.fullcalendar.io/v1/eventSources.md) option to
specify multiple event sources and you want certain options to only apply to certain sources.
However, to do this, you must write things a little differently:

```js
$('#calendar').fullCalendar({

  eventSources: [

    // your event source
    {
      events: function(start, end, callback) {
        // ...
      },
      color: 'yellow',   // an option!
      textColor: 'black' // an option!
    }

    // any other sources...

  ]

});
```