Bagikan melalui


DateAndTime.DateAdd Metode

Definisi

Mengembalikan nilai yang Date berisi nilai tanggal dan waktu di mana interval waktu tertentu telah ditambahkan.

Overload

DateAdd(DateInterval, Double, DateTime)

Mengembalikan nilai yang berisi nilai tanggal dan waktu di mana interval waktu tertentu telah ditambahkan.

DateAdd(String, Double, Object)

Mengembalikan nilai yang berisi nilai tanggal dan waktu di mana interval waktu tertentu telah ditambahkan.

DateAdd(DateInterval, Double, DateTime)

Sumber:
DateAndTime.vb
Sumber:
DateAndTime.vb
Sumber:
DateAndTime.vb

Mengembalikan nilai yang berisi nilai tanggal dan waktu di mana interval waktu tertentu telah ditambahkan.

public:
 static DateTime DateAdd(Microsoft::VisualBasic::DateInterval Interval, double Number, DateTime DateValue);
public static DateTime DateAdd (Microsoft.VisualBasic.DateInterval Interval, double Number, DateTime DateValue);
static member DateAdd : Microsoft.VisualBasic.DateInterval * double * DateTime -> DateTime
Public Function DateAdd (Interval As DateInterval, Number As Double, DateValue As DateTime) As DateTime

Parameter

Interval
DateInterval

Wajib diisi. Nilai DateInterval enumerasi atau ekspresi string yang mewakili interval waktu yang ingin Anda tambahkan.

Number
Double

Wajib diisi. Ekspresi floating-point yang menunjukkan jumlah interval yang ingin Anda tambahkan. Ini bisa positif (untuk mendapatkan nilai tanggal/waktu di masa mendatang) atau negatif (untuk mendapatkan nilai tanggal/waktu di masa lalu). Ini dapat berisi bagian pecahan ketika Interval menentukan jam, menit, atau detik. Untuk nilai lain , Intervalbagian pecahan Number apa pun diabaikan.

DateValue
DateTime

Wajib diisi. Ekspresi yang mewakili tanggal dan waktu untuk menambahkan interval. DateValue itu sendiri tidak diubah dalam program panggilan.

Mengembalikan

Nilai yang berisi nilai tanggal dan waktu di mana interval waktu tertentu telah ditambahkan.

Pengecualian

DateValue tidak dapat dipaksa untuk Date.

Interval tidak valid.

Tanggal terhitung adalah sebelum pukul 00:00:00 pada 1 Januari tahun 1, atau lebih lambat dari 23:59:59 pada 31 Desember 9999.

Contoh

Contoh ini mengambil tanggal dan, menggunakan DateAdd fungsi , menampilkan tanggal yang sesuai dengan jumlah bulan tertentu di masa mendatang.

Dim dateEntered As String =
InputBox("Enter a date", DefaultResponse:=Date.Now.ToShortDateString)
Dim monthsEntered As String =
InputBox("Enter number of months to add", DefaultResponse:="12")

Dim dateValue As Date = Date.Parse(dateEntered)
Dim monthsValue As Integer = Integer.Parse(monthsEntered)

' Add the months to the date.
Dim newDate As Date = DateAdd(DateInterval.Month, monthsValue, dateValue)

' This statement has a string interval argument, and
' is equivalent to the above statement.
'Dim newDate As Date = DateAdd("m", monthsValue, dateValue)

MessageBox.Show("New date: " & newDate.ToShortDateString)

Keterangan

Anda dapat menggunakan DateAdd fungsi untuk menambahkan atau mengurangi interval waktu tertentu dari tanggal. Misalnya, Anda dapat menghitung tanggal 30 hari dari hari ini atau waktu 45 menit sebelum sekarang.

Untuk menambahkan hari ke DateValue, Anda dapat menggunakan DateInterval.Day, , DateInterval.DayOfYearatau DateInterval.Weekday. Ini diperlakukan setara karena DayOfYear dan Weekday bukan interval waktu yang bermakna.

