AbsoluteTime, AbsoluteTimeStrict
Converts time data to absolute time.
Syntax
AbsoluteTime[<Y|X|Z>] Expression
or
AbsoluteTimeStrict[<Y|X|Z>] Expression
The syntax of the AbsoluteTime operator consists of the following elements:
Element |
Description |
|---|---|
Expression |
A data object or expression that provides data with header information. |
Remarks
The conversion to absolute time is done by adding the timestamp of the data object on the General tab of the Properties dialog box for the data component that is to be converted.
The AbsoluteTimeStrict variant of the operator returns an error when compiling the formula if Expression is an FPScript expression that does not supply a data object. When executing the formula, this variant issues an error if the relevant data object component does not have a timestamp. The AbsoluteTime variant ignores both errors and does not change the argument.
The operator can process all data structures and real data types. Lists are processed element by element. If a component is appended to the operator, such as in AbsoluteTime<X>, only the relevant component is processed in aggregate data structures and the data of the other components remain unchanged in the result. If no component is appended, all components are processed. For non-aggregate data structures, AbsoluteTime<Y> is equivalent to AbsoluteTime and AbsoluteTime<X> as well as AbsoluteTime<Z> have no effect.
If the relevant data component is already in absolute time, i.e. it is of the calendar time data type, it will be copied without modification. If the operator is used for a particular component and Expression does not have a timestamp for the component to be converted, an error will be output. If Unit Manager is activated, it will also check whether the data component unit has time as the dimension. If it does not, no conversion will take place and it will be copied to the result unchanged.
Since the operator has to extract the timestamp from the expression, not just any expression is permitted as the argument. Only expressions that represent a data object or have header information assigned are allowed.
Available in
FlexPro View, Basic, Professional, Developer Suite
Examples
AbsoluteTime<X> Signal |
Converts the X component of the signal to absolute time. |
AbsoluteTime Signal |
Converts all components of the signal with a time unit to absolute time. |
AbsoluteTime<X> Signal(Amplitude, Time) |
Generates an error message, since the operator argument does not represent a data object. |