簡介
ATFX API 由兩個 DLL 文件組成，可以與自定義軟件集成以直接讀取和提取 ATFX 文件中的數(shù)據。這篇文章將展示一個簡單的 C# 代碼示例，用于提取和創(chuàng)建具有納秒精度的 DateTimeNano 對象。
DateTimeNano 類是來自 Microsoft 的 DateTime 類的子類，具有將 DateTime 的精度擴展到納秒的附加屬性和功能。
有關打開和讀取 ATFX 文件的簡單方法，請參閱ATFX API 在 C# 中讀取 ATFX 文件一文。
有關如何在類中實現(xiàn)以下代碼段和屬性的更多詳細信息，請參閱 ATFX API 手冊和提供的 C# 演示代碼。該軟件包可以從我們的Programming Corner下載。
以納秒為單位提取和創(chuàng)建精確度的時間數(shù)據
要從 ATFX 文件創(chuàng)建 DateTimeNano 對象，需要將 CreateTime記錄屬性和NVHMeasurement類放入構造函數(shù)中用于訪問 NanoSecondElapsed 。
下面的代碼示例顯示了 DateTimeNano 類中的創(chuàng)建過程和幾個新屬性，例如 ms_us_ns，它以 000/000/000 格式顯示毫秒、微秒和納秒。
RecordingManager.Manager.OpenRecording(recordingPath,?out?IRecording rec);
// Create several ATFX API classes to extract specific data to be used in creating the DateTimeNano
ODSNVHATFXMLRecording nvhRec =?rec as?ODSNVHATFXMLRecording;
NVHMeasurement nvhMeasurement = nvhRec.Measurement?as?NVHMeasurement;
NVHEnvironment nvhEnvironment = nvhRec.Environment?as?NVHEnvironment;
// Create a DateTimeNano object with UTC Time Format
createTimeUTC =?new?DateTimeNano(nvhRec.Environment.GetUTCTime(nvhRec.RecordingProperty.CreateTime), nvhMeasurement.NanoSecondElapsed);
// DateTimeNano object properties
string?isNanoTime = string.Format ("IsNanoTime: ", createTimeUTC.IsNanoTime);
string?nanoseconds = string.Format ("NanoSeconds: ", createTimeUTC.ms_us_ns);
string?totalnanosecond = string.Format ("TotalNanosec: ", createTimeUTC.TotalNanoSeconds);
string?nanoString = string.Format ("ToNanoString(): ", createTimeUTC.ToNanoString());
// Math in extracting exact Millisecond, Microsecond and Nanosecond data
int?ms = (int) (createTimeUTC.ms_us_ns / 1e6);
int?us = (int) (createTimeUTC.ms_us_ns / 1e3 % 1e3);
int?ns = (int) (createTimeUTC.ms_us_ns % 1e3);
string?customFormat =?string.Format("Custom Format – yyyy/mm/dd/hh/mm/ss/ms/us/ns: ", createTimeUTC.Year, createTimeUTC.Month, createTimeUTC.Day, createTimeUTC.Hour, createTimeUTC.Minute, createTimeUTC.Second, ms, us, ns);
以下屏幕截圖是以UTC格式顯示的ATFX文件的DateTimeNano的示例：
