DateTime.Ticks Propriété

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Source:

DateTime.cs

Obtient le nombre de graduations représentant la date et l'heure de cette instance.

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

public long Ticks { get; }

member this.Ticks : int64

Public ReadOnly Property Ticks As Long

Valeur de propriété

Int64

Nombre de graduations représentant la date et l'heure de cette instance. La valeur est comprise entre DateTime.MinValue.Ticks et DateTime.MaxValue.Ticks.

Exemples

L’exemple suivant utilise la Ticks propriété pour afficher le nombre de cycles qui se sont écoulés depuis le début du XXIe siècle et pour instancier un TimeSpan objet. L’objet TimeSpan est ensuite utilisé pour afficher le temps écoulé à l’aide de plusieurs autres intervalles de temps.

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

Remarques

Un cycle représente cent nanosecondes ou un dix-millionième de seconde. Il y a 10 000 cycles en une milliseconde (voir TicksPerMillisecond) et 10 millions de cycles en une seconde.

La valeur de cette propriété représente le nombre d’intervalles de 100 nanosecondes qui se sont écoulés depuis 12:00:00 minuit, le 1er janvier 0001 dans le calendrier grégorien, qui représente MinValue. Il n’inclut pas le nombre de cycles attribuables aux secondes bissextiles. Si la propriété de l’objet DateTime est Kind définie Localsur , ses graduations représentent le temps écoulé entre 12:00:00 minuit et le 1er janvier 0001 à l’heure locale, comme spécifié par le paramètre de fuseau horaire actuel. Si la propriété de l’objet DateTime est Kind définie sur Utc, ses graduations représentent le temps écoulé depuis 12:00:00 minuit, le 1er janvier 0001 dans le temps universel coordonné. Si la propriété de l’objet DateTimeKind est définie sur Unspecified, ses graduations représentent le temps écoulé depuis 12:00:00 minuit, le 1er janvier 0001 dans le fuseau horaire inconnu.

En général, les graduations représentent l’heure en fonction du fuseau horaire spécifié par la Kind propriété .