DateAndTime.DateAdd Yöntem

Tanım

Ad Alanı:

Microsoft.VisualBasic

Bütünleştirilmiş Kod:

Microsoft.VisualBasic.Core.dll

Belirtilen zaman Date aralığının eklendiği tarih ve saat değerini içeren bir değer döndürür.

Aşırı Yüklemeler

Name	Description
DateAdd(DateInterval, Double, DateTime)	Belirtilen zaman aralığının eklendiği tarih ve saat değerini içeren bir değer döndürür.
DateAdd(String, Double, Object)	Belirtilen zaman aralığının eklendiği tarih ve saat değerini içeren bir değer döndürür.

DateAdd(DateInterval, Double, DateTime)

Kaynak:

DateAndTime.vb

Belirtilen zaman aralığının eklendiği tarih ve saat değerini içeren bir değer döndürür.

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

Parametreler

Interval

DateInterval

Gerekli. DateInterval Eklemek istediğiniz zaman aralığını temsil eden bir numaralandırma değeri veya dize ifadesi.

Number

Double

Gerekli. Eklemek istediğiniz aralık sayısını temsil eden kayan nokta ifadesi. Pozitif (gelecekte tarih/saat değerlerini almak için) veya negatif (geçmişteki tarih/saat değerlerini almak için) olabilir. Saatler, dakikalar veya saniyeler belirtildiğinde Interval kesirli bir bölüm içerebilir. öğesinin Intervaldiğer değerleri için herhangi bir kesirli bölümü Number yoksayılır.

DateValue

DateTime

Gerekli. Aralığın eklendiği tarih ve saati temsil eden ifade. DateValue kendisini çağıran programda değiştirilmez.

Döndürülenler

DateTime

Belirtilen zaman aralığının eklendiği tarih ve saat değerini içeren bir değer.

Özel durumlar

InvalidCastException

DateValue , ile Datezorlanmıyor.

ArgumentException

Interval geçerli değil.

ArgumentOutOfRangeException

Hesaplanan tarih, 1 Yılın 1 Ocak günü 00:00:00'dan önce veya 31 Aralık 9999 tarihinde 23:59:59'dan sonradır.

Örnekler

Bu örnek bir tarih alır ve işlevini kullanarak DateAdd , gelecekte belirtilen sayıda ay için karşılık gelen bir tarih görüntüler.

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)

Açıklamalar

Belirtilen zaman aralığını bir tarihe eklemek veya çıkarmak için işlevini kullanabilirsiniz DateAdd . Örneğin, bugünden itibaren 30 gün veya bundan 45 dakika önce bir tarih hesaplayabilirsiniz.

öğesine gün eklemek için DateValue, DateInterval.DayOfYearveya DateInterval.WeekdaykullanabilirsinizDateInterval.Day. Bunlar, anlamlı zaman aralıkları olmadığından eşdeğer DayOfYearWeekday olarak değerlendirilir.

İşlev DateAdd hiçbir zaman geçersiz bir tarih döndürmez. Gerekirse, sonuçta elde edilen tarihin gün kısmı, sonuçta elde edilen yılın son gününe doğru aşağı doğru ayarlanır. Aşağıdaki örnek 31 Ocak'a bir ay ekler:

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

Bu örnekte , DateAdd değil #2/31/1995#döndürür#2/28/1995#. ise DateValue#1/31/1996#, 1996 artık yıl olduğundan döndürür #2/29/1996# .

Uyarı

DateAdd, ad alanında sınıfının System.Globalization özelliğinden CurrentCultureCultureInfo geçerli takvim ayarını kullanır. Varsayılan CurrentCulture değerler Denetim Masası ayarları tarafından belirlenir.

Her Date değer bir DateTime yapı tarafından desteklendiğinden, yöntemleri size zaman aralıkları eklemede ek seçenekler sağlar. Örneğin, bir değişkene en yakın milisaniyeye Date yuvarlanmış kesirli gün sayısını aşağıdaki gibi ekleyebilirsiniz:

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

Bağımsız Interval değişken aşağıdaki ayarlardan birine sahip olabilir.

Numaralandırma değeri	Dize	Eklenecek zaman aralığı birimi
DateInterval.Day	d	Gün; tamsayı değerine kesilmiş
DateInterval.DayOfYear	y	Gün; tamsayı değerine kesilmiş
DateInterval.Hour	h	Saat; en yakın milisaniyeye yuvarlanmış
DateInterval.Minute	n	Dakika; en yakın milisaniyeye yuvarlanmış
DateInterval.Month	m	Ay; tamsayı değerine kesilmiş
DateInterval.Quarter	q	Çeyrek; tamsayı değerine kesilmiş
DateInterval.Second	s	Ikinci; en yakın milisaniyeye yuvarlanmış
DateInterval.Weekday	w	Gün; tamsayı değerine kesilmiş
DateInterval.WeekOfYear	Ww	Hafta; tamsayı değerine kesilmiş
DateInterval.Year	yyyy	Yıl; tamsayı değerine kesilmiş

