DateAndTime.DateAdd Metod

Definition

Namnområde:: Microsoft.VisualBasic

Sammansättning:: Microsoft.VisualBasic.Core.dll

Sammansättning:: Microsoft.VisualBasic.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Returnerar ett Date värde som innehåller ett datum- och tidsvärde som ett angivet tidsintervall har lagts till i.

Överlagringar

Name	Description
DateAdd(DateInterval, Double, DateTime)	Returnerar ett värde som innehåller ett datum- och tidsvärde som ett angivet tidsintervall har lagts till i.
DateAdd(String, Double, Object)	Returnerar ett värde som innehåller ett datum- och tidsvärde som ett angivet tidsintervall har lagts till i.

DateAdd(DateInterval, Double, DateTime)

Källa:: DateAndTime.vb

Källa:: DateAndTime.vb

Källa:: DateAndTime.vb

Källa:: DateAndTime.vb

Källa:: DateAndTime.vb

Returnerar ett värde som innehåller ett datum- och tidsvärde som ett angivet tidsintervall har lagts till i.

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

Parametrar

Interval: DateInterval

Required. Ett DateInterval uppräkningsvärde eller ett stränguttryck som representerar det tidsintervall som du vill lägga till.

Number: Double

Required. Flyttalsuttryck som representerar antalet intervall som du vill lägga till. Det kan vara positivt (för att hämta datum-/tidsvärden i framtiden) eller negativa (för att hämta datum-/tidsvärden tidigare). Den kan innehålla en deldel när Interval den anger timmar, minuter eller sekunder. För andra värden i Intervalignoreras valfri del av Number .

DateValue: DateTime

Required. Ett uttryck som representerar datum och tid som intervallet ska läggas till i. DateValue ändras inte i det anropande programmet.

Returer

DateTime

Ett värde som innehåller ett datum- och tidsvärde som ett angivet tidsintervall har lagts till i.

Undantag

InvalidCastException

DateValue är inte tvingande för Date.

ArgumentException

Interval är ogiltigt.

ArgumentOutOfRangeException

Beräknat datum är före 00:00:00 den 1 januari år 1 eller senare än 23:59:59 den 31 december 9999.

Exempel

Det här exemplet tar ett datum och visar med hjälp DateAdd av funktionen ett motsvarande datum ett angivet antal månader i framtiden.

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)

Kommentarer

Du kan använda DateAdd funktionen för att lägga till eller subtrahera ett angivet tidsintervall från ett datum. Du kan till exempel beräkna ett datum 30 dagar från idag eller en tid 45 minuter före nu.

Om du vill lägga till dagar i DateValuekan du använda DateInterval.Day, DateInterval.DayOfYeareller DateInterval.Weekday. Dessa behandlas som likvärdiga eftersom DayOfYear och Weekday inte är meningsfulla tidsintervall.

Funktionen DateAdd returnerar aldrig ett ogiltigt datum. Vid behov justeras dagdelen av det resulterande datumet nedåt till den sista dagen i den resulterande månaden i det resulterande året. I följande exempel läggs en månad till den 31 januari:

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

I det här exemplet DateAdd returnerar #2/28/1995#, inte #2/31/1995#. Om DateValue är #1/31/1996#returnerar #2/29/1996# den eftersom 1996 är ett skottår.

Note

DateAdd använder den aktuella kalenderinställningen CurrentCulture från -egenskapen för CultureInfo klassen i System.Globalization namnområdet. Standardvärdena CurrentCulture bestäms av inställningarna ovládací panel.

Eftersom varje Date värde stöds av en DateTime struktur ger dess metoder ytterligare alternativ för att lägga till tidsintervall. Du kan till exempel lägga till ett bråktal dagar, avrundat till närmaste millisekunder, till en Date variabel enligt följande:

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

Argumentet Interval kan ha någon av följande inställningar.

Uppräkningsvärde	String	Tidsenhetsintervall att lägga till
`DateInterval.Day`	d	Dag; trunkerat till integralvärde
`DateInterval.DayOfYear`	y	Dag; trunkerat till integralvärde
`DateInterval.Hour`	h	Timme; avrundat till närmaste millisekunder
`DateInterval.Minute`	n	Minuters; avrundat till närmaste millisekunder
`DateInterval.Month`	m	Månad; trunkerat till integralvärde
`DateInterval.Quarter`	q	Quater; trunkerat till integralvärde
`DateInterval.Second`	s	Andra; avrundat till närmaste millisekunder
`DateInterval.Weekday`	w	Dag; trunkerat till integralvärde
`DateInterval.WeekOfYear`	Ww	Vecka; trunkerat till integralvärde
`DateInterval.Year`	yyyy	År; trunkerat till integralvärde

Se även

Gäller för

DateAdd(String, Double, Object)

Källa:: DateAndTime.vb

Källa:: DateAndTime.vb

Källa:: DateAndTime.vb

Källa:: DateAndTime.vb

Källa:: DateAndTime.vb