This documentation supports the 18.08 version of Remedy Action Request System.

To view the latest version, select the version from the Product version menu.

Customizing Date and Time formats

You can create any date formats by combining field descriptors. Field descriptors represent different components of dates and times. Available field descriptors might differ, depending on your UNIX computer type. By default, the BMC Remedy AR System uses the format "%x %X".

The following table lists the UNIX field descriptors that you can use with ARDATE, ARDATEONLY, and ARTIMEONLY.

Field descriptors

Descriptor Function
%% Same as*%*
%a Day of week using locale's abbreviated weekday names
%A Day of week using locale's full weekday names
%b or %h Month using locale's abbreviated month names
%B Month using locale's full month names
%d Day of month (01-31)
%D Date as %m/%d/%y
%e Day of month (1-31; single digits are preceded by a blank)
%H Hour (00-23)
%I Hour (00-12)
%k Hour (0-23; single digits preceded by a blank)--Oracle Solaris operating system only
%m Month number (01-12)
%M Minute (00-59)
%p Locale's equivalent of a.m. or p.m., whichever is appropriate
%r Time as %I:%M:%S %p
%R Time as %H:%M
%S Seconds (00-59)
%T Time as %H:%M:%S
%w Day of week (Sunday is day 0)
%x Date, using locale's date format
%X Time, using locale's time format
%y Year within century (00-99)
%Y Year, including century (for example, 2004)

The format you specify can contain any characters (including the field descriptors in the following table) in any combination that you select. To put a comma in your date, include the comma in the appropriate place in the format.

The following table shows examples of ARDATE, ARDATEONLY, and ARTIMEONLY settings.



ARDATE format


setenv ARDATE "%m/%d/%y"

31 January 2008 16:30:00

setenv ARDATE "%d %B %Y %X"

January 31 2008

setenv ARDATEONLY "%m/%d/%y"


setenv ARTIMEONLY "%X"


The wording of the second example might differ, according to the LANG environment variable or your system's default language.

For Windows servers, use the time and date formats listed in the Regional Options dialog box to set the environmental variables under your System settings.

Sample Windows settings





M/d/yyyy h:mm:ss

Environment-variable: ARDATE=%Y-%m-%d %H:%M:%S



Environment-variable: ARDATEONLY=%d %m %Y


h:mm:ss tt

Environment-variable: ARTIMEONLY=%H

Was this page helpful? Yes No Submitting... Thank you