These docs are for an old release.
Info on upgrading to v6
Docs Date Library
Date Parsing
FullCalendar’s API accepts date information in many places, such as when you set the initialDate or define an event’s start/end.
Date Objects
FullCalendar’s API exposes Date objects in many places such as dateClick or a View object’s activeStart/activeEnd.
Duration Object
A duration is a way to express an amount of time that has passed. It can also be used to express a time-of-day, in other words, the amount of time that has passed since the start of the day.
Date Formatting
The term “date formatting” means taking a Date object and converting it into a string. The string can either be a standard string format like ISO8601 (ex: '2018-05-01') or it can be something more custom that you can display to users.
defaultRangeSeparator
The separator text used for date-formatting ranges throughout the API.
Util Methods
formatDate
A utility function that formats a date into a string.
formatRange
Formats two dates, a start and an end, into a string. A separator string, most likely a dash, will be intelligently inserted between the two dates.
Calendar::formatDate
A method that formats a date into a string. It inherits the locale and time zone settings of the calendar it’s called on.
Calendar::formatIso
Formats a date into an ISO8601 string. Outputs a UTC offset appropriate to the calendar it’s called on.
Calendar::formatRange
Formats two dates, a start and an end, into a string. A separator string, most likely a dash, will be intelligently inserted between the two dates. Inherits the time zone and locale settings of the calendar it’s called on.
Plugins
Moment Plugin
Moment JS is a popular library for parsing, formatting, and manipulating dates. FullCalendar has a connector package that provides the following functionality:
Moment Timezone Plugin
Moment Timezone is a library for dealing with time zones. FullCalendar has a connector plugin that gives your calendar support for arbitrary named time zones. It provides a “named timezone implementation” for the timeZone setting.
Luxon 2 Plugin
Luxon is a JavaScript date library that cleverly leverages the browser’s native APIs for many things such as time zones, locales, and formatting. However, it requires IE11 and above, and if you want to use named time zones, it does not support IE at all, only Microsoft Edge. If these browser requirements are okay for your project, then all is good!
Luxon 1 Plugin
Luxon is a JavaScript date library that cleverly leverages the browser’s native APIs for many things such as time zones, locales, and formatting. However, it requires IE11 and above, and if you want to use named time zones, it does not support IE at all, only Microsoft Edge. If these browser requirements are okay for your project, then all is good!