DateTimeOffset.ToUnixTimeSeconds 方法

定義

傳回自 1970-01-01T00:00:00Z 以來所經過的秒數。Returns the number of seconds that have elapsed since 1970-01-01T00:00:00Z.

public:
 long ToUnixTimeSeconds();
public long ToUnixTimeSeconds ();
member this.ToUnixTimeSeconds : unit -> int64
Public Function ToUnixTimeSeconds () As Long

傳回

Int64

自 1970-01-01T00:00:00Z 以來所經過的秒數。The number of seconds that have elapsed since 1970-01-01T00:00:00Z.

範例

下列範例 ToUnixTimeSeconds 會呼叫方法,以傳回值等於、早于或晚于 1970-01-01T00:00:00Z 的 Unix 時間。The following example calls the ToUnixTimeSeconds method to return the Unix time of values that are equal to, shortly before, and shortly after 1970-01-01T00:00:00Z.

using System;

public class Example
{
   public static void Main()
   {
      DateTimeOffset dto = new DateTimeOffset(1970, 1, 1, 0, 0, 0, TimeSpan.Zero);
      Console.WriteLine("{0} --> Unix Seconds: {1}", dto, dto.ToUnixTimeSeconds());

      dto = new DateTimeOffset(1969, 12, 31, 23, 59, 0, TimeSpan.Zero);
      Console.WriteLine("{0} --> Unix Seconds: {1}", dto, dto.ToUnixTimeSeconds());

      dto = new DateTimeOffset(1970, 1, 1, 0, 1, 0, TimeSpan.Zero);
      Console.WriteLine("{0} --> Unix Seconds: {1}", dto, dto.ToUnixTimeSeconds());
   }
}
// The example displays the following output:
//    1/1/1970 12:00:00 AM +00:00 --> Unix Seconds: 0
//    12/31/1969 11:59:00 PM +00:00 --> Unix Seconds: -60
//    1/1/1970 12:01:00 AM +00:00 --> Unix Seconds: 60
Module Example
   Public Sub Main()
      Dim dto As DateTimeOffset = New DateTimeOffset(1970, 1, 1, 0, 0, 0, TimeSpan.Zero)
      Console.WriteLine("{0} --> Unix Seconds: {1}", dto, dto.ToUnixTimeSeconds())

      dto = New DateTimeOffset(1969, 12, 31, 23, 59, 0, TimeSpan.Zero)
      Console.WriteLine("{0} --> Unix Seconds: {1}", dto, dto.ToUnixTimeSeconds())

      dto = New DateTimeOffset(1970, 1, 1, 0, 1, 0, TimeSpan.Zero)
      Console.WriteLine("{0} --> Unix Seconds: {1}", dto, dto.ToUnixTimeSeconds())
   End Sub
End Module
' The example displays the following output:
'       1/1/1970 12:00:00 AM +00:00 --> Unix Seconds: 0
'       12/31/1969 11:59:00 PM +00:00 --> Unix Seconds: -60
'       1/1/1970 12:01:00 AM +00:00 --> Unix Seconds: 60

備註

Unix 時間代表自 1970-01-01T00:00: 00Z (1970 年1月1日上午12:00 點 UTC) 所經過的秒數。Unix time represents the number of seconds that have elapsed since 1970-01-01T00:00:00Z (January 1, 1970, at 12:00 AM UTC). 這並不需要閏秒的帳戶。It does not take leap seconds into account.

這個方法會先將目前的實例轉換為 UTC,再傳回其 Unix 時間。This method first converts the current instance to UTC before returning its Unix time. 若為 1970-01-01T00:00:00Z 之前的日期和時間值,這個方法會傳回負數值。For date and time values before 1970-01-01T00:00:00Z, this method returns a negative value.

適用於

另請參閱