Date & Time Formats

MagiCal allows you to specify the format used for the date or time using a special format string. In the pop-up list of time/date formats, several example formats are provided to give you an idea of what is possible.

The variety of formatting options is near infinite however, and it would be impossible to include all possibilities in the list. For this reason, the elements that make up the different format options are documented below. You can combine these in any order by simply typing the desired characters into the popup format field.

Note that if you use any characters (including space) that are not listed below they will appear literally in the time or date as you have written them. So you can use the colon (:) or slash (/) characters as time/date separators if you wish, as they have no specially defined meaning in the format string.

The backslash (\) character is used for escaping formatting characters so you can use them literally. For example "D" will be replaced by the numeric day of the month in the date text, but "\D" will appear as the letter "D". To produce a literal "\", use two backslashes in a row, like this: "\\".

If you are having trouble creating the format you want, feel free to contact us and we will be happy to help.

Date Formats

Month
The month of the year, e.g. January.
MONTH
The month of the year in all capitals, e.g. JANUARY.
month
The month of the year in all lower case e.g. january.
Mon
The month of the year, truncated to three letters, e.g. Jan for January.
MON
The month of the year, truncated to three letters and in all capitals, e.g. JAN for January.
mon
The month of the year, truncated to three letters and in all lower case e.g. jan for January.
Weekday
The day of the week, e.g. Monday.
WEEKDAY
The day of the week in all capitals, e.g. MONDAY.
weekday
The day of the week in all lower case e.g. monday.
Day
The day of the week, truncated to three letters, e.g. Mon for Monday.
DAY
The day of the week, truncated to three letters and in all capitals, e.g. MON for Monday.
day
The day of the week, truncated to three letters and in all lower case e.g. mon for Monday.
Da
The day of the week, truncated to two letters, e.g. Mo for Monday.
DA
The day of the week, truncated to two letters and in all capitals, e.g. MO for Monday.
da
The day of the week, truncated to two letters and in all lower case e.g. mo for Monday.
D
The numerical day of the month.
DD
The numerical day of the month, padded to two figures with a zero if necessary.
YY
The last two digits of the current year, e.g. 07.
YYYY
The current year in full, e.g. 2007.
M
The numerical month of the year, e.g. 1 for January.
MM
The numerical month of the year, padded to two figures with a zero if necessary, e.g. 01 for January.
Th
To be used after the numeric day of the month, eg. 1St, 2Nd, 3Rd, 4Th...
TH
As above but in all capitals, e.g. 1ST, 2ND, 3RD, 4TH...
th
As above but in all lower case, e.g. 1st, 2nd, 3rd, 4th...
W
The numerical week of the year, between 1 and 53.
WW
The week of the year, padded to two figures with a zero if necessary, e.g. 01, 02, etc.
d
The numerical day of the year, between 1 and 365.
ddd
The day of the year, padded to three figures with leading zeros if necessary, e.g. 001, 002, 056, etc.
\
Escape character - makes the subsequent letter, number or punctuation character (including "\" itself) appear as written, irrespective of any special meaning.

Time Formats

Weekday
The day of the week, e.g. Monday.
WEEKDAY
The day of the week in all capitals, e.g. MONDAY.
weekday
The day of the week in all lower case e.g. monday.
Day
The day of the week, truncated to three letters, e.g. Mon for Monday.
DAY
The day of the week, truncated to three letters and in all capitals, e.g. MON for Monday.
day
The day of the week, truncated to three letters and in all lower case e.g. mon for Monday.
Da
The day of the week, truncated to two letters, e.g. Mo for Monday.
DA
The day of the week, truncated to two letters and in all capitals, e.g. MO for Monday.
da
The day of the week, truncated to two letters and in all lower case e.g. mo for Monday.
H
The hour of the day (12 hour clock).
HH
The hour of the day (12 hour clock), padded to two figures with a zero if necessary.
M
The minutes of the hour.
MM
The minutes of the hour, padded to two figures with a zero if necessary.
S
The seconds of the minute.
SS
The seconds of the minute, padded to two figures with a zero if necessary.
2
The hour of the day (24 hour clock).
24
The hour of the day (24 hour clock), padded to two figures with a zero if necessary.
am / pm
For use with a 12 hours clock, indicates morning or afternoon.
AM / PM
As above, but in all capitals.
a.m. / p.m.
As above, but with period separators.
A.M. / P.M.
As above, but in all capitals and with period separators.
Fuzzy
The time in plain English, rounded to the nearest five minutes, e.g. Half Past Ten, Quarter To Eight.
FUZZY
As above, but in all capitals, e.g. HALF PAST TEN, QUARTER TO EIGHT.
fuzzy
As above, but in all lower case, e.g. half past ten, quarter to eight.
\
Escape character - makes the subsequent letter, number or punctuation character (including "\" itself) appear as written, irrespective of any special meaning.