Baca dalam bahasa Inggris

Bagikan melalui


DateTime.AddSeconds(Double) Metode

Definisi

Mengembalikan baru DateTime yang menambahkan jumlah detik yang ditentukan ke nilai instans ini.

public DateTime AddSeconds(double value);

Parameter

value
Double

Sejumlah detik utuh dan pecahan. Parameternya value bisa negatif atau positif.

Mengembalikan

Objek yang nilainya adalah jumlah tanggal dan waktu yang diwakili oleh instans ini dan jumlah detik yang diwakili oleh value.

Pengecualian

DateTime Hasilnya kurang dari DateTime.MinValue atau lebih besar dari DateTime.MaxValue.

Contoh

Contoh berikut menggunakan AddSeconds metode untuk menambahkan 30 detik dan jumlah detik dalam satu hari ke DateTime nilai. Kemudian menampilkan setiap nilai baru dan menampilkan perbedaan antara nilai tersebut dan nilai aslinya. Perbedaan ditampilkan baik sebagai rentang waktu maupun sebagai sejumlah kutu.

using System;

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

      DateTime date2 = date1.AddSeconds(30);
      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);

      // Add 1 day's worth of seconds (60 secs. * 60 mins * 24 hrs.
      DateTime date3 = date1.AddSeconds(60 * 60 * 24);
      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/2014 04:00:00 (635,457,888,000,000,000 ticks)
//
//    Second date:   09/08/2014 04:00:30 (635,457,888,300,000,000 ticks)
//    Difference between dates: 00:00:30 (300,000,000 ticks)
//
//    Third date:    09/09/2014 04:00:00 (635,458,752,000,000,000 ticks)
//    Difference between dates: 1.00:00:00 (864,000,000,000 ticks)

Keterangan

Metode ini tidak mengubah nilai ini DateTime. Sebaliknya, ia mengembalikan yang baru DateTime yang nilainya adalah hasil dari operasi ini.

Bagian pecahan adalah value bagian pecahan dari detik. Misalnya, 4,5 setara dengan 4 detik, 500 milidetik, dan 0 kutu.

Dalam .NET 6 dan versi yang lebih lama, parameter dibulatkan value ke milidetik terdekat. Di .NET 7 dan versi yang lebih baru, presisi value penuh Double parameter digunakan. Namun, karena impresi matematika floating point yang melekat, presisi yang dihasilkan akan bervariasi.

Berlaku untuk

Produk Versi
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Lihat juga