Java : Instant con ejemplos

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

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 punto instantáneo en la línea del tiempo. (Traducción automática)

Class diagram

final var instant = Instant.ofEpochSecond(0);

System.out.println(instant); // 1970-01-01T00:00:00Z
System.out.println(instant.getEpochSecond()); // 0

final var instant = Instant.ofEpochSecond(4102444800L);

System.out.println(instant); // 2100-01-01T00:00:00Z
System.out.println(instant.getEpochSecond()); // 4102444800

Fields

static final Instant EPOCH

Constante para el instante de la época 1970-01-01T00:00:00Z. (Traducción automática)

System.out.println(Instant.EPOCH); // 1970-01-01T00:00:00Z

static final Instant MAX

El instantáneo máximo admitido, '1000000000-12-31T23:59:59.999999999Z'. (Traducción automática)

System.out.println(Instant.MAX); // +1000000000-12-31T23:59:59.999999999Z

static final Instant MIN

El instantáneo mínimo admitido, '-1000000000-01-01T00:00Z'. (Traducción automática)

System.out.println(Instant.MIN); // -1000000000-01-01T00:00:00Z

Methods

Temporal adjustInto (Temporal temporal)

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

final var instant = Instant.ofEpochSecond(4102444800L);
System.out.println(instant); // 2100-01-01T00:00:00Z

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

    final var dateTime = ZonedDateTime.of(2150, 2, 3, 12, 30, 59, 0, zone);
    System.out.println(dateTime); // 2150-02-03T12:30:59-08:00[America/Los_Angeles]

    System.out.println(instant.adjustInto(dateTime)); // 2099-12-31T16:00-08:00[America/Los_Angeles]
}
{
    final var offset = ZoneOffset.ofHours(9);
    System.out.println(offset); // +09:00

    final var dateTime = OffsetDateTime.of(2150, 2, 3, 12, 30, 59, 0, offset);
    System.out.println(dateTime); // 2150-02-03T12:30:59+09:00

    System.out.println(instant.adjustInto(dateTime)); // 2100-01-01T09:00+09:00
}

final var instant = Instant.ofEpochSecond(0);
System.out.println(instant); // 1970-01-01T00:00:00Z

final var dateTime = LocalDateTime.of(2100, 1, 1, 0, 0);
System.out.println(dateTime); // 2100-01-01T00:00

try {
    final var ret = instant.adjustInto(dateTime);
} catch (UnsupportedTemporalTypeException e) {
    System.out.println("UnsupportedTemporalTypeException! : " + e.getMessage());
}

// Result
// ↓
//UnsupportedTemporalTypeException! : Unsupported field: InstantSeconds

OffsetDateTime atOffset (ZoneOffset offset)

Combina este instante con un desplazamiento para crear un OffsetDateTime. (Traducción automática)

final var instant = Instant.ofEpochSecond(4102444800L);
System.out.println(instant); // 2100-01-01T00:00:00Z

final var ret1 = instant.atOffset(ZoneOffset.UTC);
System.out.println(ret1); // 2100-01-01T00:00Z

final var ret2 = instant.atOffset(ZoneOffset.ofHours(9));
System.out.println(ret2); // 2100-01-01T09:00+09:00

final var ret3 = instant.atOffset(ZoneOffset.ofHoursMinutes(-4, -30));
System.out.println(ret3); // 2099-12-31T19:30-04:30

ZonedDateTime atZone (ZoneId zone)

Combina este instante con una zona horaria para crear un ZonedDateTime. (Traducción automática)

final var instant = Instant.ofEpochSecond(4102444800L);
System.out.println(instant); // 2100-01-01T00:00:00Z

final var ret1 = instant.atZone(ZoneId.systemDefault());
System.out.println(ret1); // 2099-12-31T16:00-08:00[America/Los_Angeles]

final var ret2 = instant.atZone(ZoneId.of("Asia/Tokyo"));
System.out.println(ret2); // 2100-01-01T09:00+09:00[Asia/Tokyo]

final var ret3 = instant.atZone(ZoneOffset.UTC);
System.out.println(ret3); // 2100-01-01T00:00Z

int compareTo (Instant otherInstant)

Compara este instante con el instante especificado. (Traducción automática)

final var instant1 = Instant.ofEpochSecond(4102444800L);
final var instant2 = Instant.ofEpochSecond(4102444800L);

