DateTime.Ticks Eigenschaft

Definition

Namespace:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Quelle:

DateTime.cs

Ruft die Anzahl der Teilstriche ab, die das Datum und die Uhrzeit dieser Instanz darstellen.

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

public long Ticks { get; }

member this.Ticks : int64

Public ReadOnly Property Ticks As Long

Eigenschaftswert

Int64

Die Anzahl der Teilstriche, die das Datum und die Uhrzeit dieser Instanz darstellen. Der Wert liegt zwischen DateTime.MinValue.Ticks und DateTime.MaxValue.Ticks.

Beispiele

Im folgenden Beispiel wird die Ticks Eigenschaft verwendet, um die Anzahl der Zecken anzuzeigen, die seit Beginn des 20. Jahrhunderts verstrichen sind, und um ein TimeSpan Objekt instanziieren zu können. Anschließend TimeSpan wird das Objekt verwendet, um die verstrichene Zeit mithilfe mehrerer anderer Zeitintervalle anzuzeigen.

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

Hinweise

Ein einzelner Teilstrich stellt einhundert Nanosekunden oder ein Zehntel einer Sekunde dar. Es gibt 10.000 Ticks in einer Millisekunden (siehe TicksPerMillisecond) und 10 Millionen Zecken in einer Sekunde.

Der Wert dieser Eigenschaft stellt die Anzahl der 100-Nanosekunden-Intervalle dar, die seit 12:00:00 Mitternacht, dem 1. Januar 0001 im gregorianischen Kalender verstrichen MinValuesind. Sie enthält nicht die Anzahl der Teilstriche, die auf Schaltsekunden zurückzuführen sind. Wenn das DateTime-Objekt seine Kind Eigenschaft auf Localfestgelegt hat, stellen die Teilstriche die verstrichene Zeit seit 12:00:00 Mitternacht, dem 1. Januar 0001 in der lokalen Zeit dar, wie durch die aktuelle Zeitzoneneinstellung angegeben. Wenn das DateTime Objekt seine Kind Eigenschaft auf Utcfestgelegt hat, stellen die Teilstriche die verstrichene Zeit seit 12:00:00 Mitternacht, dem 1. Januar 0001 in der koordinierten Weltzeit dar. Wenn das DateTime Objekt seine Kind Eigenschaft auf Unspecifiedfestgelegt hat, stellen die Teilstriche die verstrichene Zeit seit 12:00:00 Mitternacht, dem 1. Januar 0001 in der unbekannten Zeitzone dar.

Im Allgemeinen stellen die Teilstriche die Uhrzeit gemäß der durch die Kind Eigenschaft angegebenen Zeitzone dar.