TimeSpan 構造体

定義

名前空間:

System

アセンブリ:

System.Runtime.dll

ソース:

TimeSpan.cs

時間間隔を表します。

public value class TimeSpan : IComparable, IComparable<TimeSpan>, IEquatable<TimeSpan>, IParsable<TimeSpan>, ISpanFormattable, ISpanParsable<TimeSpan>, IUtf8SpanFormattable

public readonly struct TimeSpan : IComparable, IComparable<TimeSpan>, IEquatable<TimeSpan>, IParsable<TimeSpan>, ISpanFormattable, ISpanParsable<TimeSpan>, IUtf8SpanFormattable

type TimeSpan = struct
    interface IFormattable
    interface IParsable<TimeSpan>
    interface ISpanFormattable
    interface ISpanParsable<TimeSpan>
    interface IUtf8SpanFormattable

Public Structure TimeSpan
Implements IComparable, IComparable(Of TimeSpan), IEquatable(Of TimeSpan), IParsable(Of TimeSpan), ISpanFormattable, ISpanParsable(Of TimeSpan), IUtf8SpanFormattable

継承

Object

ValueType

TimeSpan

実装

IComparable IComparable<TimeSpan> IEquatable<TimeSpan> IFormattable ISpanFormattable IParsable<TimeSpan> IParsable<TSelf> ISpanParsable<TimeSpan> IUtf8SpanFormattable

例

次の例では、2 つの日付の差を表す TimeSpan オブジェクトをインスタンス化します。 その後、TimeSpan オブジェクトのプロパティが表示されます。

// Define two dates.
DateTime date1 = new DateTime(2010, 1, 1, 8, 0, 15);
DateTime date2 = new DateTime(2010, 8, 18, 13, 30, 30);

// Calculate the interval between the two dates.
TimeSpan interval = date2 - date1;
Console.WriteLine("{0} - {1} = {2}", date2, date1, interval.ToString());

// Display individual properties of the resulting TimeSpan object.
Console.WriteLine("   {0,-35} {1,20}", "Value of Days Component:", interval.Days);
Console.WriteLine("   {0,-35} {1,20}", "Total Number of Days:", interval.TotalDays);
Console.WriteLine("   {0,-35} {1,20}", "Value of Hours Component:", interval.Hours);
Console.WriteLine("   {0,-35} {1,20}", "Total Number of Hours:", interval.TotalHours);
Console.WriteLine("   {0,-35} {1,20}", "Value of Minutes Component:", interval.Minutes);
Console.WriteLine("   {0,-35} {1,20}", "Total Number of Minutes:", interval.TotalMinutes);
Console.WriteLine("   {0,-35} {1,20:N0}", "Value of Seconds Component:", interval.Seconds);
Console.WriteLine("   {0,-35} {1,20:N0}", "Total Number of Seconds:", interval.TotalSeconds);
Console.WriteLine("   {0,-35} {1,20:N0}", "Value of Milliseconds Component:", interval.Milliseconds);
Console.WriteLine("   {0,-35} {1,20:N0}", "Total Number of Milliseconds:", interval.TotalMilliseconds);
Console.WriteLine("   {0,-35} {1,20:N0}", "Ticks:", interval.Ticks);

// This example displays the following output:
//       8/18/2010 1:30:30 PM - 1/1/2010 8:00:15 AM = 229.05:30:15
//          Value of Days Component:                             229
//          Total Number of Days:                   229.229340277778
//          Value of Hours Component:                              5
//          Total Number of Hours:                  5501.50416666667
//          Value of Minutes Component:                           30
//          Total Number of Minutes:                       330090.25
//          Value of Seconds Component:                           15
//          Total Number of Seconds:                      19,805,415
//          Value of Milliseconds Component:                       0
//          Total Number of Milliseconds:             19,805,415,000
//          Ticks:                               198,054,150,000,000

// Define two dates.
let date1 = DateTime(2010, 1, 1, 8, 0, 15)
let date2 = DateTime(2010, 8, 18, 13, 30, 30)

