Customizing Date and Time Formats

The display of dates and times in notifications and reports can configured. These date display formats are controlled by the date formats properties file.

To customize date and time formats:

  1. Download the date formats properties file to customize. Follow the instructions under Downloading a Properties File.
  • If you have never customized the date formats file before, or if you want to work with the original defaults provisioned for your organization, choose to Download the Default file.
  • If you have previously customized and uploaded a custom date formats file and want to change it, choose to Download the Customized file.
  • If your organization uses multiple languages, specify the language file to customize from the Locale drop-down list.
  1. Important! Rename the downloaded file with the following naming convention to indicate that the file is a custom file, the download date, language and locale version. For example: DateFormats_Custom_2009_12_08_en_US.properties.
  2. Open the renamed custom date formats file in a text editor that displays and saves the file correctly, such as WordPad.

CAUTION

Do not edit the default date formats file and then upload it. Always edit and upload the custom file.

  1. Edit the field values in the date formats file, then save the file.
  • Do not change any field names (text that precedes the equal sign) or any variables contained inside the values.
  • For a table of default values and example customizations, click here.
  • For a table of all possible symbols you can use to customize a date format, click here.
  • For general editing guidelines, see Creating a Custom Properties File.
  1. Return to the AlertFind web interface and validate the custom date formats file. See Validating a Custom Properties File.
  2. When the custom date formats file passes validation, upload it. See Uploading a Custom Properties File.
  3. The customizations can be removed by deleting your custom date formats file. AlertFind reverts to using the default file originally provisioned for the organization. See Deleting a Custom Properties File.

Default Format/Appears As

Sample Customization/Appears As

date_and_time=M/d/yyyy h:mma z
8/8/2018 4:00 PM CST

date_and_time=MMMM d, yyyy h:mma z
August 8, 2018 4:00 PM CST

date_only=M/d/yyyy
8/8/2018

date_only=d MMMM yyyy
8 August 2018

time_only=h:mma
4:00PM

time_only=h:mm (a)
4:00 (PM)

The following symbols are used to customize date and time formats:

Symbol

Stands For

Example

Appears As

M or MM

Month as a number

M/d/yyyy

8/8/2018

MMM or MMMM

Month in long form

MMMM d, yyyy

August 8, 2018

d

day

MMMM d, yyyy

August 8, 2018

yyyy or YYYY

year

MMMM d, yyyy

August 8, 2018

yy or YY

year in short form

M/d/yy

8/8/18

h

hour (1-12)

h:mm

4:00

mm

minutes (00-59)

h:mm

4:00

EEE

day of the week

EEE, M/d/yyyy

Wednesday, August 8, 2018

H

time on a 24 hour clock (0-23) NOTE: do not use AM/PM with this format

M/d/yyyy H:mm

August 8, 2018 16:00

a

AM/PM

h:mma

4:00 PM

z

time zone

h:mma z

4:00 PM CST

s

seconds in a minute

h:mm:s

4:00:49

‘ ‘ (single quote)

literal text

h:mm ‘o’ ‘clock’

4:00 o’clock

, (comma)

punctuation

MMMM d, yyyy

August 8, 2018