Skip to main content
Open topic with navigation CAPL Functions » General » Function Overview » addTimeToMeasurementStartTime

​
addTimeToMeasurementStartTime

Valid for: CANoe DE • CANoe:lite DE • CANoe4SW DE • CANoe4SW:lite DE

​
Function Syntax

long addTimeMeasurementStartTime(int64 timeSpan, long time[]);

​
Description

Calculates the absolute date/time of the measurement start plus an offset (e.g. a timestamp). Note: In offline mode, the function returns the oldest start time of those stored in the logging files.

​
Parameters

  • timeSpan: Time to be added to the measurement start time, e.g. a timestamp of a measured frame.
  • time: An array of type long with at least 8 entries. The entries of the array will be filled with the following information:
    • 0: Milliseconds (0 - 999)
    • 1: Seconds (0 - 59)
    • 2: Minutes (0 - 59)
    • 3: Hours (0 - 23)
    • 4: Day of month (1 - 31)
    • 5: Month (0 - 11)
    • 6: Year (0 - xxx, offset of 1900, e.g. 117 = 2017)
    • 7: Day of week (0 - 6, Sunday is 0)

​
Return Values

1 if successful, 0 if not (e.g. array too small).

​
Example

on errorframe
{
  long time[8];
  addTimeToMeasurementStartTime(timeNowNS(), time);
  write("ErrorFrame occured on %02d/%02d/%02d %02d:%02d:%02d.%-3d",
  time[5]+1, time[4], time[6]-100, time[3], time[2], time[1], time[0]);
  getMeasurementStartTime(time);
  write("Measurement was started on %02d/%02d/%02d %02d:%02d:%02d.%-3d",
  time[5]+1, time[4], time[6]-100, time[3], time[2], time[1], time[0]);
}

// Output e.g.:
// ErrorFrame occured on 08/15/17 14:39:46.787
// Measurement was started on 08/15/17 14:39:29.547
getMeasurementStartTime