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 プロパティを使用して、21世紀の開始から経過したタイマー刻みの数を表示し、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 10-万の秒を表します。A single tick represents one hundred nanoseconds or one ten-millionth of a second. ミリ秒単位では1万ティック、1秒あたりは1000万タイマー刻みがあります。There are 10,000 ticks in a millisecond, or 10 million ticks in a second.

このプロパティの値は、MinValueを表すグレゴリオ暦で、0001年1月1日の午前12:00:00 からの経過時間を100ナノ秒単位で表します。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.

適用対象