DateTime.AddMilliseconds(Double) Metoda

Definicja

Przestrzeń nazw:

System

Zestawy:

netstandard.dll, System.Runtime.dll

Źródło:

DateTime.cs

Zwraca nowy DateTime element, który dodaje określoną liczbę milisekund do wartości tego wystąpienia.

C#

public DateTime AddMilliseconds(double value);

Parametry

value

Double

Liczba milisekund całkowitych i ułamkowych. Parametr value może być ujemny lub dodatni. Pamiętaj, że ta wartość jest zaokrąglona do najbliższej liczby całkowitej.

Zwraca

DateTime

Obiekt, którego wartość jest sumą daty i godziny reprezentowanej przez to wystąpienie oraz liczbę milisekund reprezentowanych przez value.

Wyjątki

ArgumentOutOfRangeException

DateTime Wynik jest mniejszy niż DateTime.MinValue lub większy niż DateTime.MaxValue.

Przykłady

W poniższym przykładzie użyto AddMilliseconds metody , aby dodać do wartości jedną milisekundę DateTime i 1,5 milisekund. Następnie wyświetla każdą nową wartość i wyświetla różnicę między nią a oryginalną wartością. Różnica jest wyświetlana zarówno jako przedział czasu, jak i jako liczba kleszczy. W przykładzie widać, że jeden milisekunda to 10 000 taktów. Pokazuje również, że ułamkowe milisekundy są zaokrąglane przed wykonaniem dodawania; DateTime wartość, która wynika z dodania wartości 1,5 milisekund do oryginalnej daty, wynosi 2 milisekundy większe niż oryginalna data.

C#

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)

Uwagi

Ta metoda nie zmienia wartości tego DateTimeelementu . Zamiast tego zwraca nową DateTime wartość, której wartość jest wynikiem tej operacji.

Część ułamkowa value elementu jest częścią ułamkową milisekundy. Na przykład 4,5 odpowiada 4 milisekundom i 5000 kleszczom, gdzie jeden milisekund = 10000 kleszczy.

W programie .NET 6 i starszych wersjach value parametr jest zaokrąglany do najbliższej milisekundy. W programie .NET 7 i nowszych wersjach jest używana pełna Double precyzja parametru value . Jednak ze względu na nieodłączną nieprawdopodobność matematycznych zmiennoprzecinkowych precyzja wynikowa będzie się różnić.

Dotyczy

Zobacz też

• Double
• Wykonywanie operacji arytmetycznych przy użyciu dat i godzin