TimeSpan 结构

定义

命名空间:

System

程序集:

System.Runtime.dll

Source:

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

示例

以下示例实例化表示两个日期之间的差异的 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	表示零 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)	比较两个 TimeSpan 值，并返回一个整数，该值指示第一个值是短于、等于还是长于第二个值。
CompareTo(Object)	将此实例与指定的对象进行比较，并返回一个整数，该整数指示此实例是短于、等于还是长于指定对象。
CompareTo(TimeSpan)	将此实例与指定的 TimeSpan 对象进行比较，并返回一个整数，该整数指示此实例是短于、等于还是比 TimeSpan 对象长。
Divide(Double)	返回一个新的 TimeSpan 对象，其值是将此实例除以指定 divisor的结果。
Divide(TimeSpan)	返回一个新的 Double 值，该值是将此实例除以 ts的结果。
Duration()	返回一个新的 TimeSpan 对象，该对象的值是当前 TimeSpan 对象的绝对值。
Equals(Object)	返回一个值，该值指示此实例是否等于指定的对象。
Equals(TimeSpan)	返回一个值，该值指示此实例是否等于指定的 TimeSpan 对象。
Equals(TimeSpan, TimeSpan)	返回一个值，该值指示两个指定的 TimeSpan 实例是否相等。
FromDays(Double)	返回一个表示指定天数的 TimeSpan，其中规范准确到最接近毫秒。
FromHours(Double)	返回一个表示指定小时数的 TimeSpan，其中规范准确到最接近毫秒。
FromMicroseconds(Double)	返回一个表示指定数量的微秒的 TimeSpan。
FromMilliseconds(Double)	返回一个表示指定毫秒数的 TimeSpan。
FromMinutes(Double)	返回一个表示指定分钟数的 TimeSpan，其中规范准确到最接近毫秒。
FromSeconds(Double)	返回一个表示指定秒数的 TimeSpan，其中规范准确到最接近毫秒。
FromTicks(Int64)	返回一个表示指定时间的 TimeSpan，其中规范以刻度为单位。
GetHashCode()	返回此实例的哈希代码。
Multiply(Double)	返回一个新的 TimeSpan 对象，该值是此实例和指定 factor乘法的结果。
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)	添加两个指定的 TimeSpan 实例。
Division(TimeSpan, Double)	返回一个新的 TimeSpan 对象，该对象的值是将指定的 timeSpan 除以指定 divisor的结果。
Division(TimeSpan, TimeSpan)	返回一个新的 Double 值，该值由 t2除以 t1。
Equality(TimeSpan, TimeSpan)	指示两个 TimeSpan 实例是否相等。
GreaterThan(TimeSpan, TimeSpan)	指示指定的 TimeSpan 是否大于另一个指定的 TimeSpan。
GreaterThanOrEqual(TimeSpan, TimeSpan)	指示指定的 TimeSpan 是否大于或等于另一个指定的 TimeSpan。
Inequality(TimeSpan, TimeSpan)	指示两个 TimeSpan 实例是否不相等。
LessThan(TimeSpan, TimeSpan)	指示指定的 TimeSpan 是否小于另一个指定的 TimeSpan。
LessThanOrEqual(TimeSpan, TimeSpan)	指示指定的 TimeSpan 是否小于或等于另一个指定的 TimeSpan。
Multiply(Double, TimeSpan)	返回一个新的 TimeSpan 对象，该对象的值是乘以指定的 factor 和指定的 timeSpan 实例的结果。
Multiply(TimeSpan, Double)	返回一个新的 TimeSpan 对象，该对象的值是乘以指定的 timeSpan 实例和指定的 factor的结果。
Subtraction(TimeSpan, TimeSpan)	从另一个指定的 TimeSpan中减去指定的 TimeSpan。
UnaryNegation(TimeSpan)	返回一个 TimeSpan，其值是指定实例的否定值。
UnaryPlus(TimeSpan)	返回 TimeSpan的指定实例。

另请参阅

• DateTime
• DateTimeOffset
• Calendar