UmAlQuraCalendar.AddMonths(DateTime, Int32) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Oblicza datę, która jest określoną liczbą miesięcy od określonej daty początkowej.
public:
override DateTime AddMonths(DateTime time, int months);public override DateTime AddMonths (DateTime time, int months);override this.AddMonths : DateTime * int -> DateTimePublic Overrides Function AddMonths (time As DateTime, months As Integer) As DateTimeParametry
- time
- DateTime
Data dodania miesięcy. Klasa UmAlQuraCalendar obsługuje tylko daty od 04/30/1900 00.00.00 (data gregoriańskiego) do 11.16.2077 23:59:59 (data gregoriańskiego).
- months
- Int32
Dodatnia lub ujemna liczba miesięcy do dodania.
Zwraca
Data zwrócona przez dodanie liczby miesięcy określonych przez months parametr do daty określonej przez time parametr .
Wyjątki
Wynikowa data znajduje się poza zakresem obsługiwanym przez klasę UmAlQuraCalendar .
months jest mniejsza niż -120 000 lub większa niż 120 000.
-lub-
time znajduje się poza zakresem obsługiwanym przez ten kalendarz.
Przykłady
Poniższy przykład tworzy wystąpienie DateTime wartości i wyświetla wartości kilku jego składników w kalendarzu Um Al Qura. Następnie wywołuje AddYears metody i AddMonths , aby dodać 2 lata i 10 miesięcy w kalendarzu Um Al Qura do wartości daty. Na koniec ponownie wyświetla wartości tych składników daty w kalendarzu Um Al Qura.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
DateTime date1 = new DateTime(2011, 4, 3, new GregorianCalendar());
Calendar cal = new UmAlQuraCalendar();
Console.WriteLine("{0:MMMM d, yyyy} in the Gregorian calendar is equivalent to:", date1);
DisplayCalendarInfo(cal, date1);
// Add 2 years and 10 months by calling UmAlQuraCalendar methods.
date1 = cal.AddYears(date1, 2);
date1 = cal.AddMonths(date1, 10);
Console.WriteLine("After adding 2 years and 10 months in the {0} calendar,",
GetCalendarName(cal));
Console.WriteLine("{0:MMMM d, yyyy} in the Gregorian calendar is equivalent to:", date1);
DisplayCalendarInfo(cal, date1);
}
private static void DisplayCalendarInfo(Calendar cal, DateTime date1)
{
Console.WriteLine(" Calendar: {0}", GetCalendarName(cal));
Console.WriteLine(" Era: {0}", cal.GetEra(date1));
Console.WriteLine(" Year: {0}", cal.GetYear(date1));
Console.WriteLine(" Month: {0}", cal.GetMonth(date1));
Console.WriteLine(" DayOfYear: {0}", cal.GetDayOfYear(date1));
Console.WriteLine(" DayOfMonth: {0}", cal.GetDayOfMonth(date1));
Console.WriteLine(" DayOfWeek: {0}\n", cal.GetDayOfWeek(date1));
}
private static string GetCalendarName(Calendar cal)
{
return cal.ToString().Replace("System.Globalization.", "").
Replace("Calendar", "");
}
}
// The example displays the following output:
// April 3, 2011 in the Gregorian calendar is equivalent to:
// Calendar: UmAlQura
// Era: 1
// Year: 1432
// Month: 4
// DayOfYear: 118
// DayOfMonth: 29
// DayOfWeek: Sunday
//
// After adding 2 years and 10 months in the UmAlQura calendar,
// January 1, 2014 in the Gregorian calendar is equivalent to:
// Calendar: UmAlQura
// Era: 1
// Year: 1435
// Month: 2
// DayOfYear: 59
// DayOfMonth: 29
// DayOfWeek: Wednesday
Imports System.Globalization
Module Example
Public Sub Main()
Dim date1 As Date = New Date(2011, 4, 3, New GregorianCalendar())
Dim cal As New UmAlQuraCalendar()
Console.WriteLine("{0:MMMM d, yyyy} in the Gregorian calendar is equivalent to:", date1)
DisplayCalendarInfo(cal, date1)
' Add 2 years and 10 months by calling UmAlQuraCalendar methods.
date1 = cal.AddYears(date1, 2)
date1 = cal.AddMonths(date1, 10)
Console.WriteLine("After adding 2 years and 10 months in the {0} calendar,",
GetCalendarName(cal))
Console.WriteLine("{0:MMMM d, yyyy} in the Gregorian calendar is equivalent to:", date1)
DisplayCalendarInfo(cal, date1)
End Sub
Private Sub DisplayCalendarInfo(cal As Calendar, date1 As Date)
Console.WriteLine(" Calendar: {0}", GetCalendarName(cal))
Console.WriteLine(" Era: {0}", cal.GetEra(date1))
Console.WriteLine(" Year: {0}", cal.GetYear(date1))
Console.WriteLine(" Month: {0}", cal.GetMonth(date1))
Console.WriteLine(" DayOfYear: {0}", cal.GetDayOfYear(date1))
Console.WriteLine(" DayOfMonth: {0}", cal.GetDayOfMonth(date1))
Console.WriteLine(" DayOfWeek: {0}", cal.GetDayOfWeek(date1))
Console.WriteLine()
End Sub
Private Function GetCalendarName(cal As Calendar) As String
Return cal.ToString().Replace("System.Globalization.", "").
Replace("Calendar", "")
End Function
End Module
' The example displays the following output:
' April 3, 2011 in the Gregorian calendar is equivalent to:
' Calendar: UmAlQura
' Era: 1
' Year: 1432
' Month: 4
' DayOfYear: 118
' DayOfMonth: 29
' DayOfWeek: Sunday
'
' After adding 2 years and 10 months in the UmAlQura calendar,
' January 1, 2014 in the Gregorian calendar is equivalent to:
' Calendar: UmAlQura
' Era: 1
' Year: 1435
' Month: 2
' DayOfYear: 59
' DayOfMonth: 29
' DayOfWeek: Wednesday
Uwagi
Część dnia wynikowego DateTime ma wpływ, jeśli wynikowy dzień nie jest prawidłowym dniem w wynikowym miesiącu wynikowego roku. Zostanie on zmieniony na ostatni prawidłowy dzień w wynikowym miesiącu wynikowego roku. Część roku wynikowego ma wpływ, jeśli wynikowy DateTime miesiąc jest poza rokiem określonego DateTime. Ta implementacja obsługuje tylko bieżącą erę. W związku z tym zgłaszany jest wyjątek, jeśli wynikowy rok wykracza poza erę określonego DateTimeelementu . Część czasu dnia wynikowego DateTime pozostaje taka sama jak określona DateTimewartość .
Jeśli na przykład określony miesiąc to Zulkadah, który ma 30 dni, określony dzień to 30 dzień tego miesiąca, a wartość months parametru to 3, wynikowy rok jest więcej niż określony rok, wynikowy miesiąc to Safar, a wynikowy dzień to 29 dzień, czyli ostatni dzień w Safar.
Jeśli wartość parametru months jest ujemna, wynik DateTime jest wcześniejszy niż określony DateTime.
Właściwość Kind zwracanej DateTime wartości zawsze jest równa DateTimeKind.Unspecified. Właściwość parametru time można zachowaćKind, wywołując metodęDateTime.SpecifyKind, jak pokazano w poniższym przykładzie.
returnTime = DateTime.SpecifyKind(cal.AddMonths(time, months), time.Kind);
returnTime = DateTime.SpecifyKind(cal.AddMonths(time, months), time.Kind)