Skip to main content
Version: 2.1.x

Display Options

This section is used to configure how different aspects of Simple Calendar are displayed for this calendar.

Date/Time Formatting

A date time format is text containing special tokens. These tokens are replaced with the corresponding date/time information to create a finalized display of that date and time. Below is a list of the different tokens available to use in Simple Calendar and what they do.

SettingDescriptionDefault
Date FormatThis format text is used when displaying a date anywhere in Simple Calendar.MMMM DD, YYYY
Time FormatThis format text is used when displaying a time anywhere in Simple Calendar.HH:mm:ss
Month/Year FormatThis format text is used when displaying just the month and year that appears at the top of a calendar view, above the list of days.MMMM YAYYYYYZ

Below are the tokens used in the above settings fields to configure the date and time to display how you want it to.

TokenDescriptionExample Results
YearYYYear shorthand90 91 ... 19 20
YYYYFull year1990 1991 ... 2019 2020
YNYear name, as determined by the year name settings.Ral's Fury
YAYear prefix as defined in the Year Prefix setting.Pre
YZYear postfix as defined in the Year Postfix setting.AD
MonthMMonths number.1 2 ... 11 12
MMMonths number padded with a zero.01 02 ... 11 12
MMMThe months abbreviated name as defined in the months settings.Jan Feb ... Nov Dec
MMMMThe months full name as defined in the months settings.January February ... November December
DayDDay number.1 2 ... 30 31
DDDay number padded with a zero.01 02 ... 30 31
DODay number appended with its suffix.1st 2nd ... 30th 31st
WeekdaydThe number for the day of the week.1 2 ... 6 7
ddThe number for the day of the week padded with a zero.01 02 ... 06 07
dddThe abbreviated name for the day of the week as defined in the weekday settings.Sun Mon ... Fri Sat
ddddThe full name for the day of the week as defined in the weekday settings.Sunday Monday ... Friday Saturday
HourhThe hours number in the 12 hour format.1 2 ... 11 12
HThe hours number in the 24 hour format0 1 ... 22 23
hhThe hours number padded with a zero in the 12 hour format.01 02 ... 11 12
HHThe hours number padded with a zero in the 24 hour format.00 01 ... 22 23
aThe am/pm indicator for the 12 hour time format in lowercase.am pm
AThe AM/PM indicator for the 12 hour time format in uppercase.AM PM
MinutemThe minutes number.0 1 ... 58 59
mmThe minutes number padded with a zero.00 01 ... 58 59
SecondsThe seconds number.0 1 ... 58 59
ssThe seconds number padded with a zero.00 01 ... 58 59
Text[*] For any text that should be in the format but not processed place square brackets around it.[Don't process this text]

Compact View Options

The compact view has options to customize how it looks.

Compact View Date/Time Control Layout

Choose the layout for the buttons used to change the date/time of the calendar while in compact view.

The options are:

Full Controls

This is the default setting and will show both the Date / Time Adjuster and Dawn, Midday, Dusk and Midnight buttons.

Quick Increment

This setting shows a refined list of predefined values the date and time can be changed by. It also shows the Dawn, Midday, Dusk and Midnight buttons.

The list of predefined values are:

  • 1 Round (1r)
  • 1 Minute (1m)
  • 5 Minutes (5m)
  • 15 Minutes (15m)
  • 1 Hour (1h)

This setting also supports key modifiers to adjust those predefined values

  • Shift Key: When the shift key is held down the amount of time that is changed for each increment is increased from 1 round, 1 minute, 5 minutes, 15 minutes, 1 hour to 5 rounds, 5 minutes, 20 minutes, 45 minutes, 5 hours.
  • Control Key: When the control key is held down each increment will be subtracted from the current time, this can be combined with the shift key for going back in time by larger amounts.