Java : Year con ejemplos

Year (Java SE 21 & JDK 21) en Java con ejemplos.
Encontrará ejemplos de código en la mayoría de los métodos de Year.

Nota :


Summary

Un año en el sistema de calendario ISO-8601, como 2007. (Traducción automática)

Class diagram

final var year = Year.of(2100);
System.out.println(year.getValue()); // 2100
System.out.println(year.length()); // 365

Fields

static final int MAX_VALUE

El año máximo admitido, '+999,999,999'. (Traducción automática)

System.out.println(Year.MAX_VALUE); // 999999999

static final int MIN_VALUE

El año mínimo admitido, '-999,999,999'. (Traducción automática)

System.out.println(Year.MIN_VALUE); // -999999999

Methods

Temporal adjustInto (Temporal temporal)

Ajusta el objeto temporal especificado para tener este año. (Traducción automática)

final var year = Year.of(1800);
System.out.println(year); // 1800

final var date = LocalDate.of(2100, 2, 3);
System.out.println(date); // 2100-02-03

final var ret = year.adjustInto(date);
System.out.println(ret); // 1800-02-03

LocalDate atDay (int dayOfYear)

Combina este año con un día del año para crear una Fecha Local. (Traducción automática)

final var year = Year.of(2100);
System.out.println(year); // 2100

System.out.println(year.atDay(2)); // 2100-01-02
System.out.println(year.atDay(3)); // 2100-01-03
System.out.println(year.atDay(32)); // 2100-02-01
System.out.println(year.atDay(365)); // 2100-12-31

YearMonth atMonth (int month)

Combina este año con un mes para crear un AñoMes. (Traducción automática)

final var year = Year.of(2100);
System.out.println(year); // 2100

System.out.println(year.atMonth(1)); // 2100-01
System.out.println(year.atMonth(Month.JANUARY)); // 2100-01

System.out.println(year.atMonth(2)); // 2100-02
System.out.println(year.atMonth(Month.FEBRUARY)); // 2100-02

System.out.println(year.atMonth(12)); // 2100-12
System.out.println(year.atMonth(Month.DECEMBER)); // 2100-12

YearMonth atMonth (Month month)

Combina este año con un mes para crear un AñoMes. (Traducción automática)

final var year = Year.of(2100);
System.out.println(year); // 2100

System.out.println(year.atMonth(1)); // 2100-01
System.out.println(year.atMonth(Month.JANUARY)); // 2100-01

System.out.println(year.atMonth(2)); // 2100-02
System.out.println(year.atMonth(Month.FEBRUARY)); // 2100-02

System.out.println(year.atMonth(12)); // 2100-12
System.out.println(year.atMonth(Month.DECEMBER)); // 2100-12

LocalDate atMonthDay (MonthDay monthDay)

Combina este año con un mes-día para crear una Fecha Local. (Traducción automática)

final var year = Year.of(2100);
System.out.println(year); // 2100

final var monthDay1 = MonthDay.of(1, 2);
System.out.println(monthDay1); // --01-02
System.out.println(year.atMonthDay(monthDay1)); // 2100-01-02

final var monthDay2 = MonthDay.of(12, 31);
System.out.println(monthDay2); // --12-31
System.out.println(year.atMonthDay(monthDay2)); // 2100-12-31

int compareTo (Year other)

Compara este año con otro año. (Traducción automática)

final var year1 = Year.of(2100);
final var year2 = Year.of(2100);

System.out.println(year1); // 2100
System.out.println(year2); // 2100

System.out.println(year1.compareTo(year2)); // 0
final var year1 = Year.of(1234);
final var year2 = Year.of(5678);

System.out.println(year1); // 1234
System.out.println(year2); // 5678

System.out.println(year1.compareTo(year2)); // -4444
final var year1 = Year.of(1234);
final var year2 = Year.of(-1234);

System.out.println(year1); // 1234
System.out.println(year2); // -1234

System.out.println(year1.compareTo(year2)); // 2468

boolean equals (Object obj)

Comprueba si este año es igual a otro año. (Traducción automática)

final var year1 = Year.of(2100);
final var year2 = Year.of(2100);

System.out.println(year1); // 2100
System.out.println(year2); // 2100

System.out.println(year1.equals(year2)); // true
final var year1 = Year.of(1234);
final var year2 = Year.of(5678);

System.out.println(year1); // 1234
System.out.println(year2); // 5678

System.out.println(year1.equals(year2)); // false
final var year1 = Year.of(1234);
final var year2 = Year.of(-1234);

System.out.println(year1); // 1234
System.out.println(year2); // -1234

System.out.println(year1.equals(year2)); // false

String format (DateTimeFormatter formatter)

Formatos este año utilizando el formateador especificado. (Traducción automática)

final var year = Year.of(2100);
System.out.println(year); // 2100

