Calendar Documentation

Learn the basics, and get to know Calendar inside and out.

Date Formatting

In addition to standard EE date formatting, Calendar supports easy-to-use text format versions of dates for all parameters that accept date values. Text dates are relative to today. So for example, you can specify dates like this:

  • today
  • tomorrow
  • yesterday
  • X day(s) (where X is a number of days greater than or equal to 1)
  • X week(s) (where X is a number of weeks greater than or equal to 1)
  • X month(s) (where X is a number of months greater than or equal to 1)
  • X year(s) (where X is a number of years greater than or equal to 1)
  • The word ago can also be appended to refer to dates in the past. For example, 1 week means one week from today, while 1 week ago means one week ago.

To display all events that fall within today’s date, up to 3 months in the future, you can do something like this:

date_range_start="today" date_range_end="3 months"

Regular date syntax is also available:

  • YYYYMMDD
  • YYYY-MM-DD
  • year-month-day (where year is current year, month is current month and day is current day)

When using either YYYY-MM-DD, you may replace one or more of the numeric values with the literal words year, month, and/or day. Calendar will then replace that word with the relevant value for the current date. Examples:

  • year-12-25 = Christmas Day in the current year.
  • 2015-month-15 = The fifteenth day of the current month in 2015.

The literal value year-month-day is equivalent to “today”. You may also use the word “last” instead of “day”. Doing so will set the date to the final day of the relevant month. Examples:

  • 2015-02-last = February 28, 2015
  • 2016-02-last = February 29, 2016
  • year-month-last = The last day of the current month of the current year.