[TOC] [Prev] [Next]


Customizing the Daylight Savings Time Calendar

The AR System reads the DST.txt file to determine whether (and when) to apply daylight savings time adjustments to the AR timestamp information shown in reports and query displays. The DST.txt file is installed in the arHome folder within the ar folder where you installed the client software. The installed version of this file specifies the standard daylight savings time calendar for the years 1967 through 2010.

If you live in a region that has never used daylight savings time (or that uses a nonstandard daylight savings time convention), you must modify the DST.txt file to reflect the conventions used in your region.

Syntax

The first entry in the DST.txt file consists of the text DST. This entry allows you to easily identify the DST.txt file when you are viewing it using a text editor.

Each of the remaining entries in the DST.txt file specifies the starting date and ending date of daylight savings time in a particular year. The format of each year's entry is as follows:

<year> <start-month> <start-day> <end-month> <end-day>

where the five variables are defined as follows:

<year> The year (1967 through 2010) for which this entry specifies the daylight savings time starting and ending dates.
<start-month> The month number (1 through 12) in which daylight savings time begins (for the year specified by this entry).
<start-day> The day of the month (1 through 31, for month number <start-month>) in which daylight savings time begins (for the year specified by this entry).
<end-month> The month number (1 through 12) in which daylight savings time ends (for the year specified by this entry).
<end-day> The day of the month (1 through 31, for month number <end-month>) in which daylight savings time ends (for the year specified by this entry).

Default Entries

The DST.txt file is installed with default entries that specify the standard daylight savings time starting and ending dates in every year from 1967 through 2010.

Figure 7-7 illustrates the format for the DST.txt file.

The Default DST.txt File


[TOC] [Prev] [Next]