// Calculate the interval between the two dates.
let interval = date2 - date1
printfn $"{date2} - {date1} = {interval}"

// Display individual properties of the resulting TimeSpan object.
printfn $"""   {"Value of Days Component:",-35} {interval.Days,20}""" 
printfn $"""   {"Total Number of Days:",-35} {interval.TotalDays,20}""" 
printfn $"""   {"Value of Hours Component:",-35} {interval.Hours,20}""" 
printfn $"""   {"Total Number of Hours:",-35} {interval.TotalHours,20}""" 
printfn $"""   {"Value of Minutes Component:",-35} {interval.Minutes,20}""" 
printfn $"""   {"Total Number of Minutes:",-35} {interval.TotalMinutes,20}""" 
printfn $"""   {"Value of Seconds Component:",-35} {interval.Seconds,20:N0}""" 
printfn $"""   {"Total Number of Seconds:",-35} {interval.TotalSeconds,20:N0}""" 
printfn $"""   {"Value of Milliseconds Component:",-35} {interval.Milliseconds,20:N0}""" 
printfn $"""   {"Total Number of Milliseconds:",-35} {interval.TotalMilliseconds,20:N0}""" 
printfn $"""   {"Ticks:",-35} {interval.Ticks,20:N0}""" 

// This example displays the following output:
//       8/18/2010 1:30:30 PM - 1/1/2010 8:00:15 AM = 229.05:30:15
//          Value of Days Component:                             229
//          Total Number of Days:                   229.229340277778
//          Value of Hours Component:                              5
//          Total Number of Hours:                  5501.50416666667
//          Value of Minutes Component:                           30
//          Total Number of Minutes:                       330090.25
//          Value of Seconds Component:                           15
//          Total Number of Seconds:                      19,805,415
//          Value of Milliseconds Component:                       0
//          Total Number of Milliseconds:             19,805,415,000
//          Ticks:                               198,054,150,000,000

' Define two dates.
Dim date1 As Date = #1/1/2010 8:00:15AM#
Dim date2 As Date = #8/18/2010 1:30:30PM#
' Calculate the interval between the two dates.
Dim interval As TimeSpan = date2 - date1
Console.WriteLine("{0} - {1} = {2}", date2, date1, interval.ToString())
' Display individual properties of the resulting TimeSpan object.
Console.WriteLine("   {0,-35} {1,20}", "Value of Days Component:", interval.Days)
Console.WriteLine("   {0,-35} {1,20}", "Total Number of Days:", interval.TotalDays)
Console.WriteLine("   {0,-35} {1,20}", "Value of Hours Component:", interval.Hours)
Console.WriteLine("   {0,-35} {1,20}", "Total Number of Hours:", interval.TotalHours)
Console.WriteLine("   {0,-35} {1,20}", "Value of Minutes Component:", interval.Minutes)
Console.WriteLine("   {0,-35} {1,20}", "Total Number of Minutes:", interval.TotalMinutes)
Console.WriteLine("   {0,-35} {1,20:N0}", "Value of Seconds Component:", interval.Seconds)
Console.WriteLine("   {0,-35} {1,20:N0}", "Total Number of Seconds:", interval.TotalSeconds)
Console.WriteLine("   {0,-35} {1,20:N0}", "Value of Milliseconds Component:", interval.Milliseconds)
Console.WriteLine("   {0,-35} {1,20:N0}", "Total Number of Milliseconds:", interval.TotalMilliseconds)
Console.WriteLine("   {0,-35} {1,20:N0}", "Ticks:", interval.Ticks)
' The example displays the following output:
'       8/18/2010 1:30:30 PM - 1/1/2010 8:00:15 AM = 229.05:30:15
'          Value of Days Component:                             229
'          Total Number of Days:                   229.229340277778
'          Value of Hours Component:                              5
'          Total Number of Hours:                  5501.50416666667
'          Value of Minutes Component:                           30
'          Total Number of Minutes:                       330090.25
'          Value of Seconds Component:                           15
'          Total Number of Seconds:                      19,805,415
'          Value of Milliseconds Component:                       0
'          Total Number of Milliseconds:             19,805,415,000
'          Ticks:                               198,054,150,000,000

