TimeSpan 結構(System) | Microsoft Docs
文章推薦指數: 80 %
下列範例會具現化TimeSpan 表示兩個日期之間差異的物件。
然後,它會顯示TimeSpan 物件的屬性。
C# 複製.
跳到主要內容
已不再支援此瀏覽器。
請升級至MicrosoftEdge,以利用最新功能、安全性更新和技術支援。
下載MicrosoftEdge
其他資訊
目錄
結束焦點模式
語言
閱讀英文
儲存
編輯
共用
Twitter
LinkedIn
Facebook
電子郵件
WeChat
目錄
語言
語言
閱讀英文
儲存
目錄
閱讀英文
儲存
編輯
Twitter
LinkedIn
Facebook
電子郵件
WeChat
目錄
TimeSpan結構
參考
此頁面有所助益嗎?
Yes
No
還有其他意見反應嗎?
系統會將意見反應傳送給Microsoft:按下[提交]按鈕,您的意見反應將用來改善Microsoft產品和服務。
隱私權原則。
送出
謝謝。
定義
命名空間:
System
組件:System.Runtime.dll
組件:mscorlib.dll
組件:netstandard.dll
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。
Microsoft對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
表示時間間隔。
本文內容
publicvalueclassTimeSpan:IComparable,IComparable
然後,它會顯示TimeSpan物件的屬性。
//Definetwodates.
DateTimedate1=newDateTime(2010,1,1,8,0,15);
DateTimedate2=newDateTime(2010,8,18,13,30,30);
//Calculatetheintervalbetweenthetwodates.
TimeSpaninterval=date2-date1;
Console.WriteLine("{0}-{1}={2}",date2,date1,interval.ToString());
//DisplayindividualpropertiesoftheresultingTimeSpanobject.
Console.WriteLine("{0,-35}{1,20}","ValueofDaysComponent:",interval.Days);
Console.WriteLine("{0,-35}{1,20}","TotalNumberofDays:",interval.TotalDays);
Console.WriteLine("{0,-35}{1,20}","ValueofHoursComponent:",interval.Hours);
Console.WriteLine("{0,-35}{1,20}","TotalNumberofHours:",interval.TotalHours);
Console.WriteLine("{0,-35}{1,20}","ValueofMinutesComponent:",interval.Minutes);
Console.WriteLine("{0,-35}{1,20}","TotalNumberofMinutes:",interval.TotalMinutes);
Console.WriteLine("{0,-35}{1,20:N0}","ValueofSecondsComponent:",interval.Seconds);
Console.WriteLine("{0,-35}{1,20:N0}","TotalNumberofSeconds:",interval.TotalSeconds);
Console.WriteLine("{0,-35}{1,20:N0}","ValueofMillisecondsComponent:",interval.Milliseconds);
Console.WriteLine("{0,-35}{1,20:N0}","TotalNumberofMilliseconds:",interval.TotalMilliseconds);
Console.WriteLine("{0,-35}{1,20:N0}","Ticks:",interval.Ticks);
//Thisexampledisplaysthefollowingoutput:
//8/18/20101:30:30PM-1/1/20108:00:15AM=229.05:30:15
//ValueofDaysComponent:229
//TotalNumberofDays:229.229340277778
//ValueofHoursComponent:5
//TotalNumberofHours:5501.50416666667
//ValueofMinutesComponent:30
//TotalNumberofMinutes:330090.25
//ValueofSecondsComponent:15
//TotalNumberofSeconds:19,805,415
//ValueofMillisecondsComponent:0
//TotalNumberofMilliseconds:19,805,415,000
//Ticks:198,054,150,000,000
'Definetwodates.
Dimdate1AsDate=#1/1/20108:00:15AM#
Dimdate2AsDate=#8/18/20101:30:30PM#
'Calculatetheintervalbetweenthetwodates.
DimintervalAsTimeSpan=date2-date1
Console.WriteLine("{0}-{1}={2}",date2,date1,interval.ToString())
'DisplayindividualpropertiesoftheresultingTimeSpanobject.
Console.WriteLine("{0,-35}{1,20}","ValueofDaysComponent:",interval.Days)
Console.WriteLine("{0,-35}{1,20}","TotalNumberofDays:",interval.TotalDays)
Console.WriteLine("{0,-35}{1,20}","ValueofHoursComponent:",interval.Hours)
Console.WriteLine("{0,-35}{1,20}","TotalNumberofHours:",interval.TotalHours)
Console.WriteLine("{0,-35}{1,20}","ValueofMinutesComponent:",interval.Minutes)
Console.WriteLine("{0,-35}{1,20}","TotalNumberofMinutes:",interval.TotalMinutes)
Console.WriteLine("{0,-35}{1,20:N0}","ValueofSecondsComponent:",interval.Seconds)
Console.WriteLine("{0,-35}{1,20:N0}","TotalNumberofSeconds:",interval.TotalSeconds)
Console.WriteLine("{0,-35}{1,20:N0}","ValueofMillisecondsComponent:",interval.Milliseconds)
Console.WriteLine("{0,-35}{1,20:N0}","TotalNumberofMilliseconds:",interval.TotalMilliseconds)
Console.WriteLine("{0,-35}{1,20:N0}","Ticks:",interval.Ticks)
'Theexampledisplaysthefollowingoutput:
'8/18/20101:30:30PM-1/1/20108:00:15AM=229.05:30:15
'ValueofDaysComponent:229
'TotalNumberofDays:229.229340277778
'ValueofHoursComponent:5
'TotalNumberofHours:5501.50416666667
'ValueofMinutesComponent:30
'TotalNumberofMinutes:330090.25
'ValueofSecondsComponent:15
'TotalNumberofSeconds:19,805,415
'ValueofMillisecondsComponent:0
'TotalNumberofMilliseconds:19,805,415,000
'Ticks:198,054,150,000,000
#Definetwodates.
$Date2=Get-Date-Date'2010/8/18'-Hour13-Minute30-Second30
$Date1=Get-Date-Date'2010/1/1'-Hour8-Minute0-Second15
#Calculatetheintervalbetweenthetwodates.
$Interval=$Date2-$Date1
"{0}-{1}={2}"-f$Date2,$Date1,($Interval.ToString())
#DisplayindividualpropertiesoftheresultingTimeSpanobject.
"{0,-35}{1,20}"-f"ValueofDaysComponent:",$Interval.Days
"{0,-35}{1,20}"-f"TotalNumberofDays:",$Interval.TotalDays
"{0,-35}{1,20}"-f"ValueofHoursComponent:",$Interval.Hours
"{0,-35}{1,20}"-f"TotalNumberofHours:",$Interval.TotalHours
"{0,-35}{1,20}"-f"ValueofMinutesComponent:",$Interval.Minutes
"{0,-35}{1,20}"-f"TotalNumberofMinutes:",$Interval.TotalMinutes
"{0,-35}{1,20:N0}"-f"ValueofSecondsComponent:",$Interval.Seconds
"{0,-35}{1,20:N0}"-f"TotalNumberofSeconds:",$Interval.TotalSeconds
"{0,-35}{1,20:N0}"-f"ValueofMillisecondsComponent:",$Interval.Milliseconds
"{0,-35}{1,20:N0}"-f"TotalNumberofMilliseconds:",$Interval.TotalMilliseconds
"{0,-35}{1,20:N0}"-f"Ticks:",$Interval.Ticks
備註
TimeSpan物件代表時間間隔(時間間隔或經過時間),測量為正數或負數的天數、小時、分鐘、秒和秒數。
此TimeSpan結構也可以用來代表一天中的時間,但只有在時間與特定日期不相關時。
否則,DateTimeDateTimeOffset就應該改用或結構。
(如需使用TimeSpan結構反映當日時間的詳細資訊,請參閱選擇DateTime、DateTimeOffset、TimeSpan和TimeZoneInfo。
)
注意
TimeSpan值代表時間間隔,而且可以用特定的天數、時數、分鐘數、秒數和毫秒數表示。
因為它代表未參考特定起點或終點的一般間隔,所以不能以年和月表示,這兩個值都有不定的天數。
它與值不同DateTime,它代表未參考特定時區的日期和時間,或是DateTimeOffset代表特定時間點的值。
TimeSpan結構用來測量持續時間的最大時間單位是一天。
時間間隔是以天為單位來表示一致性,因為較大時間單位(例如月份和年份)的天數會有所不同。
物件的值TimeSpan是等於所表示時間間隔的刻度數目。
刻度等於100毫微秒或110-百萬分之一秒秒。
物件的值TimeSpan範圍可以從TimeSpan.MinValue到TimeSpan.MaxValue。
具現化TimeSpan值
您可以透過數種方式來具現化TimeSpan值:
藉由呼叫其隱含無參數的函式。
這會建立其值為的物件TimeSpan.Zero,如下列範例所示。
TimeSpaninterval=newTimeSpan();
Console.WriteLine(interval.Equals(TimeSpan.Zero));//Displays"True".
DimintervalAsNewTimeSpan()
Console.WriteLine(interval.Equals(TimeSpan.Zero))'Displays"True".
藉由呼叫其中一個明確的函式。
下列範例會將TimeSpan值初始化為指定的時數、分鐘數和秒數。
TimeSpaninterval=newTimeSpan(2,14,18);
Console.WriteLine(interval.ToString());
//Displays"02:14:18".
DimintervalAsNewTimeSpan(2,14,18)
Console.WriteLine(interval.ToString())'Displays"02:14:18".
藉由呼叫方法或執行傳回值的作業TimeSpan。
例如,您可以具現化TimeSpan表示兩個日期和時間值之間間隔的值,如下列範例所示。
DateTimedeparture=newDateTime(2010,6,12,18,32,0);
DateTimearrival=newDateTime(2010,6,13,22,47,0);
TimeSpantravelTime=arrival-departure;
Console.WriteLine("{0}-{1}={2}",arrival,departure,travelTime);
//Theexampledisplaysthefollowingoutput:
//6/13/201010:47:00PM-6/12/20106:32:00PM=1.04:15:00
DimdepartureAsDateTime=#06/12/20106:32PM#
DimarrivalAsDateTime=#06/13/201010:47PM#
DimtravelTimeAsTimeSpan=arrival-departure
Console.WriteLine("{0}-{1}={2}",arrival,departure,travelTime)
'Theexampledisplaysthefollowingoutput:
'6/13/201010:47:00PM-6/12/20106:32:00PM=1.04:15:00
您也可以使用TimeSpan這種方式將物件初始化為零時間值,如下列範例所示。
Randomrnd=newRandom();
TimeSpantimeSpent=TimeSpan.Zero;
timeSpent+=GetTimeBeforeLunch();
timeSpent+=GetTimeAfterLunch();
Console.WriteLine("Totaltime:{0}",timeSpent);
TimeSpanGetTimeBeforeLunch()
{
returnnewTimeSpan(rnd.Next(3,6),0,0);
}
TimeSpanGetTimeAfterLunch()
{
returnnewTimeSpan(rnd.Next(3,6),0,0);
}
//Theexampledisplaysoutputlikethefollowing:
//Totaltime:08:00:00
ModuleExample
DimrndAsNewRandom()
PublicSubMain()
DimtimeSpentAsTimeSpan=TimeSpan.Zero
timeSpent+=GetTimeBeforeLunch()
timeSpent+=GetTimeAfterLunch()
Console.WriteLine("Totaltime:{0}",timeSpent)
EndSub
PrivateFunctionGetTimeBeforeLunch()AsTimeSpan
ReturnNewTimeSpan(rnd.Next(3,6),0,0)
EndFunction
PrivateFunctionGetTimeAfterLunch()AsTimeSpan
ReturnNewTimeSpan(rnd.Next(3,6),0,0)
EndFunction
EndModule
'Theexampledisplaysoutputlikethefollowing:
'Totaltime:08:00:00
TimeSpanDateTime、和結構的算術運算子和方法會傳回值DateTimeOffsetTimeSpan。
藉由剖析值的字串表示TimeSpan。
您可以使用Parse和TryParse方法,將包含時間間隔的字串轉換成TimeSpan值。
下列範例會使用Parse方法,將字串的陣列轉換成TimeSpan值。
string[]values={"12","31.","5.8:32:16","12:12:15.95",".12"};
foreach(stringvalueinvalues)
{
try{
TimeSpants=TimeSpan.Parse(value);
Console.WriteLine("'{0}'-->{1}",value,ts);
}
catch(FormatException){
Console.WriteLine("Unabletoparse'{0}'",value);
}
catch(OverflowException){
Console.WriteLine("'{0}'isoutsidetherangeofaTimeSpan.",value);
}
}
//Theexampledisplaysthefollowingoutput:
//'12'-->12.00:00:00
//Unabletoparse'31.'
//'5.8:32:16'-->5.08:32:16
//'12:12:15.95'-->12:12:15.9500000
//Unabletoparse'.12'
Dimvalues()AsString={"12","31.","5.8:32:16","12:12:15.95",".12"}
ForEachvalueAsStringInvalues
Try
DimtsAsTimeSpan=TimeSpan.Parse(value)
Console.WriteLine("'{0}'-->{1}",value,ts)
CatcheAsFormatException
Console.WriteLine("Unabletoparse'{0}'",value)
CatcheAsOverflowException
Console.WriteLine("'{0}'isoutsidetherangeofaTimeSpan.",value)
EndTry
Next
'Theexampledisplaysthefollowingoutput:
''12'-->12.00:00:00
'Unabletoparse'31.'
''5.8:32:16'-->5.08:32:16
''12:12:15.95'-->12:12:15.9500000
'Unabletoparse'.12'
此外,您可以藉TimeSpan由呼叫或方法,來定義要剖析並轉換成值的輸入字串的精確格式ParseExactTryParseExact。
執行TimeSpan值的作業
您可以使用Addition和Subtraction運算子,或藉由呼叫Add和方法,來加入和減去時間持續時間Subtract。
您也可以藉由呼叫Compare、和方法來比較兩個時間持續時間CompareToEquals。
此TimeSpan結構也包含Duration和Negate方法,這些方法會將時間間隔轉換成正值和負值。
值的範圍為TimeSpanMinValueMaxValue。
格式化TimeSpan值
TimeSpan值可以表示為[-]d。
hh:mm:ss。
ff,其中選擇性的負號表示負的時間間隔,d元件是天,hh是以24小時制測量的小時,mm是分鐘,ss是秒,而ff是秒的分數。
也就是說,時間間隔是由沒有時間為一天的正數或負數的天數,或一天中的時間,或只有一天的時間所組成。
從.NETFramework4開始,結構會TimeSpan透過其方法的多載支援區分文化特性的格式ToString,將值轉換TimeSpan成其字串表示。
預設TimeSpan.ToString()方法會使用與舊版.NETFramework中的傳回值相同的非變異格式,傳回時間間隔。
多載TimeSpan.ToString(String)可讓您指定格式字串,以定義時間間隔的字串表示。
多載TimeSpan.ToString(String,IFormatProvider)可讓您指定格式字串和文化特性,其使用格式化慣例來建立時間間隔的字串表示。
TimeSpan支援標準和自訂格式字串。
(如需詳細資訊,請參閱標準Timespan格式字串和自訂timespan格式字串。
)不過,只有標準格式字串會區分文化特性。
還原舊版TimeSpan格式
在某些情況下,會TimeSpan在.NETFramework4中成功格式化.NETFramework3.5和較早版本中的值的程式碼會失敗。
這在呼叫
下列範例會成功格式化TimeSpan.NETFramework3.5和較早版本中的值,但在.NETFramework4和更新版本中會擲回例外狀況。
請注意,它會嘗試TimeSpan使用不支援的格式規範來將值格式化,這會在.NETFramework3.5和較早的版本中略過。
ShowFormattingCode();
//Outputfrom.NETFramework3.5andearlierversions:
//12:30:45
//Outputfrom.NETFramework4:
//InvalidFormat
Console.WriteLine("---");
ShowParsingCode();
//Output:
//000000006-->6.00:00:00
voidShowFormattingCode()
{
TimeSpaninterval=newTimeSpan(12,30,45);
stringoutput;
try{
output=String.Format("{0:r}",interval);
}
catch(FormatException){
output="InvalidFormat";
}
Console.WriteLine(output);
}
voidShowParsingCode()
{
stringvalue="000000006";
try{
TimeSpaninterval=TimeSpan.Parse(value);
Console.WriteLine("{0}-->{1}",value,interval);
}
catch(FormatException){
Console.WriteLine("{0}:BadFormat",value);
}
catch(OverflowException){
Console.WriteLine("{0}:Overflow",value);
}
}
DimintervalAsNewTimeSpan(12,30,45)
DimoutputAsString
Try
output=String.Format("{0:r}",interval)
CatcheAsFormatException
output="InvalidFormat"
EndTry
Console.WriteLine(output)
'Outputfrom.NETFramework3.5andearlierversions:
'12:30:45
'Outputfrom.NETFramework4:
'InvalidFormat
如果您無法修改程式碼,您可以透過TimeSpan下列其中一種方式來還原值的舊版格式:
藉由建立包含
設定這個專案的enabled屬性,以針對trueTimeSpan每個應用程式還原舊版格式。
當您建立應用程式域時,設定"NetFx40_TimeSpanLegacyFormatMode"相容性參數。
這可TimeSpan在每個應用程式網域上啟用舊版格式。
下列範例會建立使用舊版格式的應用程式域TimeSpan。
usingSystem;
publicclassExample
{
publicstaticvoidMain()
{
AppDomainSetupappSetup=newAppDomainSetup();
appSetup.SetCompatibilitySwitches(newstring[]{"NetFx40_TimeSpanLegacyFormatMode"});
AppDomainlegacyDomain=AppDomain.CreateDomain("legacyDomain",
null,appSetup);
legacyDomain.ExecuteAssembly("ShowTimeSpan.exe");
}
}
ModuleExample
PublicSubMain()
DimappSetupAsNewAppDomainSetup()
appSetup.SetCompatibilitySwitches({"NetFx40_TimeSpanLegacyFormatMode"})
DimlegacyDomainAsAppDomain=AppDomain.CreateDomain("legacyDomain",
Nothing,appSetup)
legacyDomain.ExecuteAssembly("ShowTimeSpan.exe")
EndSub
EndModule
當下列程式碼在新的應用程式域中執行時,它會還原為舊版TimeSpan格式化行為。
usingSystem;
publicclassExample
{
publicstaticvoidMain()
{
TimeSpaninterval=DateTime.Now-DateTime.Now.Date;
stringmsg=String.Format("ElapsedTimeToday:{0:d}hours.",
interval);
Console.WriteLine(msg);
}
}
//Theexampledisplaysthefollowingoutput:
//ElapsedTimeToday:01:40:52.2524662hours.
ModuleExample
PublicSubMain()
DimintervalAsTimeSpan=Date.Now-Date.Now.Date
DimmsgAsString=String.Format("ElapsedTimeToday:{0:d}hours.",
interval)
Console.WriteLine(msg)
EndSub
EndModule
'Theexampledisplaysoutputlikethefollowing:
'ElapsedTimeToday:01:40:52.2524662hours.
建構函式
TimeSpan(Int32,Int32,Int32)
將TimeSpan結構的新執行個體初始化為指定的時數、分鐘數和秒數。
TimeSpan(Int32,Int32,Int32,Int32)
將TimeSpan結構的新執行個體初始化為指定的天數、時數、分鐘數和秒數。
TimeSpan(Int32,Int32,Int32,Int32,Int32)
將TimeSpan結構的新執行個體初始化為指定的天數、時數、分鐘數、秒數和毫秒數。
TimeSpan(Int64)
將TimeSpan結構的新執行個體初始化為刻度的指定數目。
欄位
MaxValue
代表最大TimeSpan值。
此欄位為唯讀。
MinValue
代表最小TimeSpan值。
此欄位為唯讀。
TicksPerDay
表示1天中的刻度數。
這個欄位為常數。
TicksPerHour
表示1小時中的刻度數。
這個欄位為常數。
TicksPerMillisecond
表示1毫秒中的刻度數。
這個欄位為常數。
TicksPerMinute
表示1分鐘中的刻度數。
這個欄位為常數。
TicksPerSecond
表示1秒中的刻度數。
Zero
代表零TimeSpan值。
此欄位為唯讀。
屬性
Days
取得目前TimeSpan結構所表示之時間間隔的天數元件。
Hours
取得目前TimeSpan結構所表示之時間間隔的時數元件。
Milliseconds
取得目前TimeSpan結構所表示之時間間隔的毫秒數元件。
Minutes
取得目前TimeSpan結構所表示之時間間隔的分鐘數元件。
Seconds
取得目前TimeSpan結構所表示之時間間隔的秒數元件。
Ticks
取得刻度數,表示目前TimeSpan結構的值。
TotalDays
取得目前TimeSpan結構的值,這個值以整數和小數的天數表示。
TotalHours
取得目前TimeSpan結構的值,這個值以整數和小數的時數表示。
TotalMilliseconds
取得目前TimeSpan結構的值,這個值以整數和小數的毫秒數表示。
TotalMinutes
取得目前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,其規格的精確度達到最接近的毫秒數。
FromMilliseconds(Double)
傳回表示指定毫秒數的TimeSpan。
FromMinutes(Double)
傳回表示指定分鐘數的TimeSpan,其規格的精確度達到最接近的毫秒數。
FromSeconds(Double)
傳回表示指定秒數的TimeSpan,其規格的精確度達到最接近的毫秒數。
FromTicks(Int64)
傳回表示指定時間的TimeSpan,其規格是以刻度為單位。
GetHashCode()
傳回這個執行個體的雜湊碼。
Multiply(Double)
傳回新的TimeSpan物件,其值是此執行個體與指定factor相乘後的結果。
Negate()
傳回新TimeSpan物件,其值是這個執行個體的相反值。
Parse(ReadOnlySpan
Parse(String)
將時間間隔的字串表示,轉換成與其相等的TimeSpan。
Parse(String,IFormatProvider)
使用指定的特定文化特性格式資訊,將時間間隔的字串表示轉換為其相等的TimeSpan。
ParseExact(ReadOnlySpan
字串表示的格式必須完全符合指定的格式。
ParseExact(ReadOnlySpan
字串表示的格式必須完全符合其中一個指定的格式。
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
TryParse(ReadOnlySpan
TryParse(ReadOnlySpan
TryParse(String,IFormatProvider,TimeSpan)
使用指定的特定文件特性格式資訊,將時間間隔的字串表示轉換為其相等的TimeSpan,並傳回表示轉換是否成功的值。
TryParse(String,TimeSpan)
將時間間隔的字串表示,轉換為其相等的TimeSpan,並傳回一個值表示轉換是否成功。
TryParseExact(ReadOnlySpan
字串表示的格式必須完全符合指定的格式。
TryParseExact(ReadOnlySpan
字串表示的格式必須完全符合指定的格式。
TryParseExact(ReadOnlySpan
字串表示的格式必須完全符合其中一個指定的格式。
TryParseExact(ReadOnlySpan
字串表示的格式必須完全符合其中一個指定的格式。
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值,其為t1執行個體與指定t2相除後的結果。
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的指定執行個體。
明確介面實作
IComparable.CompareTo(Object)
比較這個執行個體和指定的物件,並傳回一個整數,表示這個執行個體短於、等於或長於指定的物件。
適用於
另請參閱
DateTime
DateTimeOffset
Calendar
本文內容
延伸文章資訊
- 1TimeSpan 結構(System) | Microsoft Docs
下列範例會具現化TimeSpan 表示兩個日期之間差異的物件。 然後,它會顯示TimeSpan 物件的屬性。 C# 複製.
- 2C# TimeSpan 計算時間差(時間間隔) - 自由手記
TimeSpan 結構表示一個時間間隔。 命名空間:System 程式集:mscorlib(在mscorlib.dll 中) 說明: 1.DateTime數值型別代表了一個從西元0.
- 3C#常用類(三) DateTime與TimeSpan類 - 台部落
參考或轉載至:MSDN、C#中比較常用的DateTime結構的使用方法、C#的TimeSpan介紹1 DateTime 常見用法1.1DateTime常見屬性序號屬性名解釋1 Now 獲取 ...
- 4自訂TimeSpan 格式字串
下列範例說明如何使用"d" 自訂格式規範。 C# 複製. TimeSpan ts2 = new TimeSpan ...
- 5[轉載]C# TimeSpan 計算時間差(時間間隔) - IT閱讀
[轉載]C# TimeSpan 計算時間差(時間間隔). 2019-01-16 254. 形式string 當前bubuko 閏年tro 常用時間日期列表. TimeSpan 結構表示一個時間間隔。