Fungsi DateAdd tidak pernah mengembalikan tanggal yang tidak valid. Jika perlu, bagian hari dari tanggal yang dihasilkan disesuaikan ke bawah ke hari terakhir dari bulan yang dihasilkan dalam tahun yang dihasilkan. Contoh berikut menambahkan satu bulan ke 31 Januari:

Dim NextMonth As Date = DateAdd(DateInterval.Month, 1, #1/31/1995#)  

Dalam contoh ini, DateAdd mengembalikan #2/28/1995#, bukan #2/31/1995#. Jika DateValue adalah #1/31/1996#, itu kembali #2/29/1996# karena 1996 adalah tahun kampung.

Catatan

DateAdd menggunakan pengaturan kalender saat ini dari CurrentCulture properti CultureInfo kelas di System.Globalization namespace. Nilai default CurrentCulture ditentukan oleh pengaturan Panel Kontrol.

Karena setiap Date nilai didukung oleh DateTime struktur, metodenya memberi Anda opsi tambahan dalam menambahkan interval waktu. Misalnya, Anda dapat menambahkan jumlah hari pecahan, dibulatkan ke milidetik terdekat, ke Date variabel sebagai berikut:

Dim NextTime As Date = Now        ' Current date and time.  
NextTime = NextTime.AddDays(3.4)  ' Increment by 3 2/5 days.  

Argumen Interval dapat memiliki salah satu pengaturan berikut.

Nilai enumerasi String Satuan interval waktu untuk ditambahkan
DateInterval.Day d Hari; dipotok menjadi nilai integral
DateInterval.DayOfYear y Hari; dipotok menjadi nilai integral
DateInterval.Hour h Jam; dibulatkan ke milidetik terdekat
DateInterval.Minute n Menit; dibulatkan ke milidetik terdekat
DateInterval.Month m Bulan; dipotok menjadi nilai integral
DateInterval.Quarter q Kuartal; dipotok menjadi nilai integral
DateInterval.Second s Kedua; dibulatkan ke milidetik terdekat
DateInterval.Weekday w Hari; dipotok menjadi nilai integral
DateInterval.WeekOfYear ww Minggu; dipotok menjadi nilai integral
DateInterval.Year yyyy Tahun; dipotok menjadi nilai integral

Lihat juga

Berlaku untuk

DateAdd(String, Double, Object)

Sumber:
DateAndTime.vb
Sumber:
DateAndTime.vb
Sumber:
DateAndTime.vb

Mengembalikan nilai yang berisi nilai tanggal dan waktu di mana interval waktu tertentu telah ditambahkan.

public:
 static DateTime DateAdd(System::String ^ Interval, double Number, System::Object ^ DateValue);
public static DateTime DateAdd (string Interval, double Number, object? DateValue);
public static DateTime DateAdd (string Interval, double Number, object DateValue);
static member DateAdd : string * double * obj -> DateTime
Public Function DateAdd (Interval As String, Number As Double, DateValue As Object) As DateTime

Parameter

Interval
String

Wajib diisi. Nilai DateInterval enumerasi atau ekspresi string yang mewakili interval waktu yang ingin Anda tambahkan.

Number
Double

Wajib diisi. Ekspresi floating-point yang menunjukkan jumlah interval yang ingin Anda tambahkan. Number bisa positif (untuk mendapatkan nilai tanggal/waktu di masa mendatang) atau negatif (untuk mendapatkan nilai tanggal/waktu di masa lalu). Ini dapat berisi bagian pecahan ketika Interval menentukan jam, menit, atau detik. Untuk nilai lain , Intervalbagian pecahan Number apa pun diabaikan.

DateValue
Object

Wajib diisi. Ekspresi yang mewakili tanggal dan waktu untuk menambahkan interval. DateValue itu sendiri tidak diubah dalam program panggilan.

Mengembalikan

Nilai yang berisi nilai tanggal dan waktu di mana interval waktu tertentu telah ditambahkan.

Pengecualian

DateValue tidak dapat dipaksa untuk Date.

Interval tidak valid.

Tanggal terhitung adalah sebelum pukul 00:00:00 pada 1 Januari tahun 1, atau lebih lambat dari 23:59:59 pada 31 Desember 9999.

Contoh

Contoh ini mengambil tanggal dan, menggunakan DateAdd fungsi , menampilkan tanggal yang sesuai dengan jumlah bulan tertentu di masa mendatang.

Dim dateEntered As String =
InputBox("Enter a date", DefaultResponse:=Date.Now.ToShortDateString)
Dim monthsEntered As String =
InputBox("Enter number of months to add", DefaultResponse:="12")

Dim dateValue As Date = Date.Parse(dateEntered)
Dim monthsValue As Integer = Integer.Parse(monthsEntered)

' Add the months to the date.
Dim newDate As Date = DateAdd(DateInterval.Month, monthsValue, dateValue)

' This statement has a string interval argument, and
' is equivalent to the above statement.
'Dim newDate As Date = DateAdd("m", monthsValue, dateValue)

MessageBox.Show("New date: " & newDate.ToShortDateString)

Keterangan

Anda dapat menggunakan DateAdd fungsi untuk menambahkan atau mengurangi interval waktu tertentu dari tanggal. Misalnya, Anda dapat menghitung tanggal 30 hari dari hari ini atau waktu 45 menit sebelum sekarang.

Untuk menambahkan hari ke DateValue, Anda dapat menggunakan DateInterval.Day, , DateInterval.DayOfYearatau DateInterval.Weekday. Ini diperlakukan setara karena DayOfYear dan Weekday bukan interval waktu yang bermakna.

Fungsi DateAdd tidak pernah mengembalikan tanggal yang tidak valid. Jika perlu, bagian hari dari tanggal yang dihasilkan disesuaikan ke bawah ke hari terakhir dari bulan yang dihasilkan dalam tahun yang dihasilkan. Contoh berikut menambahkan satu bulan ke 31 Januari:

Dim NextMonth As Date = DateAdd(DateInterval.Month, 1, #1/31/1995#)  

Dalam contoh ini, DateAdd mengembalikan #2/28/1995#, bukan #2/31/1995#. Jika DateValue adalah #1/31/1996#, itu kembali #2/29/1996# karena 1996 adalah tahun kampung.

Catatan

DateAdd menggunakan pengaturan kalender saat ini dari CurrentCulture properti CultureInfo kelas di System.Globalization namespace. Nilai default CurrentCulture ditentukan oleh pengaturan Panel Kontrol.

Karena setiap Date nilai didukung oleh DateTime struktur, metodenya memberi Anda opsi tambahan dalam menambahkan interval waktu. Misalnya, Anda dapat menambahkan jumlah hari pecahan, dibulatkan ke milidetik terdekat, ke Date variabel sebagai berikut:

Dim NextTime As Date = Now        ' Current date and time.  
NextTime = NextTime.AddDays(3.4)  ' Increment by 3 2/5 days.  

Argumen Interval dapat memiliki salah satu pengaturan berikut.

Nilai enumerasi String Satuan interval waktu untuk ditambahkan
DateInterval.Day d Hari; dipotok menjadi nilai integral
DateInterval.DayOfYear y Hari; dipotok menjadi nilai integral
DateInterval.Hour h Jam; dibulatkan ke milidetik terdekat
DateInterval.Minute n Menit; dibulatkan ke milidetik terdekat
DateInterval.Month m Bulan; dipotok menjadi nilai integral
DateInterval.Quarter q Kuartal; dipotok menjadi nilai integral
DateInterval.Second s Kedua; dibulatkan ke milidetik terdekat
DateInterval.Weekday w Hari; dipotok menjadi nilai integral
DateInterval.WeekOfYear ww Minggu; dipotok menjadi nilai integral
DateInterval.Year yyyy Tahun; dipotok menjadi nilai integral

Lihat juga

Berlaku untuk