DateTime.Ticks Propriété

Définition

Espace de noms:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Source:

DateTime.cs

Obtient le nombre de graduations qui représentent 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 qui représentent 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 graduations qui se sont écoulées 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

Une seule graduation représente une centaine de nanosecondes ou un dix millionième de seconde. Il y a 10 000 cycles en millisecondes (voir TicksPerMillisecond) et 10 millions de cycles en 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 graduations attribuables à des secondes bissextiles. Si l’objet DateTime a sa Kind propriété définie Localsur , ses graduations représentent l’heure écoulée depuis 12:00:00 minuit, le 1er janvier 0001 dans l’heure locale spécifiée par le paramètre de fuseau horaire actuel. Si l’objet DateTime a sa Kind propriété définie Utcsur , ses graduations représentent le temps écoulé depuis 12:00:00 minuit, le 1er janvier 0001 dans le temps universel coordonné. Si l’objet DateTime a sa Kind propriété définie Unspecifiedsur , 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é.