DateTime.AddMilliseconds(Double) Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

DateTime.cs

Belirtilen sayıda milisaniyeyi bu örneğin değerine ekleyen yeni DateTime bir değer döndürür.

public:
 DateTime AddMilliseconds(double value);

public DateTime AddMilliseconds(double value);

member this.AddMilliseconds : double -> DateTime

Public Function AddMilliseconds (value As Double) As DateTime

Parametreler

value

Double

Bir dizi tam ve kesirli milisaniye. value Parametre negatif veya pozitif olabilir. Bu değerin en yakın tamsayıya yuvarlandığını unutmayın.

Döndürülenler

DateTime

Değeri, bu örnekle temsil edilen tarih ve saatin toplamı ve tarafından valuetemsil edilen milisaniye sayısı olan bir nesne.

Özel durumlar

ArgumentOutOfRangeException

DateTime Sonuç DateTime.MinValue değerinden küçük veya DateTime.MaxValue değerinden büyük.

Örnekler

Aşağıdaki örnek, bir değere bir milisaniye ve 1,5 milisaniye eklemek için DateTime yöntemini kullanırAddMilliseconds. Ardından her yeni değeri görüntüler ve özgün değerle arasındaki farkı görüntüler. Fark hem zaman aralığı olarak hem de bir dizi onay işareti olarak görüntülenir. Örnek, bir milisaniyenin 10.000 değer çizgisine eşit olduğunu açıkça gösterir. Ayrıca toplama işlemi gerçekleştirilmeden önce kesirli milisaniyelerin yuvarlandığını gösterir; özgün tarihe DateTime 1,5 milisaniye eklenerek elde edilen değer, özgün tarihten 2 milisaniye daha büyüktür.

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)

let dateFormat = "MM/dd/yyyy hh:mm:ss.fffffff"
let date1 = DateTime(2010, 9, 8, 16, 0, 0)
printfn $"Original date: {date1.ToString dateFormat} ({date1.Ticks:N0} ticks)\n"

let date2 = date1.AddMilliseconds 1
printfn $"Second date:   {date2.ToString dateFormat} ({date2.Ticks:N0} ticks)"
printfn $"Difference between dates: {date2 - date1} ({date2.Ticks - date1.Ticks:N0} ticks)\n"

let date3 = date1.AddMilliseconds 1.5
printfn $"Third date:    {date3.ToString dateFormat} ({date3.Ticks:N0} ticks)"
printfn $"Difference between dates: {date3 - date1} ({date3.Ticks - date1.Ticks:N0} 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)

Açıklamalar

Bu yöntem bu DateTimedeğerini değiştirmez. Bunun yerine, değeri bu işlemin sonucu olan yeni DateTime bir döndürür.

kesirli bölümü value , milisaniyenin kesirli kısmıdır. Örneğin 4,5, 4 milisaniye ve 5000 değere eşdeğerdir; burada bir milisaniye = 10000 değer işareti vardır.

.NET Framework'te value parametresi en yakın milisaniyeye yuvarlanmıştır. .NET 7 ve sonraki sürümlerde parametresinin Double tam value duyarlığı kullanılır. Ancak kayan nokta matematiğin doğası gereği kesinlik nedeniyle elde edilen duyarlık farklılık gösterir.

Ayrıca bkz.

• Double
• Tarih ve Saatlerle Aritmetik İşlemler Gerçekleştirme