DateTime.AddMilliseconds(Double) メソッド

定義

このインスタンスの値に、指定されたミリ秒数を加算した新しい DateTime を返します。Returns a new DateTime that adds the specified number of milliseconds to the value of this instance.

public:
 DateTime AddMilliseconds(double value);
public DateTime AddMilliseconds (double value);
member this.AddMilliseconds : double -> DateTime
Public Function AddMilliseconds (value As Double) As DateTime

パラメーター

value
Double

整数部と小数部から成るミリ秒数。A number of whole and fractional milliseconds. value パラメーターは、正または負のどちらの場合もあります。The value parameter can be negative or positive. この値は、近似値の整数に丸められます。Note that this value is rounded to the nearest integer.

戻り値

このインスタンスで表された日付と時刻に value で表されたミリ秒数を加算した値を保持するオブジェクト。An object whose value is the sum of the date and time represented by this instance and the number of milliseconds represented by value.

例外

結果として返された DateTimeMinValue より小さいか、MaxValue より大きいです。The resulting DateTime is less than MinValue or greater than MaxValue.

次の例では、AddMilliseconds メソッドを使用して、1ミリ秒と1.5 ミリ秒を DateTime の値に加算します。The following example uses the AddMilliseconds method to add one millisecond and 1.5 milliseconds to a DateTime value. その後、それぞれの新しい値が表示され、その値と元の値の差が表示されます。It then displays each new value and displays the difference between it and the original value. 差は、時間間隔とタイマー刻みの数の両方として表示されます。The difference is displayed both as a time span and as a number of ticks. この例では、1ミリ秒が1万ティックに等しいことが明確になります。The example makes it clear that one millisecond equals 10,000 ticks. また、加算を実行する前に小数部のミリ秒が丸められることも示しています。元の日付に1.5 ミリ秒を加算した結果として得られる DateTime の値は、元の日付より2ミリ秒を超える値です。It also shows that fractional milliseconds are rounded before performing the addition; the DateTime value that results from adding 1.5 milliseconds to the original date is 2 milliseconds greater than the original date.

string dateFormat = "MM/dd/yyyy hh:mm:ss.fffffff"; 
DateTime date1 = new DateTime(2010, 9, 8, 16, 0, 0);
Console.WriteLine("Original date: {0} ({1:N0} ticks)\n",
                  date1.ToString(dateFormat), date1.Ticks);

DateTime date2 = date1.AddMilliseconds(1);
Console.WriteLine("Second date:   {0} ({1:N0} ticks)",
                  date2.ToString(dateFormat), date2.Ticks);
Console.WriteLine("Difference between dates: {0} ({1:N0} ticks)\n",
                  date2 - date1, date2.Ticks - date1.Ticks);                        

DateTime date3 = date1.AddMilliseconds(1.5);
Console.WriteLine("Third date:    {0} ({1:N0} ticks)",
                  date3.ToString(dateFormat), date3.Ticks);
Console.WriteLine("Difference between dates: {0} ({1:N0} ticks)",
                  date3 - date1, date3.Ticks - date1.Ticks);                        
// The example displays the following output:
//    Original date: 09/08/2010 04:00:00.0000000 (634,195,584,000,000,000 ticks)
//    
//    Second date:   09/08/2010 04:00:00.0010000 (634,195,584,000,010,000 ticks)
//    Difference between dates: 00:00:00.0010000 (10,000 ticks)
//    
//    Third date:    09/08/2010 04:00:00.0020000 (634,195,584,000,020,000 ticks)
//    Difference between dates: 00:00:00.0020000 (20,000 ticks)      
Dim dateFormat As String = "MM/dd/yyyy hh:mm:ss.fffffff" 
Dim date1 As Date = #09/08/2010 16:00#
Console.WriteLine("Original date: {0} ({1:N0} ticks)", _
                  date1.ToString(dateFormat), date1.Ticks)
Console.WriteLine()

Dim date2 As Date = date1.AddMilliseconds(1)
Console.WriteLine("Second date:   {0} ({1:N0} ticks)", _
                  date2.ToString(dateFormat), date2.Ticks)
Console.WriteLine("Difference between dates: {0} ({1:N0} ticks)", _
                  date2 - date1, date2.Ticks - date1.Ticks)                        
Console.WriteLine()

Dim date3 As Date = date1.AddMilliseconds(1.5)
Console.WriteLine("Third date:    {0} ({1:N0} ticks)", _
                  date3.ToString(dateFormat), date3.Ticks)
Console.WriteLine("Difference between dates: {0} ({1:N0} ticks)", _
                  date3 - date1, date3.Ticks - date1.Ticks)                        
' The example displays the following output:
'    Original date: 09/08/2010 04:00:00.0000000 (634,195,584,000,000,000 ticks)
'    
'    Second date:   09/08/2010 04:00:00.0010000 (634,195,584,000,010,000 ticks)
'    Difference between dates: 00:00:00.0010000 (10,000 ticks)
'    
'    Third date:    09/08/2010 04:00:00.0020000 (634,195,584,000,020,000 ticks)
'    Difference between dates: 00:00:00.0020000 (20,000 ticks)      

注釈

このメソッドでは、この @no__t の値は0に変更されません。This method does not change the value of this DateTime. 代わりに、この操作の結果を値とする新しい @no__t 0 を返します。Instead, it returns a new DateTime whose value is the result of this operation.

@No__t-0 の小数部分は、ミリ秒の小数部です。The fractional part of value is the fractional part of a millisecond. たとえば、4.5 は、4ミリ秒と5000ティックに相当します。ここで、1ミリ秒 = 1万ティックです。For example, 4.5 is equivalent to 4 milliseconds and 5000 ticks, where one millisecond = 10000 ticks.

@No__t-0 パラメーターは、最も近い整数に丸められます。The value parameter is rounded to the nearest integer.

適用対象

こちらもご覧ください