These docs are for an old release.
View the v7 docs
Docs Date Library
Date Parsing
FullCalendar’s API accepts date information in many places, such as when you set the defaultDate 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 Plugins
Moment JS is a popular library for parsing, formatting, and manipulating dates. There is also a separate but related project called Moment Timezone which adds time zone functionality to all moment objects. FullCalendar has a connector for each of these libraries.
Luxon Plugin
Luxon is an up-and-coming 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!