AlterTimestamp()

Format

AlterTimestamp(InputValues ,TimestampOffsets)

Returns

Returns the input values with their timestamp shifted by the specified offsets. The offset which will be added to the timestamp of each input value. This parameter supports both a single timestamp and a collection of timestamps.

Inputs

InputValues: A collection of values whose timestamp has to be adjusted.
Behaviour: Required
Dimensions: Collection, MultiCollection
Valid data types: Null, Boolean, DateTime, Decimal, Integer, String, Duration, Error

TimestampOffsets: An offset which will be added to the timestamp of each input value. If this parameter contains a collection of offsets, then the first offset will be applied to all input values up to the timestamp of the second offset. Starting from the second item, offsets will be applied only up to the subsequent offset's timestamp.
Behaviour: Required
Dimensions: SingleValue, Collection 
Valid data types: Duration

How to format data types

Examples

Expression: AlterTimestamp({Tag1}, {du'01:00'})
Result: Returns the value of {Tag1} with the timestamp of every fetched value increased by 1 hour.

Expression: AlterTimestamp({Tag1}, {Offsets})
Result: Returns the value of {Tag1} with the timestamp of every fetched value increased by the relevant offsets which are returned by the {Offsets} tag.

Release History

• AlterTimestamp() 4.6.6
  • Changed TimestampOffset parameter to accept a collection of timestamps.
• AlterTimestamp() 4.6.5
  • Changed InputValues parameter to support MultiCollection values.
• AlterTimestamp() 4.5.1
  • Initial version