情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

DateTime.AddMilliseconds メソッド

2013/12/12

このインスタンスの値に、指定されたミリ秒数を加算した新しい DateTime を返します。

Namespace:  System
アセンブリ:  mscorlib (mscorlib.dll 内)

public DateTime AddMilliseconds(
	double value
)

パラメーター

value
型: System.Double
加算するミリ秒数。整数部と小数部から構成されます。この値は、正の場合もあれば負の場合もあります。この値は、近似値の整数に丸められます。

戻り値

型: System.DateTime
このインスタンスで表された日時に value で表されたミリ秒数を加算した値を示すオブジェクト。

例外条件
ArgumentOutOfRangeException

結果の DateTimeDateTime.MinValue より前か DateTime.MaxValue より後になっています。

このメソッドは、DateTime の値を変更しません。代わりに、この操作の結果を示す値を持つ新しい DateTime が返されます。

value の小数部は 1 ミリ秒の端数です。たとえば、4.5 は 4 ミリ秒と 5000 タイマー刻み (1 ミリ秒 = 10000 タイマー刻み) に相当します。

value パラメーターは、近似値の整数に丸められます。

次の例では、AddMilliseconds メソッドを使用して、DateTime に 1 ミリ秒と 1.5 ミリ秒を加算します。次に、それぞれの新しい値を表示し、元の値との差を表示します。差は、期間とタイマー刻み数の両方で表示されます。この例で、1 ミリ秒と 10,000 タイマー刻みが等しいことがよくわかります。また、ミリ秒の小数部は加算前に丸められるため、元の日付に 1.5 ミリ秒を加算した結果として得られる DateTime 値が元の日付より 2 ミリ秒大きいことも示します。


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

DateTime date2 = date1.AddMilliseconds(1);
outputBlock.Text += String.Format("Second date:   {0} ({1:N0} ticks)",
                  date2.ToString(dateFormat), date2.Ticks) + Environment.NewLine;
outputBlock.Text += String.Format("Difference between dates: {0} ({1:N0} ticks)\n",
                  date2 - date1, date2.Ticks - date1.Ticks) + Environment.NewLine;                        

DateTime date3 = date1.AddMilliseconds(1.5);
outputBlock.Text += String.Format("Third date:    {0} ({1:N0} ticks)",
                  date3.ToString(dateFormat), date3.Ticks) + Environment.NewLine;
outputBlock.Text += String.Format("Difference between dates: {0} ({1:N0} ticks)",
                  date3 - date1, date3.Ticks - date1.Ticks) + Environment.NewLine;                        
// 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)      


Windows Phone OS

サポート: 8.0, 7.1, 7.0

表示: