DateAndTime.DateAdd Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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 -> DateTimePublic Function DateAdd (Interval As DateInterval, Number As Double, DateValue As DateTime) As DateTimeParameter
- 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
- DateDiff
- DatePart
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- Ringkasan Tipe Data (Visual Basic)
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 -> DateTimePublic Function DateAdd (Interval As String, Number As Double, DateValue As Object) As DateTimeParameter
- 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
- DateDiff
- DatePart
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- Ringkasan Tipe Data (Visual Basic)
