DateTime.Add(TimeSpan) Metod
Definition
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.
public:
DateTime Add(TimeSpan value);
public DateTime Add(TimeSpan value);
member this.Add : TimeSpan -> DateTime
Public Function Add (value As TimeSpan) As DateTime
Parametrar
- value
- TimeSpan
Ett positivt eller negativt tidsintervall.
Returer
Ett objekt vars värde är summan av det datum och den tid som representeras av den här instansen och det tidsintervall som representeras av value.
Undantag
DateTime Resultatet är mindre än DateTime.MinValue eller större än DateTime.MaxValue.
Exempel
I följande exempel visas Add metoden. Den beräknar veckodagen som är 36 dagar (864 timmar) från det här ögonblicket.
// Calculate what day of the week is 36 days from this instant.
let today = DateTime.Now
let duration = TimeSpan(36, 0, 0, 0)
let answer = today.Add duration
printfn $"{answer:dddd}"
// Calculate what day of the week is 36 days from this instant.
System.DateTime today = System.DateTime.Now;
System.TimeSpan duration = new System.TimeSpan(36, 0, 0, 0);
System.DateTime answer = today.Add(duration);
System.Console.WriteLine("{0:dddd}", answer);
' Calculate what day of the week is 36 days from this instant.
Dim today As System.DateTime
Dim duration As System.TimeSpan
Dim answer As System.DateTime
today = System.DateTime.Now
duration = New System.TimeSpan(36, 0, 0, 0)
answer = today.Add(duration)
System.Console.WriteLine("{0:dddd}", answer)
Kommentarer
Du kan använda Add metoden för att lägga till mer än en typ av tidsintervall (dagar, timmar, minuter, sekunder eller millisekunder) i en enda åtgärd. Den här metodens beteende är identiskt med additionsoperatorns beteende. Strukturen DateTime stöder också specialiserade tilläggsmetoder (till exempel AddDays, AddHoursoch AddMinutes) för varje tidsintervall.
Metoden Add tar hänsyn till skottår och antalet dagar i en månad när datumaritmetik utförs.
Den här metoden ändrar inte värdet för den här DateTime. I stället returnerar den en ny DateTime vars värde är resultatet av den här åtgärden. Egenskapen Kind för den nya DateTime instansen är densamma som för den aktuella instansen.