final var ret = year.format(DateTimeFormatter.ofPattern("yyyy"));
System.out.println(ret); // 2100
final var year = Year.of(2099);
System.out.println(year); // 2099

final var ret = year.format(DateTimeFormatter.ofPattern("yy"));
System.out.println(ret); // 99

static Year from (TemporalAccessor temporal)

Obtiene una instancia de Año de un objeto temporal. (Traducción automática)

final var date = LocalDate.of(2100, 2, 3);
System.out.println(date); // 2100-02-03

final var ret = Year.from(date);
System.out.println(ret); // 2100
final var dateTime = LocalDateTime.of(1800, 1, 1, 12, 30);
System.out.println(dateTime); // 1800-01-01T12:30

final var ret = Year.from(dateTime);
System.out.println(ret); // 1800

int get (TemporalField field)

Obtiene el valor del campo especificado de este año como un int. (Traducción automática)

final var year = Year.of(2100);
System.out.println(year); // 2100

System.out.println(year.get(ChronoField.YEAR)); // 2100
System.out.println(year.get(ChronoField.YEAR_OF_ERA)); // 2100
System.out.println(year.get(ChronoField.ERA)); // 1
final var year = Year.of(-100);
System.out.println(year); // -100

System.out.println(year.get(ChronoField.YEAR)); // -100
System.out.println(year.get(ChronoField.YEAR_OF_ERA)); // 101
System.out.println(year.get(ChronoField.ERA)); // 0

long getLong (TemporalField field)

Obtiene el valor del campo especificado de este año como un valor largo. (Traducción automática)

final var year = Year.of(2100);
System.out.println(year); // 2100

System.out.println(year.getLong(ChronoField.YEAR)); // 2100
System.out.println(year.getLong(ChronoField.YEAR_OF_ERA)); // 2100
System.out.println(year.getLong(ChronoField.ERA)); // 1
final var year = Year.of(-100);
System.out.println(year); // -100

System.out.println(year.getLong(ChronoField.YEAR)); // -100
System.out.println(year.getLong(ChronoField.YEAR_OF_ERA)); // 101
System.out.println(year.getLong(ChronoField.ERA)); // 0

int getValue ()

Obtiene el valor del año. (Traducción automática)

final var year = Year.of(2100);
System.out.println(year.getValue()); // 2100
final var year = Year.of(-100);
System.out.println(year.getValue()); // -100

int hashCode ()

Un código hash para este año. (Traducción automática)

final var year = Year.of(2100);
System.out.println(year); // 2100
System.out.println(year.hashCode()); // 2100
final var year = Year.of(-100);
System.out.println(year); // -100
System.out.println(year.hashCode()); // -100

boolean isAfter (Year other)

Comprueba si este año es posterior al año especificado. (Traducción automática)

final var year = Year.of(2100);
System.out.println(year); // 2100

final var year2 = Year.of(2099);
final var year3 = Year.of(2100);
final var year4 = Year.of(2101);

System.out.println(year2); // 2099
System.out.println(year3); // 2100
System.out.println(year4); // 2101

System.out.println(year.isAfter(year2)); // true
System.out.println(year.isAfter(year3)); // false
System.out.println(year.isAfter(year4)); // false

boolean isBefore (Year other)

Comprueba si este año es anterior al año especificado. (Traducción automática)

final var year = Year.of(2100);
System.out.println(year); // 2100

final var year2 = Year.of(2099);
final var year3 = Year.of(2100);
final var year4 = Year.of(2101);

System.out.println(year2); // 2099
System.out.println(year3); // 2100
System.out.println(year4); // 2101

System.out.println(year.isBefore(year2)); // false
System.out.println(year.isBefore(year3)); // false
System.out.println(year.isBefore(year4)); // true

boolean isLeap ()

Comprueba si el año es bisiesto, de acuerdo con las reglas del sistema de calendario proléptico ISO. (Traducción automática)

final var year = Year.of(2103);
System.out.println(year); // 2103
System.out.println(year.isLeap()); // false

final var monthDay = MonthDay.of(2, 29);
System.out.println(monthDay); // --02-29
System.out.println(year.isValidMonthDay(monthDay)); // false
final var year = Year.of(2104);
System.out.println(year); // 2104
System.out.println(year.isLeap()); // true

final var monthDay = MonthDay.of(2, 29);
System.out.println(monthDay); // --02-29
System.out.println(year.isValidMonthDay(monthDay)); // true

static boolean isLeap (long year)

Comprueba si el año es bisiesto, de acuerdo con las reglas del sistema de calendario proléptico ISO. (Traducción automática)

System.out.println(Year.isLeap(2103)); // false
System.out.println(Year.isLeap(2104)); // true
System.out.println(Year.isLeap(2105)); // false
System.out.println(Year.isLeap(2106)); // false
System.out.println(Year.isLeap(2107)); // false
System.out.println(Year.isLeap(2108)); // true

