UmAlQuraCalendar.AddMonths(DateTime, Int32) 方法

参考

定义

命名空间:: System.Globalization

程序集:: mscorlib.dll, System.Globalization.Calendars.dll

程序集:: System.Runtime.dll

程序集:: System.Globalization.Calendars.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

计算与指定初始日期相距指定月数的日期。

public:
 override DateTime AddMonths(DateTime time, int months);

public override DateTime AddMonths (DateTime time, int months);

override this.AddMonths : DateTime * int -> DateTime

Public Overrides Function AddMonths (time As DateTime, months As Integer) As DateTime

参数

time: DateTime

要加上月数的日期。 UmAlQuraCalendar 类仅支持从 1900/04/30 00.00.00（公历日期）到 2077/11/16 23:59:59（公历日期）的日期。

months: Int32

要添加的正月数或负月数。

DateTime

在将 months 参数指定的月数加到 time 参数指定的日期后所得的日期。

例外

ArgumentException

得到的日期不在 UmAlQuraCalendar 类支持的范围内。

ArgumentOutOfRangeException

months 小于 -120,000 或大于 120,000。

或 - time 超出了此日历支持的范围。

示例

以下示例实例化一个 DateTime 值，并在 Um Al Qura 日历中显示其多个组件的值。接下来，它将调用 AddYears 和 AddMonths 方法，将 Um Al Qura 日历中的 2 年 10 个月添加到日期值。最后，它再次在 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

注解

如果生成的日期不是结果年份的结果月份中的有效日期，则生成的 DateTime 日期部分会受到影响。它更改为生成的年份的最后一个有效日。如果生成的月份超出指定DateTime年份，则生成的DateTime年份部分将受到影响。此实现仅支持当前时代。因此，如果生成的年份超出指定 DateTime时代，则会引发异常。生成的 DateTime 当天部分与指定的 DateTime时间保持相同。

例如，如果指定的月份是 Zulkadah，该月有 30 天，则指定的日期为当月的第 30 天，参数的值为 months 3，生成的年份是指定年份的一个以上，生成的月份为 Safar，生成的日期为第 29 天，这是萨法尔的最后一天。

如果参数的值 months 为负值，则生成的结果 DateTime 早于指定的 DateTime值。

Kind返回DateTime值的属性始终相等DateTimeKind.Unspecified。可以通过调用DateTime.SpecifyKind方法来保留Kind参数的属性time，如以下示例所示。

returnTime = DateTime.SpecifyKind(cal.AddMonths(time, months), time.Kind);

returnTime = DateTime.SpecifyKind(cal.AddMonths(time, months), time.Kind)

适用于

UmAlQuraCalendar.AddMonths(DateTime, Int32) 方法

定义

参数

返回

例外

示例

注解

适用于

其他资源