DateTime.Ticks Właściwość

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Źródło:

DateTime.cs

Pobiera liczbę kleszczy reprezentujących datę i godzinę tego wystąpienia.

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

public long Ticks { get; }

member this.Ticks : int64

Public ReadOnly Property Ticks As Long

Wartość właściwości

Int64

Liczba znaczników reprezentujących datę i godzinę tego wystąpienia. Wartość to między DateTime.MinValue.Ticks i DateTime.MaxValue.Ticks.

Przykłady

W poniższym przykładzie użyto Ticks właściwości , aby wyświetlić liczbę kleszczy, które upłynęły od początku xxi wieku i utworzyć wystąpienie TimeSpan obiektu. Obiekt TimeSpan jest następnie używany do wyświetlania czasu, który upłynął, przy użyciu kilku innych interwałów czasowych.

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

open System

let centuryBegin = DateTime(2001, 1, 1)
let currentDate = DateTime.Now

let elapsedTicks = currentDate.Ticks - centuryBegin.Ticks
let elapsedSpan = TimeSpan elapsedTicks

printfn $"Elapsed from the beginning of the century to {currentDate:f}:"
printfn $"   {elapsedTicks * 100L:N0} nanoseconds"
printfn $"   {elapsedTicks:N0} ticks"
printfn $"   {elapsedSpan.TotalSeconds:N2} seconds"
printfn $"   {elapsedSpan.TotalMinutes:N2} minutes"
printfn $"   {elapsedSpan.Days:N0} days, {elapsedSpan.Hours} hours, {elapsedSpan.Minutes} minutes, {elapsedSpan.Seconds} 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

Uwagi

Pojedynczy kleszcz reprezentuje sto nanosekund lub dziesiątą milionową sekundy. Istnieje 10 000 kleszczy w milisekundach (patrz TicksPerMillisecond) i 10 milionów kleszczy w ciągu sekundy.

Wartość tej właściwości reprezentuje liczbę 100-nanosekundowych interwałów, które upłynęły od 12:00:00 północ, 1 stycznia 0001 w kalendarzu gregoriańskim, który reprezentuje MinValuewartość . Nie obejmuje liczby kleszczy, które są przypisane do sekund przestępnych. Jeśli obiekt DateTime ma właściwość Kind ustawioną na Local, jego znaczniki reprezentują czas, który upłynął od 12:00:00 północy, 1 stycznia 0001 w czasie lokalnym określonym przez bieżące ustawienie strefy czasowej. DateTime Jeśli obiekt ma właściwość Kind ustawioną na Utc, jego znaczniki reprezentują czas, który upłynął od 12:00:00 północy, 1 stycznia 0001 w uniwersalnym czasie koordynowanym. DateTime Jeśli obiekt ma właściwość Kind ustawioną na Unspecified, jego znaczniki reprezentują czas, który upłynął od 12:00:00 północy, 1 stycznia 0001 w nieznanej strefie czasowej.

Ogólnie rzecz biorąc, znaczniki reprezentują czas zgodnie ze strefą czasową określoną przez Kind właściwość .