DateAndTime.DateAdd Yöntem

  • Başvuru

Tanım

Ad Alanı:
Microsoft.VisualBasic
Bütünleştirilmiş Kod:
Microsoft.VisualBasic.Core.dll
Bütünleştirilmiş Kod:
Microsoft.VisualBasic.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

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
Kaynak:
DateAndTime.vb
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

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

Number
Double

Gereklidir. Eklemek istediğiniz aralık sayısını temsil eden kayan nokta ifadesi. Pozitif (gelecekteki tarih/saat değerlerini almak için) veya negatif (geçmişteki tarih/saat değerlerini almak için) olabilir. Saat, dakika veya saniye belirtirken Interval kesirli bir parça içerebilir. diğer değerleri için öğesinin Intervalherhangi bir kesirli bölümü Number yoksayılır.

DateValue
DateTime

Gereklidir. 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 zorlanmıyor Date.

ArgumentException

Interval geçerli değil.

ArgumentOutOfRangeException

Hesaplanan tarih, 1 Yılın 1 Ocak günü saat 00:00:00'dan önce veya 31 Aralık 9999'da 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 tarihi 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# .

Not

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 aşağıdaki gibi en yakın milisaniyeye yuvarlanmış kesirli gün Date sayısı 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.

Şunlara uygulanır

DateAdd(String, Double, Object)

Kaynak:
DateAndTime.vb
Kaynak:
DateAndTime.vb
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);
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

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

Number
Double

Gereklidir. Eklemek istediğiniz aralık sayısını temsil eden kayan nokta ifadesi. Number pozitif (gelecekteki tarih/saat değerlerini almak için) veya negatif (geçmişteki tarih/saat değerlerini almak için) olabilir. Saat, dakika veya saniye belirtirken Interval kesirli bir parça içerebilir. diğer değerleri için öğesinin Intervalherhangi bir kesirli bölümü Number yoksayılır.

DateValue
Object

Gereklidir. 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 zorlanmıyor Date.

ArgumentException

Interval geçerli değil.

ArgumentOutOfRangeException

Hesaplanan tarih, 1 Yılın 1 Ocak günü saat 00:00:00'dan önce veya 31 Aralık 9999'da 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 tarihi 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# .

Not

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 aşağıdaki gibi en yakın milisaniyeye yuvarlanmış kesirli gün Date sayısı 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.

Şunlara uygulanır