ChronoUnit
Stay organized with collections
Save and categorize content based on your preferences.
A standard set of date periods units.
This set of units provide unit-based access to manipulate a date, time or date-time.
The standard set of units can be extended by implementing TemporalUnit.
These units are intended to be applicable in multiple calendar systems.
For example, most non-ISO calendar systems define units of years, months and days,
just with slightly different rules.
The documentation of each unit explains how it operates.
Inherited Method Summary
From class
java.lang.Enum
|
final
Object
|
clone()
Throws CloneNotSupportedException.
|
|
final
int
|
|
|
final
boolean
|
equals( Object other)
Returns true if the specified object is equal to this
enum constant.
|
|
final
void
|
finalize()
enum classes cannot have finalize methods.
|
|
final
Class<ChronoUnit>
|
getDeclaringClass()
Returns the Class object corresponding to this enum constant's
enum type.
|
|
final
int
|
hashCode()
Returns a hash code for this enum constant.
|
|
final
String
|
name()
Returns the name of this enum constant, exactly as declared in its
enum declaration.
|
|
final
int
|
ordinal()
Returns the ordinal of this enumeration constant (its position
in its enum declaration, where the initial constant is assigned
an ordinal of zero).
|
|
String
|
toString()
Returns the name of this enum constant, as contained in the
declaration.
|
|
static
<T extends Enum<T>>
T
|
valueOf( Class<T> enumType, String name)
Returns the enum constant of the specified enum type with the
specified name.
|
From class
java.lang.Object
|
Object
|
clone()
Creates and returns a copy of this Object.
|
|
boolean
|
equals( Object obj)
Compares this instance with the specified object and indicates if they
are equal.
|
|
void
|
finalize()
Invoked when the garbage collector has detected that this instance is no longer reachable.
|
|
final
Class<?>
|
getClass()
Returns the unique instance of Class that represents this
object's class.
|
|
int
|
hashCode()
Returns an integer hash code for this object.
|
|
final
void
|
notify()
Causes a thread which is waiting on this object's monitor (by means of
calling one of the wait() methods) to be woken up.
|
|
final
void
|
notifyAll()
Causes all threads which are waiting on this object's monitor (by means
of calling one of the wait() methods) to be woken up.
|
|
String
|
toString()
Returns a string containing a concise, human-readable description of this
object.
|
|
final
void
|
wait(long timeout, int nanos)
Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the
specified timeout expires.
|
|
final
void
|
wait(long timeout)
Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the
specified timeout expires.
|
|
final
void
|
wait()
Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object.
|
From interface
java.time.temporal.TemporalUnit
|
abstract
<R extends Temporal>
R
|
addTo(R temporal, long amount)
Returns a copy of the specified temporal object with the specified period added.
|
|
abstract
long
|
between( Temporal temporal1Inclusive, Temporal temporal2Exclusive)
Calculates the amount of time between two temporal objects.
|
|
abstract
Duration
|
getDuration()
Gets the duration of this unit, which may be an estimate.
|
|
abstract
boolean
|
isDateBased()
Checks if this unit represents a component of a date.
|
|
abstract
boolean
|
|
|
boolean
|
|
|
abstract
boolean
|
isTimeBased()
Checks if this unit represents a component of a time.
|
|
abstract
String
|
toString()
Gets a descriptive name for the unit.
|
Enum Values
public
static
final
ChronoUnit
CENTURIES
Unit that represents the concept of a century.
For the ISO calendar system, it is equal to 100 years.
When used with other calendar systems it must correspond to an integral number of days
and is normally an integral number of years.
public
static
final
ChronoUnit
DAYS
Unit that represents the concept of a day.
For the ISO calendar system, it is the standard day from midnight to midnight.
The estimated duration of a day is 24 Hours.
When used with other calendar systems it must correspond to the day defined by
the rising and setting of the Sun on Earth. It is not required that days begin
at midnight - when converting between calendar systems, the date should be
equivalent at midday.
public
static
final
ChronoUnit
DECADES
Unit that represents the concept of a decade.
For the ISO calendar system, it is equal to 10 years.
When used with other calendar systems it must correspond to an integral number of days
and is normally an integral number of years.
public
static
final
ChronoUnit
ERAS
Unit that represents the concept of an era.
The ISO calendar system doesn't have eras thus it is impossible to add
an era to a date or date-time.
The estimated duration of the era is artificially defined as 1,000,000,000 Years.
When used with other calendar systems there are no restrictions on the unit.
public
static
final
ChronoUnit
FOREVER
Artificial unit that represents the concept of forever.
This is primarily used with TemporalField to represent unbounded fields
such as the year or era.
The estimated duration of the era is artificially defined as the largest duration
supported by Duration.
public
static
final
ChronoUnit
HALF_DAYS
Unit that represents the concept of half a day, as used in AM/PM.
For the ISO calendar system, it is equal to 12 hours.
public
static
final
ChronoUnit
HOURS
Unit that represents the concept of an hour.
For the ISO calendar system, it is equal to 60 minutes.
public
static
final
ChronoUnit
MICROS
Unit that represents the concept of a microsecond.
For the ISO calendar system, it is equal to the 1,000,000th part of the second unit.
public
static
final
ChronoUnit
MILLENNIA
Unit that represents the concept of a millennium.
For the ISO calendar system, it is equal to 1000 years.
When used with other calendar systems it must correspond to an integral number of days
and is normally an integral number of years.
public
static
final
ChronoUnit
MILLIS
Unit that represents the concept of a millisecond.
For the ISO calendar system, it is equal to the 1000th part of the second unit.
public
static
final
ChronoUnit
MINUTES
Unit that represents the concept of a minute.
For the ISO calendar system, it is equal to 60 seconds.
public
static
final
ChronoUnit
MONTHS
Unit that represents the concept of a month.
For the ISO calendar system, the length of the month varies by month-of-year.
The estimated duration of a month is one twelfth of 365.2425 Days.
When used with other calendar systems it must correspond to an integral number of days.
public
static
final
ChronoUnit
NANOS
Unit that represents the concept of a nanosecond, the smallest supported unit of time.
For the ISO calendar system, it is equal to the 1,000,000,000th part of the second unit.
public
static
final
ChronoUnit
SECONDS
Unit that represents the concept of a second.
For the ISO calendar system, it is equal to the second in the SI system
of units, except around a leap-second.
public
static
final
ChronoUnit
WEEKS
Unit that represents the concept of a week.
For the ISO calendar system, it is equal to 7 days.
When used with other calendar systems it must correspond to an integral number of days.
public
static
final
ChronoUnit
YEARS
Unit that represents the concept of a year.
For the ISO calendar system, it is equal to 12 months.
The estimated duration of a year is 365.2425 Days.
When used with other calendar systems it must correspond to an integral number of days
or months roughly equal to a year defined by the passage of the Earth around the Sun.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-07-10 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-07-10 UTC."],[[["`ChronoUnit` is a standard set of date and time units used for manipulating dates, times, and date-times."],["These units are designed to work with various calendar systems, such as ISO and non-ISO calendars."],["You can extend the standard set by implementing the `TemporalUnit` interface."],["`ChronoUnit` provides units like years, months, days, hours, minutes, seconds, and more for date and time calculations."],["This enum offers methods to add, calculate differences, and check support for these units within temporal objects."]]],["`ChronoUnit` is a standard set of date period units for manipulating dates, times, or date-times, applicable across multiple calendar systems. It extends `Enum` and implements `TemporalUnit`. Key actions include comparing units with `compareTo`, adding periods with `addTo`, and calculating time between with `between`. It defines units like `DAYS`, `MONTHS`, `YEARS`, and others like `MICROS`, `NANOS`, `FOREVER`. These units work in various calendar systems, but each must have rules for its operation.\n"]]