# Define two dates.
$Date2 = Get-Date -Date '2010/8/18' -Hour 13 -Minute 30 -Second 30
$Date1 = Get-Date -Date '2010/1/1'  -Hour 8  -Minute 0  -Second 15

# Calculate the interval between the two dates.
$Interval = $Date2 - $Date1
"{0} - {1} = {2}" -f $Date2, $Date1, ($Interval.ToString())

#  Display individual properties of the resulting TimeSpan object.
"   {0,-35} {1,20}"    -f "Value of Days Component:", $Interval.Days
"   {0,-35} {1,20}"    -f "Total Number of Days:", $Interval.TotalDays
"   {0,-35} {1,20}"    -f "Value of Hours Component:", $Interval.Hours
"   {0,-35} {1,20}"    -f "Total Number of Hours:", $Interval.TotalHours
"   {0,-35} {1,20}"    -f "Value of Minutes Component:", $Interval.Minutes
"   {0,-35} {1,20}"    -f "Total Number of Minutes:", $Interval.TotalMinutes
"   {0,-35} {1,20:N0}" -f "Value of Seconds Component:", $Interval.Seconds
"   {0,-35} {1,20:N0}" -f "Total Number of Seconds:", $Interval.TotalSeconds
"   {0,-35} {1,20:N0}" -f "Value of Milliseconds Component:", $Interval.Milliseconds
"   {0,-35} {1,20:N0}" -f "Total Number of Milliseconds:", $Interval.TotalMilliseconds
"   {0,-35} {1,20:N0}" -f "Ticks:", $Interval.Ticks

<# This sample produces the following output:

18/08/2010 13:30:30 - 01/01/2010 08:00:15 = 229.05:30:15
   Value of Days Component:                             229
   Total Number of Days:                   229.229340277778
   Value of Hours Component:                              5
   Total Number of Hours:                  5501.50416666667
   Value of Minutes Component:                           30
   Total Number of Minutes:                       330090.25
   Value of Seconds Component:                           15
   Total Number of Seconds:                      19,805,415
   Value of Milliseconds Component:                       0
   Total Number of Milliseconds:             19,805,415,000
   Ticks:                               198,054,150,000,000
#>

注釈

この API の詳細については、「TimeSpanの補足 API 解説 参照してください。

コンストラクター

TimeSpan(Int32, Int32, Int32)	TimeSpan 構造体の新しいインスタンスを、指定した時間、分、秒の数に初期化します。
TimeSpan(Int32, Int32, Int32, Int32)	指定した日数、時間、分、秒に TimeSpan 構造体の新しいインスタンスを初期化します。
TimeSpan(Int32, Int32, Int32, Int32, Int32)	指定した日数、時間、分、秒、ミリ秒に TimeSpan 構造体の新しいインスタンスを初期化します。
TimeSpan(Int32, Int32, Int32, Int32, Int32, Int32)	TimeSpan 構造体の新しいインスタンスを、指定した日数、時間、分、秒、ミリ秒、マイクロ秒に初期化します。
TimeSpan(Int64)	指定したティック数に TimeSpan 構造体の新しいインスタンスを初期化します。

フィールド

MaxValue	最大 TimeSpan 値を表します。 このフィールドは読み取り専用です。
MinValue	最小 TimeSpan 値を表します。 このフィールドは読み取り専用です。
NanosecondsPerTick	ティックあたりのナノ秒の数を表します。 このフィールドは定数です。
TicksPerDay	1 日のティック数を表します。 このフィールドは定数です。
TicksPerHour	1 時間のティック数を表します。 このフィールドは定数です。
TicksPerMicrosecond	ティック数を 1 マイクロ秒で表します。 このフィールドは定数です。
TicksPerMillisecond	1 ミリ秒のティック数を表します。 このフィールドは定数です。
TicksPerMinute	1 分間のティック数を表します。 このフィールドは定数です。
TicksPerSecond	1 秒のティック数を表します。
Zero	0 TimeSpan 値を表します。 このフィールドは読み取り専用です。

