logo

FullCalendar

This version is a pre-release. Read the release notes

dateClick

Triggered when the user clicks on a date or a time.

function( dateClickInfo ) { }

dateClickInfo is a plain object with the following properties:

date

a Date for the clicked day/time.

dateStr

An ISO8601 string representation of the date. Will have a time zone offset according to the calendar’s timeZone like 2018-09-01T12:30:00-05:00. If clicked on an all-day cell, won’t have a time part nor a time zone part, like 2018-09-01.

allDay

true or false whether the click happened on an all-day cell.

dayEl

An HTML element that represents the whole-day that was clicked on.

jsEvent

The native JavaScript event with low-level information such as click coordinates.

view

The current View Object.

resource

If the current view is a resource-view, the Resource Object that owns this date. Must be using the Scheduler plugin.

Here is an example that demonstrates some of these properties:

var calendar = new Calendar(calendarEl, {

  dateClick: function(info) {

    alert('Clicked on: ' + info.dateStr);
    alert('Coordinates: ' + info.jsEvent.pageX + ',' + info.jsEvent.pageY);
    alert('Current view: ' + info.view.type);

    // change the day's background color just for fun
    info.dayEl.style.backgroundColor = 'red';
  }

});

List View

The dateClick trigger is not fired when the user clicks a day heading in list view.

Resource Views

For resource views, this callback will receive an additional Resource Object parameter. Example:

var calendar = new Calendar(calendarEl, {

  dateClick: function(info) {
    alert('Date: ' + info.dateStr);
    alert('Resource ID: ' + info.resource.id);
  }

});

This is only available with the Scheduler plugin.

See a demo of dateClick with resources.