Share via

Time and Timestamp Formats

  • Article

Displays time and timespan formats on the command line.

xperf -help format

Remarks

Various Xperf actions support options that take time and timespan parameters.

Time parameters are usually taken by -range options. Time can be read in one of the formats described in the following table.

1234[s|ms|us|ns]

1234 [seconds|milliseconds|microseconds|nanoseconds] since start of the trace file.

The default unit is microseconds.

2004/12/04:20:05:20.1234[+UTC] physical clock time.

All date and time components are mandatory except for the time zone. If no time zone is specified, time is assumed to be in the local time zone. (This is also the time format used by -a tracestats.)

Note   Only local time zone and UTC are currently supported.

Timespan parameters are usually taken by options accepting resolutions. Timespans can be read in one of the formats described in the following table.

1234[s|ms|us|ns]

1234 [seconds|milliseconds|microseconds|nanoseconds]

20:05:20.1234

20 hours 5 minutes 20 seconds 123.4 milliseconds. All time components are mandatory.

Note   Event timestamps in the Xperf trace dump are always presented in milliseconds.

Xperf Command-Line Reference