プロパティ

Days	現在の TimeSpan 構造体で表される時間間隔の日数コンポーネントを取得します。
Hours	現在の TimeSpan 構造体で表される時間間隔の時間コンポーネントを取得します。
Microseconds	現在の TimeSpan 構造体で表される時間間隔のマイクロ秒単位のコンポーネントを取得します。
Milliseconds	現在の TimeSpan 構造体によって表される時間間隔のミリ秒の要素を取得します。
Minutes	現在の TimeSpan 構造体で表される時間間隔の分単位を取得します。
Nanoseconds	現在の TimeSpan 構造体で表される時間間隔のナノ秒単位のコンポーネントを取得します。
Seconds	現在の TimeSpan 構造体によって表される時間間隔の秒の部分を取得します。
Ticks	現在の TimeSpan 構造体の値を表すティック数を取得します。
TotalDays	現在の TimeSpan 構造体の値を、全体と小数部の日数で表す値を取得します。
TotalHours	現在の TimeSpan 構造体の値を、時間全体と小数部で表される値を取得します。
TotalMicroseconds	現在の TimeSpan 構造体の値を、マイクロ秒の整数と小数部で表される値を取得します。
TotalMilliseconds	現在の TimeSpan 構造体の値を、ミリ秒単位と小数部単位で表す値を取得します。
TotalMinutes	現在の TimeSpan 構造体の値を、分単位と小数部で表した値を取得します。
TotalNanoseconds	現在の TimeSpan 構造体の値を、全体および小数部のナノ秒で表す値を取得します。
TotalSeconds	現在の TimeSpan 構造体の値を、秒の全体と小数部で表す値を取得します。

メソッド

