DateTimeOffset.Ticks 屬性

定義

命名空間:

System

組件:

System.Runtime.dll

來源:

DateTimeOffset.cs

取得刻度數，這個值表示目前 DateTimeOffset 物件之時鐘時間的日期和時間。

public:
 property long Ticks { long get(); };

public long Ticks { get; }

member this.Ticks : int64

Public ReadOnly Property Ticks As Long

屬性值

Int64

DateTimeOffset 物件之時間的刻度數。

範例

下列範例會藉由近似 2008 年 7 月 1 日 1：23：07 中的刻度數目，初始化 DateTimeOffset 物件。 然後，它會顯示該日期所代表的日期和刻度數目給主控台。

// Attempt to initialize date to number of ticks
// in July 1, 2008 1:23:07.
//
// There are 10,000,000 100-nanosecond intervals in a second
const long NSPerSecond = 10000000;
long ticks;
ticks = 7 * NSPerSecond;                        // Ticks in a 7 seconds
ticks += 23 * 60 * NSPerSecond;                 // Ticks in 23 minutes
ticks += 1 * 60 * 60 * NSPerSecond;             // Ticks in 1 hour
ticks += 60 * 60 * 24 * NSPerSecond;            // Ticks in 1 day
ticks += 181 * 60 * 60 * 24 * NSPerSecond;      // Ticks in 6 months
ticks += 2007 * 60 * 60 * 24 * 365L * NSPerSecond;   // Ticks in 2007 years
ticks += 486 * 60 * 60 * 24 * NSPerSecond;      // Adjustment for leap years
DateTimeOffset dto = new DateTimeOffset(
                         ticks,
                         DateTimeOffset.Now.Offset);
Console.WriteLine("There are {0:n0} ticks in {1}.",
                  dto.Ticks,
                  dto.ToString());
// The example displays the following output:
//       There are 633,504,721,870,000,000 ticks in 7/1/2008 1:23:07 AM -08:00.

// Attempt to initialize date to number of ticks
// in July 1, 2008 1:23:07.
//
// There are 10,000,000 100-nanosecond intervals in a second
let NSPerSecond = 10000000L
let ticks = 7L * NSPerSecond                                  // Ticks in a 7 seconds
let ticks = ticks + 23L * 60L * NSPerSecond                   // Ticks in 23 minutes
let ticks = ticks + 1L * 60L * 60L * NSPerSecond              // Ticks in 1 hour
let ticks = ticks + 60L * 60L * 24L * NSPerSecond             // Ticks in 1 day
let ticks = ticks + 181L * 60L * 60L * 24L * NSPerSecond      // Ticks in 6 months
let ticks = ticks + 2007L * 60L * 60L * 24L * 365L * NSPerSecond   // Ticks in 2007 years
let ticks = ticks + 486L * 60L * 60L * 24L * NSPerSecond      // Adjustment for leap years
let dto = DateTimeOffset(ticks, DateTimeOffset.Now.Offset)
printfn $"There are {ticks:n0} ticks in {dto}."

// The example displays the following output:
//       There are 633,504,721,870,000,000 ticks in 7/1/2008 1:23:07 AM -08:00.

' Attempt to initialize date to number of ticks
' in July 1, 2008 1:23:07.      
'
' There are 10,000,000 100-nanosecond intervals in a second
Const NSPerSecond As Long = 10000000
Dim ticks As Long
ticks = 7 * NSPerSecond                         ' Ticks in a 7 seconds 
ticks += 23 * 60 * NSPerSecond                  ' Ticks in 23 minutes
ticks += 1 * 60 * 60 * NSPerSecond              ' Ticks in 1 hour
ticks += 60 * 60 * 24 * NSPerSecond             ' Ticks in 1 day
ticks += 181 * 60 * 60 * 24 * NSPerSecond       ' Ticks in 6 months 
ticks += 2007 * 60 * 60 * 24 * 365l * NSPerSecond   ' Ticks in 2007 years 
ticks += 486 * 60 * 60 * 24 * NSPerSecond       ' Adjustment for leap years      
Dim dto As DateTimeOffset = New DateTimeOffset( _
                            ticks, _
                            DateTimeOffset.Now.Offset)
Console.WriteLine("There are {0:n0} ticks in {1}.", _
                  dto.Ticks, _
                  dto.ToString())
' The example displays the following output:
'       There are 633,504,721,870,000,000 ticks in 7/1/2008 1:23:07 AM -08:00.

備註

屬性 Ticks 不會受到 屬性的值 Offset 影響。

屬性的值 Ticks 代表自 0001 年 1 月 1 日午夜 12：00：00 起經過的 100 奈秒間隔數目， () 的值 MinValue 。 不包含以閏秒新增的刻度。 nanosecond 為每秒 10 億個;秒內有十萬個刻度。 Ticks屬性值的範圍從 DateTimeOffset.MinValue.Ticks 到 DateTimeOffset.MaxValue.Ticks 。

您可以使用建構函式多載，將刻度數目指派給 DateTimeOffset 物件 DateTimeOffset(Int64, TimeSpan) 。

另請參閱

• UtcDateTime