DateAndTime.DateAdd Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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 -> DateTimePublic Function DateAdd (Interval As DateInterval, Number As Double, DateValue As DateTime) As DateTimeParametreler
- 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
Belirtilen zaman aralığının eklendiği tarih ve saat değerini içeren bir değer.
Özel durumlar
DateValue , ile zorlanmıyor Date.
Interval geçerli değil.
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.
- DateDiff
- DatePart
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- Veri Türü Özeti (Visual Basic)
Ş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 -> DateTimePublic Function DateAdd (Interval As String, Number As Double, DateValue As Object) As DateTimeParametreler
- 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
Belirtilen zaman aralığının eklendiği tarih ve saat değerini içeren bir değer.
Özel durumlar
DateValue , ile zorlanmıyor Date.
Interval geçerli değil.
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.
- DateDiff
- DatePart
- Day(DateTime)
- Format(Object, String)
- Now
- Weekday(DateTime, FirstDayOfWeek)
- Year(DateTime)
- Veri Türü Özeti (Visual Basic)