Add(TimeSpan)	指定した TimeSpan オブジェクトとこのインスタンスの合計を値とする新しい TimeSpan オブジェクトを返します。
Compare(TimeSpan, TimeSpan)	2 つの TimeSpan 値を比較し、最初の値が 2 番目の値より短いか、等しいか、または長いかを示す整数を返します。
CompareTo(Object)	このインスタンスを指定したオブジェクトと比較し、このインスタンスが指定したオブジェクトより短いか、等しいか、または長いかを示す整数を返します。
CompareTo(TimeSpan)	このインスタンスを指定した TimeSpan オブジェクトと比較し、このインスタンスが TimeSpan オブジェクトより短いか、等しいか、または長いかを示す整数を返します。
Divide(Double)	このインスタンスを指定した divisorで除算した結果の値を持つ新しい TimeSpan オブジェクトを返します。
Divide(TimeSpan)	このインスタンスを tsで除算した結果である新しい Double 値を返します。
Duration()	現在の TimeSpan オブジェクトの絶対値を値とする新しい TimeSpan オブジェクトを返します。
Equals(Object)	このインスタンスが指定したオブジェクトと等しいかどうかを示す値を返します。
Equals(TimeSpan)	このインスタンスが指定した TimeSpan オブジェクトと等しいかどうかを示す値を返します。
Equals(TimeSpan, TimeSpan)	TimeSpan の指定した 2 つのインスタンスが等しいかどうかを示す値を返します。
FromDays(Double)	指定した日数を表す TimeSpan を返します。指定は最も近いミリ秒に正確です。
FromHours(Double)	指定した時間数を表す TimeSpan を返します。指定は最も近いミリ秒に正確です。
FromMicroseconds(Double)	指定したマイクロ秒数を表す TimeSpan を返します。
FromMilliseconds(Double)	指定したミリ秒数を表す TimeSpan を返します。
FromMinutes(Double)	指定した分数を表す TimeSpan を返します。ここで、指定は最も近いミリ秒に正確です。
FromSeconds(Double)	指定した秒数を表す TimeSpan を返します。指定は最も近いミリ秒に正確です。
FromTicks(Int64)	指定した時間を表す TimeSpan を返します。ここで、指定はティック単位です。
GetHashCode()	このインスタンスのハッシュ コードを返します。
Multiply(Double)	このインスタンスと指定した factorの乗算の結果である値を持つ新しい TimeSpan オブジェクトを返します。
Negate()	このインスタンスの否定値を値とする新しい TimeSpan オブジェクトを返します。
Parse(ReadOnlySpan<Char>, IFormatProvider)	指定したカルチャ固有の書式情報を使用して、時間間隔のスパン表現を同等の TimeSpan に変換します。
Parse(String)	時間間隔の文字列形式を等価の TimeSpan に変換します。
Parse(String, IFormatProvider)	指定したカルチャ固有の書式情報を使用して、時間間隔の文字列形式を等価の TimeSpan に変換します。
ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, TimeSpanStyles)	指定した書式およびカルチャ固有の書式情報を使用して、時間間隔の文字範囲を等価の TimeSpan に変換します。 文字列形式の形式は、指定した形式と正確に一致する必要があります。
ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, TimeSpanStyles)	指定した書式、カルチャ固有の書式情報、およびスタイルを使用して、時間間隔の文字列形式を等価の TimeSpan に変換します。 文字列形式の形式は、指定した形式のいずれかと正確に一致する必要があります。
ParseExact(String, String, IFormatProvider)	指定した書式およびカルチャ固有の書式情報を使用して、時間間隔の文字列形式を等価の TimeSpan に変換します。 文字列形式の形式は、指定した形式と正確に一致する必要があります。
ParseExact(String, String, IFormatProvider, TimeSpanStyles)	指定した書式、カルチャ固有の書式情報、およびスタイルを使用して、時間間隔の文字列形式を等価の TimeSpan に変換します。 文字列形式の形式は、指定した形式と正確に一致する必要があります。
ParseExact(String, String[], IFormatProvider)	指定した書式指定文字列の配列とカルチャ固有の書式情報を使用して、時間間隔の文字列形式を等価の TimeSpan に変換します。 文字列形式の形式は、指定した形式のいずれかと正確に一致する必要があります。
ParseExact(String, String[], IFormatProvider, TimeSpanStyles)	指定した書式、カルチャ固有の書式情報、およびスタイルを使用して、時間間隔の文字列形式を等価の TimeSpan に変換します。 文字列形式の形式は、指定した形式のいずれかと正確に一致する必要があります。
Subtract(TimeSpan)	指定した TimeSpan オブジェクトとこのインスタンスの差を値とする新しい TimeSpan オブジェクトを返します。
ToString()	現在の TimeSpan オブジェクトの値を等価の文字列形式に変換します。
ToString(String)	指定した形式を使用して、現在の TimeSpan オブジェクトの値を等価の文字列形式に変換します。
ToString(String, IFormatProvider)	現在の TimeSpan オブジェクトの値を、指定した書式およびカルチャ固有の書式情報を使用して、同等の文字列形式に変換します。
TryFormat(Span<Byte>, Int32, ReadOnlySpan<Char>, IFormatProvider)	現在のインスタンスの値を UTF-8 として指定されたバイトスパンに書式設定しようとします。
TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)	現在の期間の数値インスタンスの値を、指定された文字数範囲に書式設定しようとします。
TryParse(ReadOnlySpan<Char>, IFormatProvider, TimeSpan)	指定したカルチャ固有の書式設定情報を使用して、時間間隔のスパン表現を同等の TimeSpan に変換し、変換が成功したかどうかを示す値を返します。
TryParse(ReadOnlySpan<Char>, TimeSpan)	時間間隔のスパン表現を等価の TimeSpan に変換し、変換が成功したかどうかを示す値を返します。
TryParse(String, IFormatProvider, TimeSpan)	指定したカルチャ固有の書式設定情報を使用して、時間間隔の文字列形式を等価の TimeSpan に変換し、変換が成功したかどうかを示す値を返します。
TryParse(String, TimeSpan)	時間間隔の文字列形式を等価の TimeSpan に変換し、変換が成功したかどうかを示す値を返します。
TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, TimeSpan)	指定した書式とカルチャ固有の書式情報を使用して、時間間隔の指定したスパン表現を等価の TimeSpan に変換します。 文字列形式の形式は、指定した形式と正確に一致する必要があります。
TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, TimeSpanStyles, TimeSpan)	指定した形式、カルチャ固有の書式情報、およびスタイルを使用して、時間間隔の指定したスパン表現を等価の TimeSpan に変換し、変換が成功したかどうかを示す値を返します。 文字列形式の形式は、指定した形式と正確に一致する必要があります。
TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, TimeSpan)	指定した書式とカルチャ固有の書式情報を使用して、時間間隔の指定したスパン表現を等価の TimeSpan に変換します。 文字列形式の形式は、指定した形式のいずれかと正確に一致する必要があります。
TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, TimeSpanStyles, TimeSpan)	指定した書式、カルチャ固有の書式情報、およびスタイルを使用して、時間間隔の指定したスパン表現を等価の TimeSpan に変換します。 文字列形式の形式は、指定した形式のいずれかと正確に一致する必要があります。
TryParseExact(String, String, IFormatProvider, TimeSpan)	指定した書式およびカルチャ固有の書式情報を使用して、時間間隔の文字列形式を等価の TimeSpan に変換します。 文字列形式の形式は、指定した形式と正確に一致する必要があります。
TryParseExact(String, String, IFormatProvider, TimeSpanStyles, TimeSpan)	指定した書式、カルチャ固有の書式情報、およびスタイルを使用して、時間間隔の文字列形式を等価の TimeSpan に変換します。 文字列形式の形式は、指定した形式と正確に一致する必要があります。
TryParseExact(String, String[], IFormatProvider, TimeSpan)	指定した書式とカルチャ固有の書式情報を使用して、指定した文字列形式の時間間隔を等価の TimeSpan に変換します。 文字列形式の形式は、指定した形式のいずれかと正確に一致する必要があります。
TryParseExact(String, String[], IFormatProvider, TimeSpanStyles, TimeSpan)	指定した書式、カルチャ固有の書式情報、およびスタイルを使用して、時間間隔の指定した文字列形式を等価の TimeSpan に変換します。 文字列形式の形式は、指定した形式のいずれかと正確に一致する必要があります。

