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.

Примеры

В следующем примере объект инициализируется DateTimeOffset путем приближения числа тактов в дате 1 июля 2008 г. 1:23:07. Затем в консоли отображается дата и количество тактов, представленных этой датой.

// 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 свойства представляет количество 100-наносекундных интервалов, прошедших с 12:00:00 полуночи 1 января 0001 года (значение MinValue). Он не включает такты, которые будут добавлены в високосные секунды. Наносекунда составляет одну миллиардную секунду; есть десять миллионов тактов в секунду. Значение свойства находится в диапазоне Ticks от DateTimeOffset.MinValue.Ticks до DateTimeOffset.MaxValue.Ticks.

Количество тактов можно назначить объекту DateTimeOffset с помощью перегрузки конструктора DateTimeOffset(Int64, TimeSpan) .

См. также раздел

• UtcDateTime