System.out.println(instant1); // 2100-01-01T00:00:00Z
System.out.println(instant2); // 2100-01-01T00:00:00Z
System.out.println(instant1.compareTo(instant2)); // 0

final var instant1 = Instant.ofEpochSecond(4102444800L);
final var instant2 = Instant.ofEpochSecond(4102444800L + 1);

System.out.println(instant1); // 2100-01-01T00:00:00Z
System.out.println(instant2); // 2100-01-01T00:00:01Z
System.out.println(instant1.compareTo(instant2)); // -1

final var instant1 = Instant.ofEpochMilli(0L);
final var instant2 = Instant.ofEpochMilli(-1L);

System.out.println(instant1); // 1970-01-01T00:00:00Z
System.out.println(instant2); // 1969-12-31T23:59:59.999Z
System.out.println(instant1.compareTo(instant2)); // 1

System.out.println(Instant.MIN); // -1000000000-01-01T00:00:00Z
System.out.println(Instant.MAX); // +1000000000-12-31T23:59:59.999999999Z
System.out.println(Instant.MIN.compareTo(Instant.MAX)); // -1

boolean equals (Object other)

Comprueba si este instante es igual al instante especificado. (Traducción automática)

final var instant1 = Instant.ofEpochSecond(4102444800L);
final var instant2 = Instant.ofEpochSecond(4102444800L);

System.out.println(instant1); // 2100-01-01T00:00:00Z
System.out.println(instant2); // 2100-01-01T00:00:00Z
System.out.println(instant1.equals(instant2)); // true

final var instant1 = Instant.ofEpochSecond(4102444800L);
final var instant2 = Instant.ofEpochSecond(4102444800L + 1);

System.out.println(instant1); // 2100-01-01T00:00:00Z
System.out.println(instant2); // 2100-01-01T00:00:01Z
System.out.println(instant1.equals(instant2)); // false

final var instant1 = Instant.ofEpochMilli(0L);
final var instant2 = Instant.ofEpochMilli(-1L);

System.out.println(instant1); // 1970-01-01T00:00:00Z
System.out.println(instant2); // 1969-12-31T23:59:59.999Z
System.out.println(instant1.equals(instant2)); // false

System.out.println(Instant.MIN); // -1000000000-01-01T00:00:00Z
System.out.println(Instant.MAX); // +1000000000-12-31T23:59:59.999999999Z
System.out.println(Instant.MIN.equals(Instant.MAX)); // false

static Instant from (TemporalAccessor temporal)

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

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

final var temporal = ZonedDateTime.of(2100, 1, 1, 0, 0, 0, 0, zone);
System.out.println(temporal); // 2100-01-01T00:00-08:00[America/Los_Angeles]

System.out.println(Instant.from(temporal)); // 2100-01-01T08:00:00Z

final var zone = ZoneOffset.UTC;
System.out.println(zone); // Z

final var temporal = ZonedDateTime.of(2100, 1, 1, 12, 30, 0, 0, zone);
System.out.println(temporal); // 2100-01-01T12:30Z

System.out.println(Instant.from(temporal)); // 2100-01-01T12:30:00Z

final var offset = ZoneOffset.ofHours(-4);
System.out.println(offset); // -04:00

final var temporal = OffsetDateTime.of(2100, 1, 1, 0, 0, 0, 0, offset);
System.out.println(temporal); // 2100-01-01T00:00-04:00

System.out.println(Instant.from(temporal)); // 2100-01-01T04:00:00Z

final var temporal = LocalDateTime.of(2100, 1, 1, 0, 0);
System.out.println(temporal); // 2100-01-01T00:00

try {
    final var ret = Instant.from(temporal);
} catch (DateTimeException e) {
    System.out.println("DateTimeException! : " + e.getMessage());
}

// Result
// ↓
//DateTimeException! : Unable to obtain Instant from TemporalAccessor:
// 2100-01-01T00:00 of type java.time.LocalDateTime

int get (TemporalField field)

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

Please see also : getLong(TemporalField field)

final var instant = Instant.ofEpochMilli(4102444800123L);
System.out.println(instant); // 2100-01-01T00:00:00.123Z

System.out.println(instant.get(ChronoField.MILLI_OF_SECOND)); // 123
System.out.println(instant.get(ChronoField.MICRO_OF_SECOND)); // 123000
System.out.println(instant.get(ChronoField.NANO_OF_SECOND)); // 123000000

