DateAndTime.DateAdd Metódus

Definíció

Névtér:: Microsoft.VisualBasic

Szerelvény:: Microsoft.VisualBasic.Core.dll

Szerelvény:: Microsoft.VisualBasic.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Date Olyan dátum- és időértéket tartalmazó értéket ad vissza, amelyhez adott időintervallumot adtak hozzá.

Túlterhelések

Name	Description
DateAdd(DateInterval, Double, DateTime)	Olyan dátum- és időértéket tartalmazó értéket ad vissza, amelyhez adott időintervallumot adtak hozzá.
DateAdd(String, Double, Object)	Olyan dátum- és időértéket tartalmazó értéket ad vissza, amelyhez adott időintervallumot adtak hozzá.

DateAdd(DateInterval, Double, DateTime)

Forrás:: DateAndTime.vb

Forrás:: DateAndTime.vb

Forrás:: DateAndTime.vb

Forrás:: DateAndTime.vb

Forrás:: DateAndTime.vb

Olyan dátum- és időértéket tartalmazó értéket ad vissza, amelyhez adott időintervallumot adtak hozzá.

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

Paraméterek

Interval: DateInterval

Kötelező. Enumerálási DateInterval érték vagy a hozzáadni kívánt időintervallumot képviselő sztringkifejezés.

Number: Double

Kötelező. Lebegőpontos kifejezés, amely a hozzáadni kívánt intervallumok számát jelöli. Lehet pozitív (dátum-/időértékek lekérése a jövőben) vagy negatív (a múltbeli dátum-/időértékek lekéréséhez). Órák, percek vagy másodpercek megadásakor Interval törtrészt tartalmazhat. Más értékek esetén a Intervalrendszer figyelmen kívül hagyja a törtrészeket Number .

DateValue: DateTime

Kötelező. Az intervallum hozzáadásának dátumát és időpontját jelképező kifejezés. DateValue nem változik a hívó programban.

Válaszok

DateTime

Olyan dátum- és időértéket tartalmazó érték, amelyhez adott időintervallum hozzáadva van.

Kivételek

InvalidCastException

DateValuenem kényszeríthető.Date

ArgumentException

Interval érvénytelen.

ArgumentOutOfRangeException

A számított dátum az 1. év január 1-jén 00:00:00 előtt van, vagy 9999. december 31-én 23:59:59 előtt van.

Példák

Ez a példa egy dátumot vesz igénybe, és a DateAdd függvény használatával egy megadott számú hónapot tartalmazó dátumot jelenít meg a jövőben.

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)

Megjegyzések

A függvény használatával DateAdd hozzáadhat vagy kivonhat egy megadott időintervallumot egy dátumból. Kiszámíthat például egy dátumot 30 nappal a mai naptól, vagy egy 45 perccel korábbi időpontot.

Napok hozzáadásához DateValuehasználhatja DateInterval.Daya DateInterval.DayOfYearDateInterval.Weekdaykövetkezőt: Ezeket egyenértékűként kezeli a rendszer, DayOfYear mert Weekday nem értelmezhető időintervallumok.

A DateAdd függvény soha nem ad vissza érvénytelen dátumot. Szükség esetén az eredményként kapott dátum naprészét lefelé igazítjuk az eredményként kapott hónap utolsó napjához a következő évben. Az alábbi példa egy hónapot ad hozzá január 31-hez:

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

Ebben a példában a DateAdd visszaadott #2/28/1995#érték nem #2/31/1995#. Ha DateValue igen #1/31/1996#, akkor visszatér #2/29/1996# , mert 1996 szökőév.

Note

DateAddAz aktuális naptárbeállítást használja a CurrentCulture névtérben lévő CultureInfo osztály tulajdonságábólSystem.Globalization. Az alapértelmezett CurrentCulture értékeket Vezérlőpult beállítások határozzák meg.

Mivel egy struktúra minden Date értéket támogat DateTime , a metódusok további lehetőségeket biztosítanak az időintervallumok hozzáadásához. Például a napok törtszámát a legközelebbi ezredmásodpercre kerekítve adhat hozzá egy Date változóhoz az alábbiak szerint:

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

Az Interval argumentum az alábbi beállítások egyikével rendelkezhet.

Számbavételi érték	Lánc	A hozzáadni kívánt időintervallum mértékegysége
`DateInterval.Day`	d	Nap; csonkolt az integrál értékre
`DateInterval.DayOfYear`	y	Nap; csonkolt az integrál értékre
`DateInterval.Hour`	h	Óra; kerekítve a legközelebbi ezredmásodpercre
`DateInterval.Minute`	n	Perces; kerekítve a legközelebbi ezredmásodpercre
`DateInterval.Month`	m	Hónap; csonkolt az integrál értékre
`DateInterval.Quarter`	q	Negyed; csonkolt az integrál értékre
`DateInterval.Second`	s	Második; kerekítve a legközelebbi ezredmásodpercre
`DateInterval.Weekday`	w	Nap; csonkolt az integrál értékre
`DateInterval.WeekOfYear`	Ww	Héten; csonkolt az integrál értékre
`DateInterval.Year`	yyyy	Év; csonkolt az integrál értékre

Lásd még

A következőre érvényes:

DateAdd(String, Double, Object)

Forrás:: DateAndTime.vb

Forrás:: DateAndTime.vb

Forrás:: DateAndTime.vb

Forrás:: DateAndTime.vb

Forrás:: DateAndTime.vb