DateTimeOffset.AddMilliseconds(Double) 方法

定義

命名空間:

System

組件:

System.Runtime.dll

Source:

DateTimeOffset.cs

傳回新的 DateTimeOffset 物件，將這個執行個體的值加上指定的毫秒數。

public:
 DateTimeOffset AddMilliseconds(double milliseconds);

public DateTimeOffset AddMilliseconds (double milliseconds);

member this.AddMilliseconds : double -> DateTimeOffset

Public Function AddMilliseconds (milliseconds As Double) As DateTimeOffset

參數

milliseconds

Double

整數和小數的毫秒數。 可以是負數或正數。

傳回

DateTimeOffset

物件，其值為目前 DateTimeOffset 物件所表示之日期和時間加上 milliseconds 所表示之整數毫秒數的總和。

例外狀況

ArgumentOutOfRangeException

產生的 DateTimeOffset 值小於 DateTimeOffset.MinValue。

-或-

產生的 DateTimeOffset 值大於 DateTimeOffset.MaxValue。

備註

參數的小 milliseconds 數部分是毫秒的小數部分。 例如，4.5 相當於 4 毫秒和 5000 個刻度，其中一毫秒等於 10，000 個刻度。 不過，在 .NET 6 和舊版中， milliseconds 會四捨五入為最接近的毫秒，而 .5 或更新版本的所有值都會四捨五入。 在 .NET 7 和更新版本中，會使用 參數的完整 Double 精確度 milliseconds 。 不過，由於浮點數學的固有不精確，因此產生的精確度會有所不同。

注意

這個方法會傳回新的 DateTimeOffset 物件。 它不會藉由將 新增 milliseconds 至物件的日期和時間來修改目前物件的值。

DateTimeOffset因為 物件不代表特定時區中的日期和時間， AddMilliseconds 所以此方法在執行日期和時間算術時，不會考慮特定時區的調整規則。

另請參閱

• 使用日期和時間執行算數運算