try {
    final var ret = instant.get(ChronoField.INSTANT_SECONDS);
} catch (UnsupportedTemporalTypeException e) {
    System.out.println("UnsupportedTemporalTypeException! : " + e.getMessage());
}

// Result
// ↓
//UnsupportedTemporalTypeException! : Unsupported field: InstantSeconds

long getEpochSecond ()

Obtiene el número de segundos de la época de Java de 1970-01-01T00:00:00Z. (Traducción automática)

final var instant = Instant.ofEpochSecond(4102444800L);
System.out.println(instant); // 2100-01-01T00:00:00Z

System.out.println(instant.getEpochSecond()); // 4102444800

final var dateTime = ZonedDateTime.of(2099, 1, 1, 0, 0, 0, 0, ZoneOffset.UTC);
System.out.println(dateTime); // 2099-01-01T00:00Z

final var instant = dateTime.toInstant();
System.out.println(instant.getEpochSecond()); // 4070908800

System.out.println(Instant.MIN.getEpochSecond()); // -31557014167219200
System.out.println(Instant.EPOCH.getEpochSecond()); // 0
System.out.println(Instant.MAX.getEpochSecond()); // 31556889864403199

long getLong (TemporalField field)

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

final var instant = Instant.ofEpochMilli(4102444800123L);
System.out.println(instant); // 2100-01-01T00:00:00.123Z

System.out.println(instant.getLong(ChronoField.INSTANT_SECONDS)); // 4102444800

System.out.println(instant.getLong(ChronoField.MILLI_OF_SECOND)); // 123
System.out.println(instant.getLong(ChronoField.MICRO_OF_SECOND)); // 123000
System.out.println(instant.getLong(ChronoField.NANO_OF_SECOND)); // 123000000

int getNano ()

Obtiene el número de nanosegundos, más adelante en la línea de tiempo, desde el inicio del segundo. (Traducción automática)

final var instant = Instant.ofEpochSecond(4102444800L, 123456789L);
System.out.println(instant); // 2100-01-01T00:00:00.123456789Z

System.out.println(instant.getNano()); // 123456789

final var instant = Instant.ofEpochMilli(4102444800123L);
System.out.println(instant); // 2100-01-01T00:00:00.123Z

System.out.println(instant.getNano()); // 123000000

int hashCode ()

Devuelve un código hash para este instante. (Traducción automática)

final var instant = Instant.ofEpochSecond(4102444800L);
System.out.println(instant); // 2100-01-01T00:00:00Z
System.out.println(instant.hashCode()); // -192522496

System.out.println(Instant.MIN.hashCode()); // -336857328
System.out.println(Instant.EPOCH.hashCode()); // 0
System.out.println(Instant.MAX.hashCode()); // -625237510

boolean isAfter (Instant otherInstant)

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

final var instant = Instant.ofEpochSecond(4102444800L);
System.out.println(instant); // 2100-01-01T00:00:00Z

final var instant2 = Instant.ofEpochSecond(4102444800L - 1);
final var instant3 = Instant.ofEpochSecond(4102444800L);
final var instant4 = Instant.ofEpochSecond(4102444800L + 1);

System.out.println(instant2); // 2099-12-31T23:59:59Z
System.out.println(instant3); // 2100-01-01T00:00:00Z
System.out.println(instant4); // 2100-01-01T00:00:01Z

System.out.println(instant.isAfter(instant2)); // true
System.out.println(instant.isAfter(instant3)); // false
System.out.println(instant.isAfter(instant4)); // false

final var instant = Instant.ofEpochSecond(0, 0);
System.out.println(instant); // 1970-01-01T00:00:00Z

final var instant2 = Instant.ofEpochSecond(0, -1);
final var instant3 = Instant.ofEpochSecond(0, 0);
final var instant4 = Instant.ofEpochSecond(0, 1);

System.out.println(instant2); // 1969-12-31T23:59:59.999999999Z
System.out.println(instant3); // 1970-01-01T00:00:00Z
System.out.println(instant4); // 1970-01-01T00:00:00.000000001Z

System.out.println(instant.isAfter(instant2)); // true
System.out.println(instant.isAfter(instant3)); // false
System.out.println(instant.isAfter(instant4)); // false

boolean isBefore (Instant otherInstant)

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

final var instant = Instant.ofEpochSecond(4102444800L);
System.out.println(instant); // 2100-01-01T00:00:00Z

