DateTime.Ticks Właściwość

Definicja

Przestrzeń nazw:

System

Zestawy:

netstandard.dll, System.Runtime.dll

Źródło:

DateTime.cs

Pobiera liczbę znaczników 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ć TimeSpan wystąpienie obiektu. Obiekt TimeSpan jest następnie używany do wyświetlania czasu, który upłynął, przy użyciu kilku innych interwałów czasu.

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ółnocy, 1 stycznia 0001 w kalendarzu gregoriańskim, który reprezentuje MinValue. Nie zawiera liczby kleszczy, które są przypisywane 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ą Kind określoną przez właściwość .