TSTool / Command / SetOutputYearType
SetOutputYearType command sets the global output year type for output reports and files.
The default for most operations is calendar year (January through December);
however, alternate year definitions may be useful.
The global output year type is recognized by some common tools and commands that create output.
Many write commands also allow the year type to be specified for the command.
Internally, all data are managed using calendar years and are converted to different year types during output or display.
ChangeInterval command also allows
time series to be converted to annual values where the value corresponds to a year type.
The year type for output and analysis theoretically can be defined in many ways.
Internally, TSTool allows the start and end year to have offsets from the calendar year.
This allows the output year type to have a starting year previous to the calendar year or the same as the calendar year.
A convention that is being implemented over time is to prepend
Year to the year types where
the start of the output year agrees with the calendar year number,
Year to the year types where the end of the output year agrees with the calendar year number.
YearMayToApr would indicate that the output year is May of the calendar year to Apr of the next calendar year.
The following dialog is used to edit this command and illustrates the syntax of the command.
Note that the output period should always use calendar month and year,
even if other than calendar year are used for output (see
SetOutputYearType Command Editor (see also the full-size image)
The command syntax is as follows:
||The output year type, one of:
In the future, more generic types like NovToOct may be implemented.
|If this command is not specified, Calendar is the default.|
See the automated tests.
A sample command file example is as follows: