DateTime.Ticks Свойство

Определение

Возвращает число тактов, которое представляет дату и время этого экземпляра.Gets the number of ticks that represent the date and time of this instance.

public:
 property long Ticks { long get(); };
public long Ticks { get; }
member this.Ticks : int64
Public ReadOnly Property Ticks As Long

Значение свойства

Int64

Число тактов, которое представляет дату и время этого экземпляра.The number of ticks that represent the date and time of this instance. Это значение находится в диапазоне от DateTime.MinValue.Ticks до DateTime.MaxValue.Ticks.The value is between DateTime.MinValue.Ticks and DateTime.MaxValue.Ticks.

Примеры

В следующем примере свойство используется Ticks для вывода количества тактов, прошедших с начала двадцать первого века, и для создания экземпляра TimeSpan объекта.The following example uses the Ticks property to display the number of ticks that have elapsed since the beginning of the twenty-first century and to instantiate a TimeSpan object. TimeSpanЗатем объект используется для показа затраченного времени с помощью нескольких других временных интервалов.The TimeSpan object is then used to display the elapsed time using several other time intervals.

DateTime centuryBegin = new DateTime(2001, 1, 1);
DateTime currentDate = DateTime.Now;

long elapsedTicks = currentDate.Ticks - centuryBegin.Ticks;
TimeSpan elapsedSpan = new TimeSpan(elapsedTicks);

Console.WriteLine("Elapsed from the beginning of the century to {0:f}:",
                   currentDate);
Console.WriteLine("   {0:N0} nanoseconds", elapsedTicks * 100);
Console.WriteLine("   {0:N0} ticks", elapsedTicks);
Console.WriteLine("   {0:N2} seconds", elapsedSpan.TotalSeconds);
Console.WriteLine("   {0:N2} minutes", elapsedSpan.TotalMinutes);
Console.WriteLine("   {0:N0} days, {1} hours, {2} minutes, {3} seconds",
                  elapsedSpan.Days, elapsedSpan.Hours,
                  elapsedSpan.Minutes, elapsedSpan.Seconds);

// This example displays an output similar to the following:
//
// Elapsed from the beginning of the century to Thursday, 14 November 2019 18:21:
//    595,448,498,171,000,000 nanoseconds
//    5,954,484,981,710,000 ticks
//    595,448,498.17 seconds
//    9,924,141.64 minutes
//    6,891 days, 18 hours, 21 minutes, 38 seconds
Dim centuryBegin As Date = #1/1/2001 0:0:0#
Dim currentDate As Date = Date.Now
Dim elapsedTicks As Long = currentDate.Ticks - centuryBegin.Ticks
Dim elapsedSpan As New TimeSpan(elapsedTicks)

Console.WriteLine("Elapsed from the beginning of the century to {0:f}:", _
                   currentDate)
Console.WriteLine("   {0:N0} nanoseconds", elapsedTicks * 100)
Console.WriteLine("   {0:N0} ticks", elapsedTicks)
Console.WriteLine("   {0:N2} seconds", elapsedSpan.TotalSeconds)
Console.WriteLine("   {0:N2} minutes", elapsedSpan.TotalMinutes)
Console.WriteLine("   {0:N0} days, {1} hours, {2} minutes, {3} seconds", _
                  elapsedSpan.Days, elapsedSpan.Hours, _
                  elapsedSpan.Minutes, elapsedSpan.Seconds)
' If run on December 14, 2007, at 15:23, this example displays the
' following output to the console:
'          219,338,580,000,000,000 nanoseconds
'          2,193,385,800,000,000 ticks
'          219,338,580.00 seconds
'          3,655,643.00 minutes
'          2,538 days, 15 hours, 23 minutes, 0 seconds

Комментарии

Один такт представляет 100 наносекунд или 1 10-миллион секунды.A single tick represents one hundred nanoseconds or one ten-millionth of a second. 10 000 тактов в миллисекундах (см TicksPerMillisecond .) и 10 000 000 тактов в секунду.There are 10,000 ticks in a millisecond (see TicksPerMillisecond) and 10 million ticks in a second.

Значение этого свойства представляет число 100-наносекундных интервалов, прошедших с 12:00:00 полуночи 1 января 0001 г. в григорианском календаре, который представляет MinValue .The value of this property represents the number of 100-nanosecond intervals that have elapsed since 12:00:00 midnight, January 1, 0001 in the Gregorian calendar, which represents MinValue. Он не включает число тактов, которые могут быть соотнесены с високосными секундами.It does not include the number of ticks that are attributable to leap seconds. Если для объекта DateTime свойство имеет Kind значение Local , его такты представляют время, прошедшее с 12:00:00 полуночи 1 января 0001 г. в местное время, как указано текущим параметром часового пояса.If the DateTime object has its Kind property set to Local, its ticks represent the time elapsed time since 12:00:00 midnight, January 1, 0001 in the local time as specified by the current time zone setting. Если DateTime свойство объекта имеет Kind значение Utc , его такты представляют время, прошедшее с 12:00:00 полуночи 1 января 0001 г. в время в формате UTC.If the DateTime object has its Kind property set to Utc, its ticks represent the time elapsed time since 12:00:00 midnight, January 1, 0001 in the Coordinated Universal Time. Если DateTime свойство объекта имеет Kind значение Unspecified , его такты представляют время, прошедшее с 12:00:00 полуночи 1 января 0001 года в неизвестном часовом поясе.If the DateTime object has its Kind property set to Unspecified, its ticks represent the time elapsed time since 12:00:00 midnight, January 1, 0001 in the unknown time zone.

Как правило, такты представляют время в соответствии с часовым поясом, заданным Kind свойством.In general, the ticks represent the time according to the time zone specified by the Kind property.

Применяется к