演算子

Addition(TimeSpan, TimeSpan)	指定した 2 つの TimeSpan インスタンスを追加します。
Division(TimeSpan, Double)	指定した timeSpan を指定した divisorで除算した結果の値を持つ新しい TimeSpan オブジェクトを返します。
Division(TimeSpan, TimeSpan)	t1 を t2で除算した結果である新しい Double 値を返します。
Equality(TimeSpan, TimeSpan)	2 つの TimeSpan インスタンスが等しいかどうかを示します。
GreaterThan(TimeSpan, TimeSpan)	指定した TimeSpan が別の指定した TimeSpanより大きいかどうかを示します。
GreaterThanOrEqual(TimeSpan, TimeSpan)	指定した TimeSpan が別の指定した TimeSpan以上かどうかを示します。
Inequality(TimeSpan, TimeSpan)	2 つの TimeSpan インスタンスが等しくないかどうかを示します。
LessThan(TimeSpan, TimeSpan)	指定した TimeSpan が別の指定した TimeSpanより小さいかどうかを示します。
LessThanOrEqual(TimeSpan, TimeSpan)	指定した TimeSpan が別の指定した TimeSpan以下かどうかを示します。
Multiply(Double, TimeSpan)	指定した factor と指定した timeSpan インスタンスを乗算した結果の値を持つ新しい TimeSpan オブジェクトを返します。
Multiply(TimeSpan, Double)	指定した timeSpan インスタンスと指定した factorを乗算した結果の値を持つ新しい TimeSpan オブジェクトを返します。
Subtraction(TimeSpan, TimeSpan)	指定した別の TimeSpanから、指定した TimeSpan を減算します。
UnaryNegation(TimeSpan)	指定したインスタンスの否定値を値とする TimeSpan を返します。
UnaryPlus(TimeSpan)	TimeSpanの指定したインスタンスを返します。

こちらもご覧ください

• DateTime
• DateTimeOffset
• Calendar