Ayrıca bkz.

• DateDiff
• DatePart
• Day(DateTime)
• Format(Object, String)
• Now
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• Veri Türü Özeti (Visual Basic)

DateAdd(String, Double, Object)

Kaynak:

DateAndTime.vb

Belirtilen zaman aralığının eklendiği tarih ve saat değerini içeren bir değer döndürür.

public:
 static DateTime DateAdd(System::String ^ Interval, double Number, System::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

Parametreler

Interval

String

Gerekli. DateInterval Eklemek istediğiniz zaman aralığını temsil eden bir numaralandırma değeri veya dize ifadesi.

Number

Double

Gerekli. Eklemek istediğiniz aralık sayısını temsil eden kayan nokta ifadesi. Number pozitif (gelecekte tarih/saat değerlerini almak için) veya negatif (geçmişteki tarih/saat değerlerini almak için) olabilir. Saatler, dakikalar veya saniyeler belirtildiğinde Interval kesirli bir bölüm içerebilir. öğesinin Intervaldiğer değerleri için herhangi bir kesirli bölümü Number yoksayılır.

DateValue

Object

Gerekli. Aralığın eklendiği tarih ve saati temsil eden ifade. DateValue kendisini çağıran programda değiştirilmez.

Döndürülenler

DateTime

Belirtilen zaman aralığının eklendiği tarih ve saat değerini içeren bir değer.

Özel durumlar

InvalidCastException

DateValue , ile Datezorlanmıyor.

ArgumentException

Interval geçerli değil.

ArgumentOutOfRangeException

Hesaplanan tarih, 1 Yılın 1 Ocak günü 00:00:00'dan önce veya 31 Aralık 9999 tarihinde 23:59:59'dan sonradır.

Örnekler

Bu örnek bir tarih alır ve işlevini kullanarak DateAdd , gelecekte belirtilen sayıda ay için karşılık gelen bir tarih görüntüler.

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)

Açıklamalar

Belirtilen zaman aralığını bir tarihe eklemek veya çıkarmak için işlevini kullanabilirsiniz DateAdd . Örneğin, bugünden itibaren 30 gün veya bundan 45 dakika önce bir tarih hesaplayabilirsiniz.

öğesine gün eklemek için DateValue, DateInterval.DayOfYearveya DateInterval.WeekdaykullanabilirsinizDateInterval.Day. Bunlar, anlamlı zaman aralıkları olmadığından eşdeğer DayOfYearWeekday olarak değerlendirilir.

İşlev DateAdd hiçbir zaman geçersiz bir tarih döndürmez. Gerekirse, sonuçta elde edilen tarihin gün kısmı, sonuçta elde edilen yılın son gününe doğru aşağı doğru ayarlanır. Aşağıdaki örnek 31 Ocak'a bir ay ekler:

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

Bu örnekte , DateAdd değil #2/31/1995#döndürür#2/28/1995#. ise DateValue#1/31/1996#, 1996 artık yıl olduğundan döndürür #2/29/1996# .

Uyarı

DateAdd, ad alanında sınıfının System.Globalization özelliğinden CurrentCultureCultureInfo geçerli takvim ayarını kullanır. Varsayılan CurrentCulture değerler Denetim Masası ayarları tarafından belirlenir.

Her Date değer bir DateTime yapı tarafından desteklendiğinden, yöntemleri size zaman aralıkları eklemede ek seçenekler sağlar. Örneğin, bir değişkene en yakın milisaniyeye Date yuvarlanmış kesirli gün sayısını aşağıdaki gibi ekleyebilirsiniz:

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

Bağımsız Interval değişken aşağıdaki ayarlardan birine sahip olabilir.

Numaralandırma değeri	Dize	Eklenecek zaman aralığı birimi
DateInterval.Day	d	Gün; tamsayı değerine kesilmiş
DateInterval.DayOfYear	y	Gün; tamsayı değerine kesilmiş
DateInterval.Hour	h	Saat; en yakın milisaniyeye yuvarlanmış
DateInterval.Minute	n	Dakika; en yakın milisaniyeye yuvarlanmış
DateInterval.Month	m	Ay; tamsayı değerine kesilmiş
DateInterval.Quarter	q	Çeyrek; tamsayı değerine kesilmiş
DateInterval.Second	s	Ikinci; en yakın milisaniyeye yuvarlanmış
DateInterval.Weekday	w	Gün; tamsayı değerine kesilmiş
DateInterval.WeekOfYear	Ww	Hafta; tamsayı değerine kesilmiş
DateInterval.Year	yyyy	Yıl; tamsayı değerine kesilmiş

Ayrıca bkz.

• DateDiff
• DatePart
• Day(DateTime)
• Format(Object, String)
• Now
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• Veri Türü Özeti (Visual Basic)