Section 6
:
Buffer: Data Storage and Retrieval
Series 3700 System Switch/Multimeter Reference Manual
6-8
Document Number: 3700S-901-01 Rev. A / August 2007
Recall attribute
Description
relativetimestamps
An array (Lua table) of timestamps, in seconds, of when each reading
occurred relative to the timestamp of reading buffer entry number 1.
These are equal to the time lapsed specific for each reading since the
first reading was stored in the buffer. Therefore, getting the relative
timestamp for entry number 1 in the buffer will equal 0.
statuses
An array (a Lua table) of status values for all of the readings in the
buffer. The status values are floating-point numbers that encode the
status value into a floating-point value (see Table 7-6).
times
An array (a Lua table) of times, indicating the time of the reading
formatted in hour, minute and second.
timestamp
An array (a Lua table) of timestamps, indicating the timestamp of the
reading formatted in month, day, year, hour, minute, second, and
fractional second.
fractional
An array (a Lua table) of the fractional portion of the timestamps, in
seconds, of when each reading occurred. These are absolute fractional
times.
seconds
An array (a Lua table) of the seconds portion of the timestamp of when
the reading at
rb[1]
was stored, in seconds. These seconds are
absolute and in UTC format.
units
An array (Lua table) of the unit of measure stored with readings in the
buffer. Units may be designated as one of the following: ‗Volts AC‘,
‗Volts DC‘, ‗Amps AC‘, ‗Amps DC‘, ‗dB VAC‘, ‗dB VDC‘, ‗Ohms 2wire‘,
‗Ohms 4wire‘, ‗Ohms ComSide‘, ‗Fahrenheit‘, ‗Kelvin‘, ‗Celsius‘, ‗Hertz‘,
‗Seconds‘ and ‗Continuity‘.
Example to access recall attributes
To see seconds, nanoseconds, and relativetimestamps for entry number 2 and 3 in buffer
"mybuffer:"
mybuffer2.collecttimestamps = 1
printbuffer(2,3, mybuffer2.seconds)
printbuffer(2,3, mybuffer2.nanoseconds)
printbuffer(2,3, mybuffer2.relativetimestamps)
Time and date values
Time and date values are represented as a number of seconds UTC 12:00 a.m. Jan. 1, 1970.
The
os.time()
returns values in this format. Use
os.date()
to return values in month, day,
year, hour, minute format, or to access the timestamp table.