DateTimeOffset.AddMonths(Int32) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Retourneert een nieuw DateTimeOffset object dat een opgegeven aantal maanden toevoegt aan de waarde van dit exemplaar.
public:
DateTimeOffset AddMonths(int months);public DateTimeOffset AddMonths(int months);member this.AddMonths : int -> DateTimeOffsetPublic Function AddMonths (months As Integer) As DateTimeOffsetParameters
- months
- Int32
Een aantal hele maanden. Het getal kan negatief of positief zijn.
Retouren
Een object waarvan de waarde de som is van de datum en tijd die wordt vertegenwoordigd door het huidige DateTimeOffset object en het aantal maanden dat wordt vertegenwoordigd door months.
Uitzonderingen
De resulterende DateTimeOffset waarde is kleiner dan DateTimeOffset.MinValue.
– of –
De resulterende DateTimeOffset waarde is groter dan DateTimeOffset.MaxValue.
Voorbeelden
In het volgende voorbeeld wordt de AddMonths methode gebruikt om de begindatum van elk kwartaal van het jaar 2007 weer te geven.
DateTimeOffset quarterDate = new DateTimeOffset(2007, 1, 1, 0, 0, 0,
DateTimeOffset.Now.Offset);
for (int ctr = 1; ctr <= 4; ctr++)
{
Console.WriteLine("Quarter {0}: {1:MMMM d}", ctr, quarterDate);
quarterDate = quarterDate.AddMonths(3);
}
// This example produces the following output:
// Quarter 1: January 1
// Quarter 2: April 1
// Quarter 3: July 1
// Quarter 4: October 1
let mutable quarterDate = DateTimeOffset(2007, 1, 1, 0, 0, 0, DateTimeOffset.Now.Offset)
for i = 1 to 4 do
printfn $"""Quarter {i}: {quarterDate.ToString "MMMM d"}"""
quarterDate <- quarterDate.AddMonths 3
// This example produces the following output:
// Quarter 1: January 1
// Quarter 2: April 1
// Quarter 3: July 1
// Quarter 4: October 1
Dim quarterDate As New DateTimeOffset(#01/01/2007#, DateTimeOffset.Now.Offset)
For ctr As Integer = 1 To 4
Console.WriteLine("Quarter {0}: {1:MMMM d}", ctr, quarterDate)
quarterDate = quarterDate.AddMonths(3)
Next
' This example produces the following output:
' Quarter 1: January 1
' Quarter 2: April 1
' Quarter 3: July 1
' Quarter 4: October 1
Opmerkingen
In tegenstelling tot de meeste andere methoden die één tijdsintervaleenheid (zoals minuten of dagen) toevoegen aan een datum- en tijdwaarde, AddMonths kunt u geen breukdelen van een maand toevoegen. Als u een tijd wilt toevoegen die bestaat uit andere tijdseenheden naast maanden aan een DateTimeOffset object, gebruikt u de Add methode.
Note
Met deze methode wordt een nieuw DateTimeOffset object geretourneerd. De waarde van het huidige object wordt niet gewijzigd door deze toe te voegen aan months de datum en tijd.
