DateTime.Ticks プロパティ

定義

このインスタンスの日付と時刻を表すタイマー刻み数を取得します。Gets the number of ticks that represent the date and time of this instance.

public:
 property long Ticks { long get(); };
public long Ticks { get; }
member this.Ticks : int64
Public ReadOnly Property Ticks As Long

プロパティ値

Int64

このインスタンスの日付と時刻を表すタイマー刻み数。The number of ticks that represent the date and time of this instance. 値は DateTime.MinValue.Ticks から DateTime.MaxValue.Ticks までの間にあります。The value is between DateTime.MinValue.Ticks and DateTime.MaxValue.Ticks.

次の例では、プロパティを使用して、 Ticks 20 番目の世紀の開始から経過したタイマー刻みの数を表示し、オブジェクトをインスタンス化し TimeSpan ます。The following example uses the Ticks property to display the number of ticks that have elapsed since the beginning of the twenty-first century and to instantiate a TimeSpan object. その TimeSpan 後、オブジェクトを使用して、他のいくつかの時間間隔を使用して経過時間を表示します。The TimeSpan object is then used to display the elapsed time using several other time intervals.

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

注釈

1 ティックは、100 ナノ秒または 1,000 万分の 1 秒を表します。A single tick represents one hundred nanoseconds or one ten-millionth of a second. ミリ秒単位には1万ティックがあります (「」を参照 TicksPerMillisecond )。2番目のタイマー刻みは1000万ティックです。There are 10,000 ticks in a millisecond (see TicksPerMillisecond) and 10 million ticks in a second.

このプロパティの値は、グレゴリオ暦の0001年1月1日の午前0時12:00:00 からの経過時間を表す100ナノ秒間隔の数を表し MinValue ます。The value of this property represents the number of 100-nanosecond intervals that have elapsed since 12:00:00 midnight, January 1, 0001 in the Gregorian calendar, which represents MinValue. これには、うるう秒に起因するタイマー刻みの数は含まれません。It does not include the number of ticks that are attributable to leap seconds. DateTime オブジェクトのプロパティがに設定されている場合 Kind 、このタイマー刻みは、現在の Local タイムゾーンの設定で指定されている現地時刻で、0001年1月1日午前12:00:00 時からの経過時間を表します。If the DateTime object has its Kind property set to Local, its ticks represent the time elapsed time since 12:00:00 midnight, January 1, 0001 in the local time as specified by the current time zone setting. オブジェクトの DateTime プロパティがに設定されている場合 Kind Utc 、そのタイマー刻みは、世界協定時刻の0001年1月1日午前12:00:00 に経過した時間を表します。If the DateTime object has its Kind property set to Utc, its ticks represent the time elapsed time since 12:00:00 midnight, January 1, 0001 in the Coordinated Universal Time. オブジェクトの DateTime プロパティがに設定されている場合 Kind 、このタイマー刻みは、 Unspecified 不明なタイムゾーンの0001年1月1日午前12:00:00 時からの経過時間を表します。If the DateTime object has its Kind property set to Unspecified, its ticks represent the time elapsed time since 12:00:00 midnight, January 1, 0001 in the unknown time zone.

一般に、ティックは、プロパティによって指定されたタイムゾーンに従って時間を表し Kind ます。In general, the ticks represent the time according to the time zone specified by the Kind property.

適用対象