DATETIMEFORMAT Parameter

The DATETIMEFORMAT parameter is used to specify the date and time formats when date/time strings are passed to parameters in the URL. If DATETIMEFORMAT is not used, the default format as specified in the Default Regional Settings or User Preferences is used. Additionally, this parameter can be used if you want to specify a time zone other than the time zone that the display is set for.

For more information on using date time strings in URLs, see Date Time Strings in URL Parameters.

NOTE: If you are using date time strings in a URL and do not use the DATETIMEFORMAT parameter, make sure to use the same date/time formats as are used by the display (specified in Default Regional Settings). If the date/time formats are not the same, you will see the error indicator in the upper left on your display. Additionally, the symbols that are used for the date/time parameters will fail to be resolved, unless the display is configured to load default symbols that resolve the parameters. If there are unresolved symbols, they are also reported as errors on the error page (error indicator).

This parameter is valid only as long as the integrated environment starts in Client Display mode.

NOTE: The DATETIMEFORMAT parameter is case sensitive.

Possible Values

Format Symbol

Format Symbol Description

Example Values

S

millisecond

650

s

second in minute

52

m

minute in hour

40

H

hour in day (0-23)

22

k

hour in day (1-24)

24

K

hour in AM/PM (0-11)

0

h

hour in AM/PM (1-12)

10

a

AM/PM marker

AM

D

day in year

246

d

day in month

20

F

day of week in month

2

E

day in week

Friday, Fri

w

week in year

23

W

week in month

3

M

month in year

June, Jun, 06

y

year

1970, 2001, 05

G

era

BC, AD

z

time zone (general)

Hours: 0 - 23
Minutes: 00 - 59

Mountain Standard Time, MST, GMT-07:00

Z

time zone (RFC 822 4-digit time zone)

-0700, +0300

The DATETIMEFORMAT parameter will consist of:

The following examples show how the DATETIMEFORMAT parameter can be used in URLs.

Example 1

To load the TimeChart display with a specific date/time format, that will pass a specific start and end time to a chart's start and end time parameters:

http://localhost/ProficyPortal/Default.asp?DISPLAY="Users\jsmith\displays\TimeChart"
&DATETIMEFORMAT="MM-dd-yyyy HH:mm:ss"&ChartStartTime=<!12-06-2004 14:04:00!>
&ChartEndTime=<!12-06-2004 14:10:00!>

Example 2

To load the TimeChart display with a specific date/time format, that will pass a specific start and end time to a chart's start and end time parameters, along with the time zone:

http://localhost/ProficyPortal/Default.asp?DISPLAY="Users\jsmith\displays\TimeChart"
&DATETIMEFORMAT="MM-dd-yyyy HH:mm:ss z"&ChartStartTime=<!12-06-2004 14:04:00 PST!>
&ChartEndTime=<!12-06-2004 14:10:00 PST!>

See Also

Time Management