final var instant2 = Instant.ofEpochSecond(4102444800L - 1);
final var instant3 = Instant.ofEpochSecond(4102444800L);
final var instant4 = Instant.ofEpochSecond(4102444800L + 1);

System.out.println(instant2); // 2099-12-31T23:59:59Z
System.out.println(instant3); // 2100-01-01T00:00:00Z
System.out.println(instant4); // 2100-01-01T00:00:01Z

System.out.println(instant.isBefore(instant2)); // false
System.out.println(instant.isBefore(instant3)); // false
System.out.println(instant.isBefore(instant4)); // true

final var instant = Instant.ofEpochSecond(0, 0);
System.out.println(instant); // 1970-01-01T00:00:00Z

final var instant2 = Instant.ofEpochSecond(0, -1);
final var instant3 = Instant.ofEpochSecond(0, 0);
final var instant4 = Instant.ofEpochSecond(0, 1);

System.out.println(instant2); // 1969-12-31T23:59:59.999999999Z
System.out.println(instant3); // 1970-01-01T00:00:00Z
System.out.println(instant4); // 1970-01-01T00:00:00.000000001Z

System.out.println(instant.isBefore(instant2)); // false
System.out.println(instant.isBefore(instant3)); // false
System.out.println(instant.isBefore(instant4)); // true

boolean isSupported (TemporalField field)

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

final var instant = Instant.ofEpochSecond(4102444800L);
System.out.println(instant); // 2100-01-01T00:00:00Z

System.out.println(instant.isSupported(ChronoField.INSTANT_SECONDS)); // true

System.out.println(instant.isSupported(ChronoField.MILLI_OF_SECOND)); // true
System.out.println(instant.isSupported(ChronoField.MICRO_OF_SECOND)); // true
System.out.println(instant.isSupported(ChronoField.NANO_OF_SECOND)); // true

System.out.println(instant.isSupported(ChronoField.NANO_OF_DAY)); // false
System.out.println(instant.isSupported(ChronoField.YEAR)); // false
System.out.println(instant.isSupported(ChronoField.HOUR_OF_DAY)); // false

boolean isSupported (TemporalUnit unit)

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

final var instant = Instant.ofEpochSecond(4102444800L);
System.out.println(instant); // 2100-01-01T00:00:00Z

System.out.println(instant.isSupported(ChronoUnit.YEARS)); // false
System.out.println(instant.isSupported(ChronoUnit.MONTHS)); // false

System.out.println(instant.isSupported(ChronoUnit.DAYS)); // true
System.out.println(instant.isSupported(ChronoUnit.HOURS)); // true
System.out.println(instant.isSupported(ChronoUnit.MINUTES)); // true
System.out.println(instant.isSupported(ChronoUnit.SECONDS)); // true
System.out.println(instant.isSupported(ChronoUnit.MILLIS)); // true
System.out.println(instant.isSupported(ChronoUnit.MICROS)); // true
System.out.println(instant.isSupported(ChronoUnit.NANOS)); // true

Instant minus (long amountToSubtract, TemporalUnit unit)

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

final var instant = Instant.ofEpochSecond(4102444800L);
System.out.println(instant); // 2100-01-01T00:00:00Z

System.out.println(instant.minus(1, ChronoUnit.DAYS)); // 2099-12-31T00:00:00Z
System.out.println(instant.minus(2, ChronoUnit.HOURS)); // 2099-12-31T22:00:00Z
System.out.println(instant.minus(3, ChronoUnit.MINUTES)); // 2099-12-31T23:57:00Z
System.out.println(instant.minus(4, ChronoUnit.SECONDS)); // 2099-12-31T23:59:56Z

final var instant = Instant.ofEpochSecond(4102444800L);
System.out.println(instant); // 2100-01-01T00:00:00Z

System.out.println(instant.minus(1, ChronoUnit.MILLIS)); // 2099-12-31T23:59:59.999Z
System.out.println(instant.minus(2, ChronoUnit.MICROS)); // 2099-12-31T23:59:59.999998Z
System.out.println(instant.minus(3, ChronoUnit.NANOS)); // 2099-12-31T23:59:59.999999997Z

Instant minus (TemporalAmount amountToSubtract)

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

final var instant = Instant.ofEpochSecond(4102444800L);
System.out.println(instant); // 2100-01-01T00:00:00Z