boolean isSupported (TemporalField field)

Comprueba si el campo especificado es compatible. (Traducción automática)

final var year = Year.of(2100);
System.out.println(year); // 2100

System.out.println(year.isSupported(ChronoField.YEAR)); // true
System.out.println(year.isSupported(ChronoField.YEAR_OF_ERA)); // true
System.out.println(year.isSupported(ChronoField.ERA)); // true

boolean isSupported (TemporalUnit unit)

Comprueba si la unidad especificada es compatible. (Traducción automática)

final var year = Year.of(2100);
System.out.println(year); // 2100

System.out.println(year.isSupported(ChronoUnit.YEARS)); // true
System.out.println(year.isSupported(ChronoUnit.DECADES)); // true
System.out.println(year.isSupported(ChronoUnit.CENTURIES)); // true
System.out.println(year.isSupported(ChronoUnit.MILLENNIA)); // true
System.out.println(year.isSupported(ChronoUnit.ERAS)); // true

boolean isValidMonthDay (MonthDay monthDay)

Comprueba si el mes-día es válido para este año. (Traducción automática)

final var year = Year.of(2103);
System.out.println(year); // 2103
System.out.println(year.isLeap()); // false

final var monthDay = MonthDay.of(2, 29);
System.out.println(monthDay); // --02-29
System.out.println(year.isValidMonthDay(monthDay)); // false
final var year = Year.of(2104);
System.out.println(year); // 2104
System.out.println(year.isLeap()); // true

final var monthDay = MonthDay.of(2, 29);
System.out.println(monthDay); // --02-29
System.out.println(year.isValidMonthDay(monthDay)); // true

int length ()

Obtiene la duración de este año en días. (Traducción automática)

final var year1 = Year.of(2103);
System.out.println(year1); // 2103
System.out.println(year1.length()); // 365
System.out.println(year1.isLeap()); // false

final var year2 = Year.of(2104);
System.out.println(year2); // 2104
System.out.println(year2.length()); // 366
System.out.println(year2.isLeap()); //true

Year minus (long amountToSubtract, TemporalUnit unit)

Devuelve una copia de este año con la cantidad especificada restada. (Traducción automática)

final var year = Year.of(2100);
System.out.println(year); // 2100

final var ret1 = year.minus(1, ChronoUnit.YEARS);
System.out.println(ret1); // 2099

final var ret2 = year.minus(2, ChronoUnit.YEARS);
System.out.println(ret2); // 2098

final var ret3 = year.minus(3000, ChronoUnit.YEARS);
System.out.println(ret3); // -900
final var year = Year.of(2100);
System.out.println(year); // 2100

final var ret1 = year.minus(1, ChronoUnit.DECADES);
System.out.println(ret1); // 2090

final var ret2 = year.minus(1, ChronoUnit.CENTURIES);
System.out.println(ret2); // 2000

final var ret3 = year.minus(1, ChronoUnit.MILLENNIA);
System.out.println(ret3); // 1100

Year minus (TemporalAmount amountToSubtract)

Devuelve una copia de este año con la cantidad especificada restada. (Traducción automática)

final var year = Year.of(2100);
System.out.println(year); // 2100

final var period = Period.ofYears(20);
System.out.println(period); // P20Y

final var ret = year.minus(period);
System.out.println(ret); // 2080

Year minusYears (long yearsToSubtract)

Devuelve una copia de este año con el número especificado de años restados. (Traducción automática)

final var year = Year.of(2100);
System.out.println(year); // 2100

final var ret1 = year.minusYears(1);
System.out.println(ret1); // 2099

final var ret2 = year.minusYears(2);
System.out.println(ret2); // 2098

final var ret3 = year.minusYears(3000);
System.out.println(ret3); // -900

static Year now ()

Obtiene el año actual del reloj del sistema en la zona horaria predeterminada. (Traducción automática)

final var year = Year.now();
System.out.println(year); // 2024

static Year now (Clock clock)

Obtiene el año actual del reloj especificado. (Traducción automática)

// A clock advanced 1 year.
final var clock = Clock.offset(Clock.systemDefaultZone(), Duration.ofDays(365));

System.out.println(Year.now()); // 2024
System.out.println(Year.now(clock)); // 2025

static Year now (ZoneId zone)

Obtiene el año actual del reloj del sistema en la zona horaria especificada. (Traducción automática)

final var zone = ZoneId.systemDefault();
System.out.println(zone); // America/Los_Angeles

System.out.println(Year.now(zone)); // 2024

static Year of (int isoYear)

Obtiene una instancia de Año. (Traducción automática)

final var year1 = Year.of(2100);
System.out.println(year1); // 2100

