添加類 NTPClient

/// <summary>/// SNTPClient is a C# class designed to connect to time servers on the Internet and/// fetch the current date and time. Optionally, it may update the time of the local system./// The implementation of the protocol is based on the RFC 2030./// /// Public class members:/// /// Initialize - Sets up data structure and prepares for connection./// /// Connect - Connects to the time server and populates the data structure./// It can also update the system time./// /// IsResponseValid - Returns true if received data is valid and if comes from/// a NTP-compliant time server./// /// ToString - Returns a string representation of the object./// /// -----------------------------------------------------------------------------/// Structure of the standard NTP header (as described in RFC 2030)/// 1 2 3/// 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1/// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+/// |LI | VN |Mode | Stratum | Poll | Precision |/// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+/// | Root Delay |/// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+/// | Root Dispersion |/// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+/// | Reference Identifier |/// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+/// | |/// | Reference Timestamp (64) |/// | |/// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+/// | |/// | Originate Timestamp (64) |/// | |/// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+/// | |/// | Receive Timestamp (64) |/// | |/// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+/// | |/// | Transmit Timestamp (64) |/// | |/// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+/// | Key Identifier (optional) (32) |/// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+/// | |/// | |/// | Message Digest (optional) (128) |/// | |/// | |/// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+/// /// -----------------------------------------------------------------------------/// /// SNTP Timestamp Format (as described in RFC 2030)/// 1 2 3/// 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1/// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+/// | Seconds |/// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+/// | Seconds Fraction (0-padded) |/// +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+/// /// </summary>public class NTPClient{/// <summary>/// SNTP Data Structure Length/// </summary>private const byte SNTPDataLength = 48;/// <summary>/// SNTP Data Structure (as described in RFC 2030)/// </summary>byte[] SNTPData = new byte[SNTPDataLength];//Offset constants for timestamps in the data structureprivate const byte offReferenceID = 12;private const byte offReferenceTimestamp = 16;private const byte offOriginateTimestamp = 24;private const byte offReceiveTimestamp = 32;private const byte offTransmitTimestamp = 40;/// <summary>/// Leap Indicator Warns of an impending leap second to be inserted/deleted in the last minute of the current day. 值為“11”時表示告警狀態，時鐘未被同步。為其他值時NTP本身不做處理/// </summary>public _LeapIndicator LeapIndicator{get{// Isolate the two most significant bitsbyte val = (byte)(SNTPData[0] >> 6);switch (val){case 0: return _LeapIndicator.NoWarning;case 1: return _LeapIndicator.LastMinute61;case 2: return _LeapIndicator.LastMinute59;case 3: goto default;default:return _LeapIndicator.Alarm;}}}/// <summary>/// Version Number Version number of the protocol (3 or 4) NTP的版本號/// </summary>public byte VersionNumber{get{// Isolate bits 3 - 5byte val = (byte)((SNTPData[0] & 0x38) >> 3);return val;}}/// <summary>/// Mode 長度為3比特，表示NTP的工作模式。不同的值所表示的含義分別是：0未定義、1表示主動對等體模式、2表示被動對等體模式、3表示客戶模式、4表示服務器模式、5表示廣播模式或組播模式、6表示此報文為NTP控制報文、7預留給內部使用/// </summary>public _Mode Mode{get{// Isolate bits 0 - 3byte val = (byte)(SNTPData[0] & 0x7);switch (val){case 0:return _Mode.Unknown;case 6:return _Mode.Unknown;case 7:return _Mode.Unknown;default:return _Mode.Unknown;case 1:return _Mode.SymmetricActive;case 2:return _Mode.SymmetricPassive;case 3:return _Mode.Client;case 4:return _Mode.Server;case 5:return _Mode.Broadcast;}}}/// <summary>/// Stratum 系統時鐘的層數，取值范圍為1～16，它定義了時鐘的準確度。層數為1的時鐘準確度最高，準確度從1到16依次遞減，層數為16的時鐘處于未同步狀態，不能作為參考時鐘/// </summary>public _Stratum Stratum{get{byte val = (byte)SNTPData[1];if (val == 0) return _Stratum.Unspecified;elseif (val == 1) return _Stratum.PrimaryReference;elseif (val <= 15) return _Stratum.SecondaryReference;elsereturn _Stratum.Reserved;}}/// <summary>/// Poll Interval (in seconds) Maximum interval between successive messages 輪詢時間，即兩個連續NTP報文之間的時間間隔/// </summary>public uint PollInterval{get{// Thanks to Jim Hollenhorst <hollenho@attbi.com>return (uint)(Math.Pow(2, (sbyte)SNTPData[2]));}}/// <summary>/// Precision (in seconds) Precision of the clock 系統時鐘的精度/// </summary>public double Precision{get{// Thanks to Jim Hollenhorst <hollenho@attbi.com>return (Math.Pow(2, (sbyte)SNTPData[3]));}}/// <summary>/// Root Delay (in milliseconds) Round trip time to the primary reference source NTP服務器到主參考時鐘的延遲/// </summary>public double RootDelay{get{int temp = 0;temp = 256 * (256 * (256 * SNTPData[4] + SNTPData[5]) + SNTPData[6]) + SNTPData[7];return 1000 * (((double)temp) / 0x10000);}}/// <summary>/// Root Dispersion (in milliseconds) Nominal error relative to the primary reference source 系統時鐘相對于主參考時鐘的最大誤差/// </summary>public double RootDispersion{get{int temp = 0;temp = 256 * (256 * (256 * SNTPData[8] + SNTPData[9]) + SNTPData[10]) + SNTPData[11];return 1000 * (((double)temp) / 0x10000);}}/// <summary>/// Reference Identifier Reference identifier (either a 4 character string or an IP address)/// </summary>public string ReferenceID{get{string val = "";switch (Stratum){case _Stratum.Unspecified:goto case _Stratum.PrimaryReference;case _Stratum.PrimaryReference:val += (char)SNTPData[offReferenceID + 0];val += (char)SNTPData[offReferenceID + 1];val += (char)SNTPData[offReferenceID + 2];val += (char)SNTPData[offReferenceID + 3];break;case _Stratum.SecondaryReference:switch (VersionNumber){case 3: // Version 3, Reference ID is an IPv4 addressstring Address = SNTPData[offReferenceID + 0].ToString() + "." +SNTPData[offReferenceID + 1].ToString() + "." +SNTPData[offReferenceID + 2].ToString() + "." +SNTPData[offReferenceID + 3].ToString();try{IPHostEntry Host = Dns.GetHostEntry(Address);val = Host.HostName + " (" + Address + ")";}catch (Exception){val = "N/A";}break;case 4: // Version 4, Reference ID is the timestamp of last updateDateTime time = ComputeDate(GetMilliSeconds(offReferenceID));// Take care of the time zoneTimeSpan offspan = TimeZone.CurrentTimeZone.GetUtcOffset(DateTime.Now);val = (time + offspan).ToString();break;default:val = "N/A";break;}break;}return val;}}/// <summary>/// Reference Timestamp The time at which the clock was last set or corrected NTP系統時鐘最后一次被設定或更新的時間/// </summary>public DateTime ReferenceTimestamp{get{DateTime time = ComputeDate(GetMilliSeconds(offReferenceTimestamp));// Take care of the time zoneTimeSpan offspan = TimeZone.CurrentTimeZone.GetUtcOffset(DateTime.Now);return time + offspan;}}/// <summary>/// Originate Timestamp (T1) The time at which the request departed the client for the server. 發送報文時的本機時間/// </summary>public DateTime OriginateTimestamp{get{return ComputeDate(GetMilliSeconds(offOriginateTimestamp));}}/// <summary>/// Receive Timestamp (T2) The time at which the request arrived at the server. 報文到達NTP服務器時的服務器時間/// </summary>public DateTime ReceiveTimestamp{get{DateTime time = ComputeDate(GetMilliSeconds(offReceiveTimestamp));// Take care of the time zoneTimeSpan offspan = TimeZone.CurrentTimeZone.GetUtcOffset(DateTime.Now);return time + offspan;}}/// <summary>/// Transmit Timestamp (T3) The time at which the reply departed the server for client. 報文從NTP服務器離開時的服務器時間/// </summary>public DateTime TransmitTimestamp{get{DateTime time = ComputeDate(GetMilliSeconds(offTransmitTimestamp));// Take care of the time zoneTimeSpan offspan = TimeZone.CurrentTimeZone.GetUtcOffset(DateTime.Now);return time + offspan;}set{SetDate(offTransmitTimestamp, value);}}/// <summary>/// Destination Timestamp (T4) The time at which the reply arrived at the client. 接收到來自NTP服務器返回報文時的本機時間/// </summary>public DateTime DestinationTimestamp;/// <summary>/// Round trip delay (in milliseconds) The time between the departure of request and arrival of reply 報文從本地到NTP服務器的往返時間/// </summary>public double RoundTripDelay{get{// Thanks to DNH <dnharris@csrlink.net>TimeSpan span = (DestinationTimestamp - OriginateTimestamp) - (ReceiveTimestamp - TransmitTimestamp);return span.TotalMilliseconds;}}/// <summary>/// Local clock offset (in milliseconds) The offset of the local clock relative to the primary reference source.本機相對于NTP服務器（主時鐘）的時間差/// </summary>public double LocalClockOffset{get{// Thanks to DNH <dnharris@csrlink.net>TimeSpan span = (ReceiveTimestamp - OriginateTimestamp) + (TransmitTimestamp - DestinationTimestamp);return span.TotalMilliseconds / 2;}}/// <summary>/// Compute date, given the number of milliseconds since January 1, 1900/// </summary>/// <param name="milliseconds"></param>/// <returns></returns>private DateTime ComputeDate(ulong milliseconds){TimeSpan span = TimeSpan.FromMilliseconds((double)milliseconds);DateTime time = new DateTime(1900, 1, 1);time += span;return time;}/// <summary>/// Compute the number of milliseconds, given the offset of a 8-byte array/// </summary>/// <param name="offset"></param>/// <returns></returns>private ulong GetMilliSeconds(byte offset){ulong intpart = 0, fractpart = 0;for (int i = 0; i <= 3; i++){intpart = 256 * intpart + SNTPData[offset + i];}for (int i = 4; i <= 7; i++){fractpart = 256 * fractpart + SNTPData[offset + i];}ulong milliseconds = intpart * 1000 + (fractpart * 1000) / 0x100000000L;return milliseconds;}/// <summary>/// Compute the 8-byte array, given the date/// </summary>/// <param name="offset"></param>/// <param name="date"></param>private void SetDate(byte offset, DateTime date){ulong intpart = 0, fractpart = 0;DateTime StartOfCentury = new DateTime(1900, 1, 1, 0, 0, 0); // January 1, 1900 12:00 AMulong milliseconds = (ulong)(date - StartOfCentury).TotalMilliseconds;intpart = milliseconds / 1000;fractpart = ((milliseconds % 1000) * 0x100000000L) / 1000;ulong temp = intpart;for (int i = 3; i >= 0; i--){SNTPData[offset + i] = (byte)(temp % 256);temp = temp / 256;}temp = fractpart;for (int i = 7; i >= 4; i--){SNTPData[offset + i] = (byte)(temp % 256);temp = temp / 256;}}/// <summary>/// Initialize the NTPClient data/// </summary>private void Initialize(){// Set version number to 4 and Mode to 3 (client)SNTPData[0] = 0x1B;// Initialize all other fields with 0for (int i = 1; i < 48; i++){SNTPData[i] = 0;}// Initialize the transmit timestampTransmitTimestamp = DateTime.Now;}/// <summary>/// The IPAddress of the time server we're connecting to/// </summary>private IPAddress serverAddress = null;/// <summary>/// Constractor with HostName/// </summary>/// <param name="host"></param>public NTPClient(string host){//string host = "ntp1.aliyun.com";//string host = "0.asia.pool.ntp.org";//string host = "1.asia.pool.ntp.org";//string host = "www.ntp.org/";// Resolve server addressIPHostEntry hostadd = Dns.GetHostEntry(host);foreach (IPAddress address in hostadd.AddressList){if (address.AddressFamily == AddressFamily.InterNetwork) //只支持IPV4協議的IP地址 {serverAddress = address;break;}}if (serverAddress == null)throw new Exception("Can't get any ipaddress infomation");}/// <summary>/// Constractor with IPAddress/// </summary>/// <param name="address"></param>public NTPClient(IPAddress address){if (address == null)throw new Exception("Can't get any ipaddress infomation");serverAddress = address;}/// <summary>/// Connect to the time server and update system time/// </summary>/// <param name="updateSystemTime"></param>public void Connect(bool updateSystemTime, int timeout = 3000){IPEndPoint EPhost = new IPEndPoint(serverAddress, 123);//Connect the time serverusing (UdpClient TimeSocket = new UdpClient()){TimeSocket.Connect(EPhost);// Initialize data structure Initialize();TimeSocket.Send(SNTPData, SNTPData.Length);TimeSocket.Client.ReceiveTimeout = timeout;SNTPData = TimeSocket.Receive(ref EPhost);if (!IsResponseValid)throw new Exception("Invalid response from " + serverAddress.ToString());}DestinationTimestamp = DateTime.Now;if (updateSystemTime)SetTime();}/// <summary>/// Check if the response from server is valid/// </summary>/// <returns></returns>public bool IsResponseValid{get{return !(SNTPData.Length < SNTPDataLength || Mode != _Mode.Server);}}/// <summary>/// Converts the object to string/// </summary>/// <returns></returns>public override string ToString(){StringBuilder sb = new StringBuilder(512);sb.Append("Leap Indicator: ");switch (LeapIndicator){case _LeapIndicator.NoWarning:sb.Append("No warning");break;case _LeapIndicator.LastMinute61:sb.Append("Last minute has 61 seconds");break;case _LeapIndicator.LastMinute59:sb.Append("Last minute has 59 seconds");break;case _LeapIndicator.Alarm:sb.Append("Alarm Condition (clock not synchronized)");break;}sb.AppendFormat("\r\nVersion number: {0}\r\n", VersionNumber);sb.Append("Mode: ");switch (Mode){case _Mode.Unknown:sb.Append("Unknown");break;case _Mode.SymmetricActive:sb.Append("Symmetric Active");break;case _Mode.SymmetricPassive:sb.Append("Symmetric Pasive");break;case _Mode.Client:sb.Append("Client");break;case _Mode.Server:sb.Append("Server");break;case _Mode.Broadcast:sb.Append("Broadcast");break;}sb.Append("\r\nStratum: ");switch (Stratum){case _Stratum.Unspecified:case _Stratum.Reserved:sb.Append("Unspecified");break;case _Stratum.PrimaryReference:sb.Append("Primary Reference");break;case _Stratum.SecondaryReference:sb.Append("Secondary Reference");break;}sb.AppendFormat("\r\nLocal Time T3: {0:yyyy-MM-dd HH:mm:ss:fff}", TransmitTimestamp);sb.AppendFormat("\r\nDestination Time T4: {0:yyyy-MM-dd HH:mm:ss:fff}", DestinationTimestamp);sb.AppendFormat("\r\nPrecision: {0} s", Precision);sb.AppendFormat("\r\nPoll Interval:{0} s", PollInterval);sb.AppendFormat("\r\nReference ID: {0}", ReferenceID.ToString().Replace("\0", string.Empty));sb.AppendFormat("\r\nRoot Delay: {0} ms", RootDelay);sb.AppendFormat("\r\nRoot Dispersion: {0} ms", RootDispersion);sb.AppendFormat("\r\nRound Trip Delay: {0} ms", RoundTripDelay);sb.AppendFormat("\r\nLocal Clock Offset: {0} ms", LocalClockOffset);sb.AppendFormat("\r\nReferenceTimestamp: {0:yyyy-MM-dd HH:mm:ss:fff}", ReferenceTimestamp);sb.Append("\r\n");return sb.ToString();}/// <summary>/// SYSTEMTIME structure used by SetSystemTime/// </summary> [StructLayoutAttribute(LayoutKind.Sequential)]private struct SYSTEMTIME{public short year;public short month;public short dayOfWeek;public short day;public short hour;public short minute;public short second;public short milliseconds;}[DllImport("kernel32.dll")]static extern bool SetLocalTime(ref SYSTEMTIME time);/// <summary>/// Set system time according to transmit timestamp 把本地時間設置為獲取到的時鐘時間/// </summary>public void SetTime(){SYSTEMTIME st;DateTime trts = DateTime.Now.AddMilliseconds(LocalClockOffset);st.year = (short)trts.Year;st.month = (short)trts.Month;st.dayOfWeek = (short)trts.DayOfWeek;st.day = (short)trts.Day;st.hour = (short)trts.Hour;st.minute = (short)trts.Minute;st.second = (short)trts.Second;st.milliseconds = (short)trts.Millisecond;SetLocalTime(ref st);}}/// <summary>/// Leap indicator field values/// </summary>public enum _LeapIndicator{NoWarning, // 0 - No warningLastMinute61, // 1 - Last minute has 61 secondsLastMinute59, // 2 - Last minute has 59 secondsAlarm // 3 - Alarm condition (clock not synchronized) }/// <summary>/// Mode field values/// </summary>public enum _Mode{SymmetricActive, // 1 - Symmetric activeSymmetricPassive, // 2 - Symmetric pasiveClient, // 3 - ClientServer, // 4 - ServerBroadcast, // 5 - BroadcastUnknown // 0, 6, 7 - Reserved }/// <summary>/// Stratum field values/// </summary>public enum _Stratum{Unspecified, // 0 - unspecified or unavailablePrimaryReference, // 1 - primary reference (e.g. radio-clock)SecondaryReference, // 2-15 - secondary reference (via NTP or SNTP)Reserved // 16-255 - reserved}

?

?

?

使用時：

//IPAddress ntpserver = IPAddress.Parse("192.39.109.140"); //NTP Serverstring ntpserver = "ntp1.aliyun.com";NTPClient client = new NTPClient(ntpserver);client.Connect(true); //參數為false時只從服務器獲取信息，為true時同時自動更新本機時間

?

轉載于:https://www.cnblogs.com/xyz0835/p/9322472.html

總結

以上是生活随笔為你收集整理的C# NTP时间同步类的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。