System.out.println(instant.minus(Period.ofDays(1))); // 2099-12-31T00:00:00Z
System.out.println(instant.minus(Duration.ofHours(2))); // 2099-12-31T22:00:00Z
System.out.println(instant.minus(Duration.ofMinutes(3))); // 2099-12-31T23:57:00Z
System.out.println(instant.minus(Duration.ofSeconds(4))); // 2099-12-31T23:59:56Z

final var instant = Instant.ofEpochSecond(4102444800L);
System.out.println(instant); // 2100-01-01T00:00:00Z

System.out.println(instant.minus(Duration.ofMillis(1))); // 2099-12-31T23:59:59.999Z
System.out.println(instant.minus(Duration.ofNanos(2))); // 2099-12-31T23:59:59.999999998Z

Instant minusMillis (long millisToSubtract)

Devuelve una copia de este instante con la duración especificada en milisegundos restada. (Traducción automática)

final var instant = Instant.ofEpochSecond(4102444800L);
System.out.println(instant); // 2100-01-01T00:00:00Z

System.out.println(instant.minusMillis(1)); // 2099-12-31T23:59:59.999Z
System.out.println(instant.minusMillis(2)); // 2099-12-31T23:59:59.998Z
System.out.println(instant.minusMillis(1000)); // 2099-12-31T23:59:59Z

Instant minusNanos (long nanosToSubtract)

Devuelve una copia de este instante con la duración especificada en nanosegundos restada. (Traducción automática)

final var instant = Instant.ofEpochSecond(4102444800L);
System.out.println(instant); // 2100-01-01T00:00:00Z

System.out.println(instant.minusNanos(1)); // 2099-12-31T23:59:59.999999999Z
System.out.println(instant.minusNanos(2)); // 2099-12-31T23:59:59.999999998Z
System.out.println(instant.minusNanos(1000)); // 2099-12-31T23:59:59.999999Z
System.out.println(instant.minusNanos(1000 * 1000)); // 2099-12-31T23:59:59.999Z

Instant minusSeconds (long secondsToSubtract)

Devuelve una copia de este instante con la duración especificada en segundos restada. (Traducción automática)

final var instant = Instant.ofEpochSecond(4102444800L);
System.out.println(instant); // 2100-01-01T00:00:00Z

System.out.println(instant.minusSeconds(1)); // 2099-12-31T23:59:59Z
System.out.println(instant.minusSeconds(2)); // 2099-12-31T23:59:58Z
System.out.println(instant.minusSeconds(60)); // 2099-12-31T23:59:00Z

static Instant now ()

Obtiene el instante actual del reloj del sistema. (Traducción automática)

final var now = Instant.now();
System.out.println(now); // 2024-05-04T07:50:20.071519600Z

static Instant now (Clock clock)

Obtiene el instante actual del reloj especificado. (Traducción automática)

// A clock advanced 5 days.
final var clock = Clock.offset(Clock.systemUTC(), Duration.ofDays(5));

System.out.println(Instant.now()); // 2024-05-04T07:53:47.517010100Z
System.out.println(Instant.now(clock)); // 2024-05-09T07:53:47.520005100Z

static Instant ofEpochMilli (long epochMilli)

Obtiene una instancia de Instant usando milisegundos de la época 1970-01-01T00:00:00Z. (Traducción automática)

System.out.println(Instant.ofEpochMilli(0)); // 1970-01-01T00:00:00Z
System.out.println(Instant.ofEpochMilli(4102444800000L)); // 2100-01-01T00:00:00Z
System.out.println(Instant.ofEpochMilli(4102444800123L)); // 2100-01-01T00:00:00.123Z

static Instant ofEpochSecond (long epochSecond)

Obtiene una instancia de Instant usando segundos de la época 1970-01-01T00:00:00Z. (Traducción automática)

System.out.println(Instant.ofEpochSecond(0)); // 1970-01-01T00:00:00Z
System.out.println(Instant.ofEpochSecond(1)); // 1970-01-01T00:00:01Z
System.out.println(Instant.ofEpochSecond(-1)); // 1969-12-31T23:59:59Z
System.out.println(Instant.ofEpochSecond(60)); // 1970-01-01T00:01:00Z
System.out.println(Instant.ofEpochSecond(60 * 60 * 24)); // 1970-01-02T00:00:00Z

System.out.println(Instant.ofEpochSecond(4102444800L)); // 2100-01-01T00:00:00Z

