C＃中的DateTime.ToFileTimeUtc()方法

此方法用于将当前DateTime对象的值转换为Windows文件时间。

Syntax: public long ToFileTimeUtc ();

Return Value: This method returns the value of the current DateTime object expressed as a Windows file time.

Exception: This method will give ArgumentOutOfRangeException if the resulting file time would represent a date and time before 12:00 midnight January 1, 1601 C.E. UTC.

下面的程序说明了DateTime.ToFileTimeUtc()方法的用法：

范例1：

// C# program to demonstrate the
// DateTime.ToFileTimeUtc()
// Method
using System;
using System.Globalization;
  
class GFG {
  
    // Main Method
    public static void Main()
    {
        try {
  
            // creating object of DateTime
            DateTime date = new DateTime(2011, 1,
                                    1, 4, 0, 15);
  
            // converting current DateTime object
            // to a Windows file time.
            // using ToFileTimeUtc() method;
            long value = date.ToFileTimeUtc();
  
            // Display the TimeSpan
            Console.WriteLine("Windows file time(UTC) "+
                                       "is {0}", value);
        }
  
        catch (ArgumentOutOfRangeException e) 
        {
            Console.Write("Exception Thrown: ");
            Console.Write("{0}", e.GetType(), e.Message);
        }
    }
}

输出：

Windows file time(UTC) is 129383280150000000

示例2：对于ArgumentOutOfRangeException

// C# program to demonstrate the
// DateTime.ToFileTimeUtc()
// Method
using System;
using System.Globalization;
  
class GFG {
  
    // Main Method
    public static void Main()
    {
        try {
  
            // creating object of DateTime
            DateTime date = new DateTime(1600, 1,
                                    1, 4, 0, 15);
  
            // converting current DateTime 
            // object to a Windows file time.
            // using ToFileTimeUtc() method;
            long value = date.ToFileTimeUtc();
  
            // Display the TimeSpan
            Console.WriteLine("Windows file time(UTC) is "+
                                             "{0}", value);
        }
  
        catch (ArgumentOutOfRangeException e) 
        {
            Console.Write("Exception Thrown: ");
            Console.Write("{0}", e.GetType(), e.Message);
        }
    }
}

输出：

Exception Thrown: System.ArgumentOutOfRangeException

参考：

• https://docs.microsoft.com/zh-cn/dotnet/api/system.datetime.tofiletimeutc?view=netframework-4.7.2