C＃中的DateTimeOffset.AddYears()方法

此方法用于返回一个新的DateTimeOffset对象，该对象将指定的年数添加到当前实例的值中。

Syntax: public DateTimeOffset AddYears (int years);
Here, it takes a number of years. The number can be negative or positive.

Return Value: This method returns an object whose value is the sum of the date and time represented by the current DateTimeOffset object and the number of years represented by years.

Exception: This method will give ArgumentOutOfRangeException if the resulting DateTimeOffset value is less than MinValue or the resulting DateTimeOffset value is greater than MaxValue.

下面的程序说明了DateTimeOffset.AddYears(Int32)方法的用法：

范例1：

// C# program to demonstrate the
// DateTimeOffset.AddYears(Int32)
// Method
using System;
using System.Globalization;
  
class GFG {
  
    // Main Method
    public static void Main()
    {
        try {
  
            // creating object of  DateTimeOffset
            DateTimeOffset offset = new DateTimeOffset(2007,
                    6, 1, 7, 55, 0, new TimeSpan(-5, 0, 0));
  
            // adding a specified number of whole and
            // fractional year to the value of this
            // instance using AddYears() method
            DateTimeOffset value = offset.AddYears(10);
  
            // Display the time
            Console.WriteLine("DateTimeOffset is {0}", value);
        }
  
        catch (ArgumentOutOfRangeException e) {
            Console.Write("Exception Thrown: ");
            Console.Write("{0}", e.GetType(), e.Message);
        }
    }
}

输出：

DateTimeOffset is 06/01/2017 07:55:00 -05:00

示例2：对于ArgumentOutOfRangeException

// C# program to demonstrate the
// DateTimeOffset.AddYears(Int32)
// Method
using System;
using System.Globalization;
  
class GFG {
  
    // Main Method
    public static void Main()
    {
        try {
  
            // creating object of  DateTimeOffset
            DateTimeOffset offset = DateTimeOffset.MaxValue;
  
            // adding a specified number of whole and
            // fractional year to the value of this
            // instance using AddYears() method
            DateTimeOffset value = offset.AddYears(10);
  
            // Display the time
            Console.WriteLine("DateTimeOffset is {0}", value);
        }
  
        catch (ArgumentOutOfRangeException e) {
            Console.Write("Exception Thrown: ");
            Console.Write("{0}", e.GetType(), e.Message);
        }
    }
}

输出：

Exception Thrown: System.ArgumentOutOfRangeException

参考：

• https://docs.microsoft.com/zh-cn/dotnet/api/system.datetimeoffset.addyears?view=netframework-4.7.2