static Instant ofEpochSecond (long epochSecond, long nanoAdjustment)

Obtiene una instancia de Instant usando segundos de la época 1970-01-01T00:00:00Z y una fracción de nanosegundo de segundo. (Traducción automática)

final var instant1 = Instant.ofEpochSecond(0, 0);
System.out.println(instant1); // 1970-01-01T00:00:00Z

final var instant2 = Instant.ofEpochSecond(0, 123);
System.out.println(instant2); // 1970-01-01T00:00:00.000000123Z

final var instant3 = Instant.ofEpochSecond(4102444800L, 123456789L);
System.out.println(instant3); // 2100-01-01T00:00:00.123456789Z

static Instant parse (CharSequence text)

Obtiene una instancia de Instant a partir de una cadena de texto como 2007-12-03T10:15:30.00Z. (Traducción automática)

final var instant1 = Instant.parse("2100-12-03T10:15:30Z");
System.out.println(instant1); // 2100-12-03T10:15:30Z

final var instant2 = Instant.parse("1970-01-01T00:00:00.123456789Z");
System.out.println(instant2); // 1970-01-01T00:00:00.123456789Z

final var instant3 = Instant.parse("2100-05-01T00:00:00+09:00");
System.out.println(instant3); // 2100-04-30T15:00:00Z

try {
    final var ret = Instant.parse("2100/5/1 00:00");
} catch (DateTimeParseException e) {
    System.out.println("DateTimeParseException! : " + e.getMessage());
}

// Result
// ↓
//DateTimeParseException! : Text '2100/5/1 00:00' could not be parsed at index 4

Instant plus (long amountToAdd, TemporalUnit unit)

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

final var instant = Instant.ofEpochSecond(4102444800L);
System.out.println(instant); // 2100-01-01T00:00:00Z

System.out.println(instant.plus(1, ChronoUnit.DAYS)); // 2100-01-02T00:00:00Z
System.out.println(instant.plus(2, ChronoUnit.HOURS)); // 2100-01-01T02:00:00Z
System.out.println(instant.plus(3, ChronoUnit.MINUTES)); // 2100-01-01T00:03:00Z
System.out.println(instant.plus(4, ChronoUnit.SECONDS)); // 2100-01-01T00:00:04Z

final var instant = Instant.ofEpochSecond(4102444800L);
System.out.println(instant); // 2100-01-01T00:00:00Z

System.out.println(instant.plus(1, ChronoUnit.MILLIS)); // 2100-01-01T00:00:00.001Z
System.out.println(instant.plus(2, ChronoUnit.MICROS)); // 2100-01-01T00:00:00.000002Z
System.out.println(instant.plus(3, ChronoUnit.NANOS)); // 2100-01-01T00:00:00.000000003Z

Instant plus (TemporalAmount amountToAdd)

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

final var instant = Instant.ofEpochSecond(4102444800L);
System.out.println(instant); // 2100-01-01T00:00:00Z

System.out.println(instant.plus(Period.ofDays(1))); // 2100-01-02T00:00:00Z
System.out.println(instant.plus(Duration.ofHours(2))); // 2100-01-01T02:00:00Z
System.out.println(instant.plus(Duration.ofMinutes(3))); // 2100-01-01T00:03:00Z
System.out.println(instant.plus(Duration.ofSeconds(4))); // 2100-01-01T00:00:04Z

final var instant = Instant.ofEpochSecond(4102444800L);
System.out.println(instant); // 2100-01-01T00:00:00Z

System.out.println(instant.plus(Duration.ofMillis(1))); // 2100-01-01T00:00:00.001Z
System.out.println(instant.plus(Duration.ofNanos(2))); // 2100-01-01T00:00:00.000000002Z

Instant plusMillis (long millisToAdd)

Devuelve una copia de este instante con la duración especificada en milisegundos agregada. (Traducción automática)

final var instant = Instant.ofEpochSecond(4102444800L);
System.out.println(instant); // 2100-01-01T00:00:00Z

System.out.println(instant.plusMillis(1)); // 2100-01-01T00:00:00.001Z
System.out.println(instant.plusMillis(2)); // 2100-01-01T00:00:00.002Z
System.out.println(instant.plusMillis(1000)); // 2100-01-01T00:00:01Z

Instant plusNanos (long nanosToAdd)

Devuelve una copia de este instante con la duración especificada en nanosegundos agregada. (Traducción automática)