final var year2 = Year.of(1800);
System.out.println(year2); // 1800

final var year3 = Year.of(-100);
System.out.println(year3); // -100

static Year parse (CharSequence text)

Obtiene una instancia de Año a partir de una cadena de texto como 2007. (Traducción automática)

final var year1 = Year.parse("2100");
System.out.println(year1); // 2100

final var year2 = Year.parse("1800");
System.out.println(year2); // 1800

final var year3 = Year.parse("-100");
System.out.println(year3); // -100

static Year parse (CharSequence text, DateTimeFormatter formatter)

Obtiene una instancia de Año a partir de una cadena de texto utilizando un formateador específico. (Traducción automática)

final var year1 = Year.parse("2100", DateTimeFormatter.ofPattern("yyyy"));
System.out.println(year1); // 2100

final var year2 = Year.parse("99", DateTimeFormatter.ofPattern("yy"));
System.out.println(year2); // 2099

Year plus (long amountToAdd, TemporalUnit unit)

Devuelve una copia de este año con la cantidad especificada agregada. (Traducción automática)

final var year = Year.of(2100);
System.out.println(year); // 2100

final var ret1 = year.plus(1, ChronoUnit.YEARS);
System.out.println(ret1); // 2101

final var ret2 = year.plus(2, ChronoUnit.YEARS);
System.out.println(ret2); // 2102

final var ret3 = year.plus(7900, ChronoUnit.YEARS);
System.out.println(ret3); // 10000
final var year = Year.of(2100);
System.out.println(year); // 2100

final var ret1 = year.plus(1, ChronoUnit.DECADES);
System.out.println(ret1); // 2110

final var ret2 = year.plus(1, ChronoUnit.CENTURIES);
System.out.println(ret2); // 2200

final var ret3 = year.plus(1, ChronoUnit.MILLENNIA);
System.out.println(ret3); // 3100

Year plus (TemporalAmount amountToAdd)

Devuelve una copia de este año con la cantidad especificada agregada. (Traducción automática)

final var year = Year.of(2100);
System.out.println(year); // 2100

final var period = Period.ofYears(20);
System.out.println(period); // P20Y

final var ret = year.plus(period);
System.out.println(ret); // 2120

Year plusYears (long yearsToAdd)

Devuelve una copia de este año con el número especificado de años agregados. (Traducción automática)

final var year = Year.of(2100);
System.out.println(year); // 2100

final var ret1 = year.plusYears(1);
System.out.println(ret1); // 2101

final var ret2 = year.plusYears(2);
System.out.println(ret2); // 2102

final var ret3 = year.plusYears(7900);
System.out.println(ret3); // 10000

<R> R query (TemporalQuery<R> query)

Consultas este año utilizando la consulta especificada. (Traducción automática)

final var year = Year.of(2100);
System.out.println(year); // 2100

final var ret = year.query(TemporalQueries.precision());
System.out.println(ret); // Years

ValueRange range (TemporalField field)

Obtiene el rango de valores válidos para el campo especificado. (Traducción automática)

final var year = Year.of(2100);
System.out.println(year); // 2100

System.out.println(year.range(ChronoField.YEAR)); // -999999999 - 999999999
System.out.println(year.range(ChronoField.YEAR_OF_ERA)); // 1 - 999999999
System.out.println(year.range(ChronoField.ERA)); // 0 - 1

String toString ()

Salida este año como una cadena. (Traducción automática)

final var str1 = Year.of(1800).toString();
System.out.println(str1); // 1800

final var str2 = Year.of(2100).toString();
System.out.println(str2); // 2100

final var str3 = Year.of(-100).toString();
System.out.println(str3); // -100

long until (Temporal endExclusive, TemporalUnit unit)

Calcula la cantidad de tiempo hasta otro año en términos de la unidad especificada. (Traducción automática)

final var start = Year.of(2100);
System.out.println(start); // 2100

final var end = Year.of(2150);
System.out.println(end); // 2150

final var ret1 = start.until(end, ChronoUnit.YEARS);
System.out.println(ret1); // 50

final var ret2 = start.until(end, ChronoUnit.DECADES);
System.out.println(ret2); // 5

Year with (TemporalAdjuster adjuster)

Devuelve una copia ajustada de este año. (Traducción automática)

final var year = Year.of(2100);
System.out.println(year); // 2100

final var ret = year.with(
        temporal -> Year.of(temporal.get(ChronoField.YEAR) * 2));
System.out.println(ret); // 4200

Year with (TemporalField field, long newValue)

Devuelve una copia de este año con el campo especificado establecido en un nuevo valor. (Traducción automática)

final var year = Year.of(2100);
System.out.println(year); // 2100

final var ret = year.with(ChronoField.YEAR, 1800);
System.out.println(ret); // 1800

Related posts

To top of page