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 :

Este artículo puede utilizar software de traducción para su comodidad. Consulte también la versión original en inglés.

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

Ejemplos de API
- Calendar
- ChronoLocalDate
- ChronoLocalDateTime
- ChronoZonedDateTime
- Clock
- Date
- DateTimeException
- DateTimeParseException
- DayOfWeek
- Duration
- Era
  - IsoEra
  - JapaneseEra
- Instant
- InstantSource
- JapaneseDate
- LocalDate
- LocalDateTime
- LocalTime
- Month
- MonthDay
- OffsetDateTime
- OffsetTime
- Period
- Temporal
- TemporalAccessor
- TemporalAdjuster
- TemporalAdjusters
- TimeZone
- YearMonth
- ZonedDateTime
- ZoneId
- ZoneOffset

Java : Year con ejemplos

Summary

Fields

static final int MAX_VALUE

static final int MIN_VALUE

Methods

Temporal adjustInto (Temporal temporal)

LocalDate atDay (int dayOfYear)

YearMonth atMonth (int month)

YearMonth atMonth (Month month)

LocalDate atMonthDay (MonthDay monthDay)

int compareTo (Year other)

boolean equals (Object obj)

String format (DateTimeFormatter formatter)

static Year from (TemporalAccessor temporal)

int get (TemporalField field)

long getLong (TemporalField field)

int getValue ()

int hashCode ()

boolean isAfter (Year other)

boolean isBefore (Year other)

boolean isLeap ()

static boolean isLeap (long year)

boolean isSupported (TemporalField field)

boolean isSupported (TemporalUnit unit)

boolean isValidMonthDay (MonthDay monthDay)

int length ()

Year minus (long amountToSubtract, TemporalUnit unit)

Year minus (TemporalAmount amountToSubtract)

Year minusYears (long yearsToSubtract)

static Year now ()

static Year now (Clock clock)

static Year now (ZoneId zone)

static Year of (int isoYear)

static Year parse (CharSequence text)

static Year parse (CharSequence text, DateTimeFormatter formatter)

Year plus (long amountToAdd, TemporalUnit unit)

Year plus (TemporalAmount amountToAdd)

Year plusYears (long yearsToAdd)

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

ValueRange range (TemporalField field)

String toString ()

long until (Temporal endExclusive, TemporalUnit unit)

Year with (TemporalAdjuster adjuster)

Year with (TemporalField field, long newValue)

Related posts