final var instant = Instant.ofEpochSecond(4102444800L);
System.out.println(instant); // 2100-01-01T00:00:00Z

System.out.println(instant.plusNanos(1)); // 2100-01-01T00:00:00.000000001Z
System.out.println(instant.plusNanos(2)); // 2100-01-01T00:00:00.000000002Z
System.out.println(instant.plusNanos(1000)); // 2100-01-01T00:00:00.000001Z
System.out.println(instant.plusNanos(1000 * 1000)); // 2100-01-01T00:00:00.001Z

Instant plusSeconds (long secondsToAdd)

Devuelve una copia de este instante con la duración especificada en segundos agregados. (Traducción automática)

final var instant = Instant.ofEpochSecond(4102444800L);
System.out.println(instant); // 2100-01-01T00:00:00Z

System.out.println(instant.plusSeconds(1)); // 2100-01-01T00:00:01Z
System.out.println(instant.plusSeconds(2)); // 2100-01-01T00:00:02Z
System.out.println(instant.plusSeconds(60)); // 2100-01-01T00:01:00Z

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

Consulta en este instante utilizando la consulta especificada. (Traducción automática)

final var instant = Instant.ofEpochSecond(4102444800L);
System.out.println(instant); // 2100-01-01T00:00:00Z

System.out.println(instant.query(TemporalQueries.precision())); // Nanos

ValueRange range (TemporalField field)

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

final var instant = Instant.ofEpochSecond(4102444800L);
System.out.println(instant); // 2100-01-01T00:00:00Z

final var ret1 = instant.range(ChronoField.INSTANT_SECONDS);
System.out.println(ret1); // -9223372036854775808 - 9223372036854775807

final var ret2 = instant.range(ChronoField.MILLI_OF_SECOND);
System.out.println(ret2); // 0 - 999

final var ret3 = instant.range(ChronoField.MICRO_OF_SECOND);
System.out.println(ret3); // 0 - 999999

final var ret4 = instant.range(ChronoField.NANO_OF_SECOND);
System.out.println(ret4); // 0 - 999999999

long toEpochMilli ()

Convierte este instante al número de milisegundos de la época de 1970-01-01T00:00:00Z. (Traducción automática)

System.out.println(Instant.EPOCH); // 1970-01-01T00:00:00Z
System.out.println(Instant.EPOCH.toEpochMilli()); // 0

final var instant = Instant.ofEpochMilli(4102444800999L);
System.out.println(instant); // 2100-01-01T00:00:00.999Z

System.out.println(instant.toEpochMilli()); // 4102444800999

final var instant = Instant.ofEpochSecond(4102444800L, 123456789L);
System.out.println(instant); // 2100-01-01T00:00:00.123456789Z

System.out.println(instant.toEpochMilli()); // 4102444800123

String toString ()

Una representación de cadena de este instante utilizando la representación ISO-8601. (Traducción automática)

final var ret1 = Instant.EPOCH.toString();
System.out.println(ret1); // 1970-01-01T00:00:00Z

final var ret2 = Instant.ofEpochSecond(4102444800L).toString();
System.out.println(ret2); // 2100-01-01T00:00:00Z

final var ret3 = Instant.ofEpochSecond(4102444800L, 123456789L).toString();
System.out.println(ret3); // 2100-01-01T00:00:00.123456789Z

Instant truncatedTo (TemporalUnit unit)

Devuelve una copia de este Instante truncada a la unidad especificada. (Traducción automática)

final var instant = Instant.ofEpochSecond(4102544459L, 123456789L);
System.out.println(instant); // 2100-01-02T03:40:59.123456789Z

System.out.println(instant.truncatedTo(ChronoUnit.DAYS)); // 2100-01-02T00:00:00Z
System.out.println(instant.truncatedTo(ChronoUnit.HOURS)); // 2100-01-02T03:00:00Z
System.out.println(instant.truncatedTo(ChronoUnit.MINUTES)); // 2100-01-02T03:40:00Z
System.out.println(instant.truncatedTo(ChronoUnit.SECONDS)); // 2100-01-02T03:40:59Z
System.out.println(instant.truncatedTo(ChronoUnit.MILLIS)); // 2100-01-02T03:40:59.123Z
System.out.println(instant.truncatedTo(ChronoUnit.MICROS)); // 2100-01-02T03:40:59.123456Z
System.out.println(instant.truncatedTo(ChronoUnit.NANOS)); // 2100-01-02T03:40:59.123456789Z

