El método plusYears() de la clase LocalDate en Java se usa para agregar el número de años especificado en esta LocalDate y devolver una copia de LocalDate.
Este método agrega el campo de años en los siguientes pasos:
- Agregue los años al campo de año.
- Compruebe si la fecha después de agregar años es válida o no.
- Si la fecha no es válida, el método ajusta el día del mes al último día válido.
Por ejemplo, 2016-02-29 (año bisiesto) más un año da como resultado la fecha 2017-02-29, pero este resultado no es válido, por lo que se devuelve el último día válido del mes, 2017-02-28. Esta instancia es inmutable y no se ve afectado por esta llamada de método.
Sintaxis:
public LocalDate plusYears(long yearsToAdd)
Parámetros: Este método acepta un único parámetro yearsToAdd que representa los años a sumar, puede ser negativo.
Valor de retorno: este método devuelve un LocalDate basado en esta fecha con los años agregados, no nulo.
Excepción: este método lanza DateTimeException si el resultado excede el rango de fechas admitido.
Los siguientes programas ilustran el método plusYears():
Programa 1:
// Java program to demonstrate
// LocalDate.plusYears() method
import java.time.*;
public class GFG {
public static void main(String[] args)
{
// create a LocalDate object
LocalDate date
= LocalDate.parse("2018-11-13");
// print instance
System.out.println("LocalDate before"
+ " adding years: " + date);
// add 3 years
LocalDate returnvalue
= date.plusYears(3);
// print result
System.out.println("LocalDate after "
+ " adding years: " + returnvalue);
}
}
LocalDate before adding years: 2018-11-13 LocalDate after adding years: 2021-11-13
Programa 2:
// Java program to demonstrate
// LocalDate.plusYears() method
import java.time.*;
public class GFG {
public static void main(String[] args)
{
// create a LocalDate object
LocalDate date
= LocalDate.parse("2016-02-29");
// print instance
System.out.println("LocalDate before"
+ " adding years: " + date);
// add 2 years
LocalDate returnvalue
= date.plusYears(2);
// print result
System.out.println("LocalDate after "
+ " adding years: " + returnvalue);
}
}
LocalDate before adding years: 2016-02-29 LocalDate after adding years: 2018-02-28
Referencias:
https://docs.oracle.com/javase/10/docs/api/java/time/LocalDate.html#plusYears(long)
Publicación traducida automáticamente
Artículo escrito por AmanSingh2210 y traducido por Barcelona Geeks. The original can be accessed here. Licence: CCBY-SA