DateTime.AddMilliseconds(Double) DateTime.AddMilliseconds(Double) DateTime.AddMilliseconds(Double) DateTime.AddMilliseconds(Double) Method

정의

지정된 밀리초 수를 이 인스턴스의 값에 더하는 새 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 Double Double 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.

예외

예제

다음 예제에서는 합니다 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. 예제에서는 밀리초 equals 10, 000 틱 하나 명확 하 게 합니다.The example makes it clear that one millisecond equals 10,000 ticks. 또한; 추가 수행 하기 전에 반올림 되는 소수 자릿수 밀리초 표시 DateTime 원래 날짜에 1.5 시간 (밀리초)을 더한 결과로 생성 되는 값은 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)      

설명

이 메서드는이 값을 변경 하지 않습니다 DateTime합니다.This method does not change the value of this DateTime. 대신에 새 반환 DateTime 값인이 연산의 결과입니다.Instead, it returns a new DateTime whose value is the result of this operation.

소수 부분 value 밀리초의 소수 부분입니다.The fractional part of value is the fractional part of a millisecond. 예를 들어 4.5는 4 시간 (밀리초) 5000 틱을 밀리초 단위로 나타냅니다.For example, 4.5 is equivalent to 4 milliseconds and 5000 ticks, where one millisecond = 10000 ticks.

value 매개 변수는 가장 가까운 정수로 반올림 됩니다.The value parameter is rounded to the nearest integer.

적용 대상

추가 정보