long until (Temporal endExclusive, TemporalUnit unit)

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

final var instant1 = Instant.ofEpochSecond(0);
final var instant2 = Instant.ofEpochSecond(24 * 60 * 60);
System.out.println(instant1); // 1970-01-01T00:00:00Z
System.out.println(instant2); // 1970-01-02T00:00:00Z

System.out.println(instant1.until(instant2, ChronoUnit.DAYS)); // 1
System.out.println(instant1.until(instant2, ChronoUnit.HOURS)); // 24
System.out.println(instant1.until(instant2, ChronoUnit.MINUTES)); // 1440
System.out.println(instant1.until(instant2, ChronoUnit.SECONDS)); // 86400
System.out.println(instant1.until(instant2, ChronoUnit.NANOS)); // 86400000000000

Instant with (TemporalAdjuster adjuster)

Devuelve una copia ajustada de este instante. (Traducción automática)

final var instant = Instant.ofEpochSecond(100000000);
System.out.println(instant); // 1973-03-03T09:46:40Z

final var adjuster = new TemporalAdjuster() {
    @Override
    public Temporal adjustInto(Temporal temporal) {
        final var epoch = temporal.getLong(ChronoField.INSTANT_SECONDS);
        return Instant.ofEpochSecond(epoch * 5);
    }
};

final var ret = instant.with(adjuster);
System.out.println(ret); // 1985-11-05T00:53:20Z
System.out.println(ret.getEpochSecond()); // 500000000

Instant with (TemporalField field, long newValue)

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

final var instant = Instant.ofEpochSecond(4102444800L);
System.out.println(instant); // 2100-01-01T00:00:00Z

final var ret1 = instant.with(ChronoField.MILLI_OF_SECOND, 123);
System.out.println(ret1); // 2100-01-01T00:00:00.123Z

final var ret2 = instant.with(ChronoField.MICRO_OF_SECOND, 123);
System.out.println(ret2); // 2100-01-01T00:00:00.000123Z

final var ret3 = instant.with(ChronoField.NANO_OF_SECOND, 123);
System.out.println(ret3); // 2100-01-01T00:00:00.000000123Z

final var instant = Instant.ofEpochSecond(4102444800L, 123);
System.out.println(instant); // 2100-01-01T00:00:00.000000123Z

final var ret = instant.with(ChronoField.INSTANT_SECONDS, 0);
System.out.println(ret); // 1970-01-01T00:00:00.000000123Z

Ejemplos de API

Java : Instant con ejemplos

Summary

Fields

static final Instant EPOCH

static final Instant MAX

static final Instant MIN

Methods

Temporal adjustInto (Temporal temporal)

OffsetDateTime atOffset (ZoneOffset offset)

ZonedDateTime atZone (ZoneId zone)

int compareTo (Instant otherInstant)

boolean equals (Object other)

static Instant from (TemporalAccessor temporal)

int get (TemporalField field)

long getEpochSecond ()

long getLong (TemporalField field)

int getNano ()

int hashCode ()

boolean isAfter (Instant otherInstant)

boolean isBefore (Instant otherInstant)

boolean isSupported (TemporalField field)

boolean isSupported (TemporalUnit unit)

Instant minus (long amountToSubtract, TemporalUnit unit)

Instant minus (TemporalAmount amountToSubtract)

Instant minusMillis (long millisToSubtract)

Instant minusNanos (long nanosToSubtract)

Instant minusSeconds (long secondsToSubtract)

static Instant now ()

static Instant now (Clock clock)

static Instant ofEpochMilli (long epochMilli)

static Instant ofEpochSecond (long epochSecond)

static Instant ofEpochSecond (long epochSecond, long nanoAdjustment)

static Instant parse (CharSequence text)

Instant plus (long amountToAdd, TemporalUnit unit)

Instant plus (TemporalAmount amountToAdd)

Instant plusMillis (long millisToAdd)

Instant plusNanos (long nanosToAdd)

Instant plusSeconds (long secondsToAdd)

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

ValueRange range (TemporalField field)

long toEpochMilli ()

String toString ()

Instant truncatedTo (TemporalUnit unit)

long until (Temporal endExclusive, TemporalUnit unit)

Instant with (TemporalAdjuster adjuster)

Instant with (TemporalField field, long newValue)

Related posts