Specifying the end time for Process History View

Parameter: /endtime

For Charts and E+Charts, the default time range is 8 hours, ending at the current time. If creating a new Chart or E+Chart with the /new qualifier, use the endtime parameter to select a specific end time other than current time ('*'). If opening an existing file, you can use this parameter to change the configured value in the file. If using the Process History View application, this is the same as clicking Chart → Configure Chart, clicking the Time Scale tab, and entering the value in the Time End field.

You can use the endtime parameter with the other time specification parameters, span or starttime. The endtime parameter can be either of the two following types:

Same format as defined in the Date and Time tabs of the Regional and Language Options dialog (available in the Control Panel).
A valid Continuous Historian time format:
- Absolute: DD-MMM-YY hh:mm:ss
- Relative: +- D, h, m, s
- Valid code: SUNDAY, TODAY, JULY,
- Current time: *
- Combination of * or a Valid code with a relative offset: YESTERDAY+8h

Note

The keyword today means today's date at 00:00, and the keyword yesterday means yesterday's date at 00:00. Other keywords are the days of the week (Monday, Tuesday, Wednesday) and months of the year (January, February, March). You can also use a format such as Tuesday+14h to mean 2 PM of the most recent Tuesday. Since the time string can contain forward slashes (12/05/97 08:00:00 PM), enclose the string in double quotes or parentheses.

If endtime is an asterisk (current time), the chart shifted left 20% of the time window when it initially opens. If you want the chart to start with a relatively full screen and still update in real time, configure the start time and the time span so that the current time is in the window near the right portion of the screen. For example, if you want a time window of 8 hours, set span to 7:59 and set Starttime to *-8h. Data updates for 1 minute before the time scale is shifted to keep the current time visible. Using the values 8:00 for span and * for endtime displays the most recent 6 hours and 24 minutes (80% of 8 hours), and updates for 1 hour and 36 minutes before shifting the time scale.

In the following examples (one showing the starttime and endtime parameters and the other showing the starttime and span parameters), the Process History View application opens an existing file (Motors.phvc) with a time range that starts yesterday at 00:00 and ends today at 00:00:

Type: Time specification

Applies to: Chart and E+Chart

Format: As specified in the Regional and Language Options dialog (available in the Control Panel), or a valid Continuous Historian time.

Examples:

CHS /new chart /starttime 10:00 /endtime 14:00

CHS /new E+Chart /starttime Monday /endtime TODAY

CHS Motors.phvc /starttime YESTERDAY /endtime TODAY

CHS Motors.phvc /starttime YESTERDAY /span 24:00