DateTime.Ticks Właściwość

Definicja

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

C#
public long Ticks { get; }

Wartość właściwości

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.

C#
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

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ść .

Dotyczy

Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0