Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Método DateTime.AddYears (Int32)

 

Retorna um novo DateTime que adiciona o número especificado de anos para o valor desta instância.

Namespace:   System
Assembly:  mscorlib (em mscorlib.dll)

public DateTime AddYears(
	int value
)

Parâmetros

value

Um número de anos.O parâmetro value pode ser positivo ou negativo.

Valor de retorno

Type: System.DateTime

Um objeto cujo valor é a soma da data e hora representado por esta instância e o número de anos representados por value.

Exception Condition
ArgumentOutOfRangeException

value ou resultante DateTime é menor que MinValue ou maior que MaxValue.

Este método não altera o valor desse DateTime objeto.Em vez disso, ele retorna um novo DateTime objeto cujo valor é o resultado dessa operação.

O AddYears método calcula o ano resultante levando em consideração anos bissextos.A parte de mês e dia de horário do resultante DateTime objeto permanece o mesmo que essa instância.

Se a instância atual representa o dia bissexto em um ano bissexto, o valor de retorno depende da data de destino:

  • Se value + DateTime.Year também é um ano bissexto, o valor de retorno representa dia daquele ano bissexto.Por exemplo, se quatro anos é adicionado a 29 de fevereiro de 2012, a data retornada é 29 de fevereiro de 2016.

  • Se value + DateTime.Year não é um ano bissexto, o valor de retorno representa o dia antes do dia daquele ano bissexto.Por exemplo, se um ano for adicionado a 29 de fevereiro de 2012, a data retornada é 28 de fevereiro de 2013.

O exemplo a seguir ilustra o uso de AddYears método com um DateTime valor que representa um dia do ano bissexto.Ele exibe a data de quinze anos antes e quinze anos que se seguem 29 de fevereiro de 2000.

using System;

public class Example
{
   public static void Main()
   {
      DateTime baseDate = new DateTime(2000, 2, 29);
      Console.WriteLine("    Base Date:        {0:d}\n", baseDate);

      // Show dates of previous fifteen years.
      for (int ctr = -1; ctr >= -15; ctr--)
         Console.WriteLine("{0,2} year(s) ago:        {1:d}", 
                           Math.Abs(ctr), baseDate.AddYears(ctr));
      Console.WriteLine();

      // Show dates of next fifteen years.
      for (int ctr = 1; ctr <= 15; ctr++)
         Console.WriteLine("{0,2} year(s) from now:   {1:d}", 
                           ctr, baseDate.AddYears(ctr));
   }
}
// The example displays the following output:
//           Base Date:        2/29/2000
//       
//        1 year(s) ago:        2/28/1999
//        2 year(s) ago:        2/28/1998
//        3 year(s) ago:        2/28/1997
//        4 year(s) ago:        2/29/1996
//        5 year(s) ago:        2/28/1995
//        6 year(s) ago:        2/28/1994
//        7 year(s) ago:        2/28/1993
//        8 year(s) ago:        2/29/1992
//        9 year(s) ago:        2/28/1991
//       10 year(s) ago:        2/28/1990
//       11 year(s) ago:        2/28/1989
//       12 year(s) ago:        2/29/1988
//       13 year(s) ago:        2/28/1987
//       14 year(s) ago:        2/28/1986
//       15 year(s) ago:        2/28/1985
//       
//        1 year(s) from now:   2/28/2001
//        2 year(s) from now:   2/28/2002
//        3 year(s) from now:   2/28/2003
//        4 year(s) from now:   2/29/2004
//        5 year(s) from now:   2/28/2005
//        6 year(s) from now:   2/28/2006
//        7 year(s) from now:   2/28/2007
//        8 year(s) from now:   2/29/2008
//        9 year(s) from now:   2/28/2009
//       10 year(s) from now:   2/28/2010
//       11 year(s) from now:   2/28/2011
//       12 year(s) from now:   2/29/2012
//       13 year(s) from now:   2/28/2013
//       14 year(s) from now:   2/28/2014
//       15 year(s) from now:   2/28/2015

Universal Windows Platform
Disponível desde 4.5
.NET Framework
Disponível desde 1.1
Portable Class Library
Com suporte em: portable .NET platforms
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0
Windows Phone
Disponível desde 8.1
Retornar ao topo
Mostrar: