Adjusts the specified temporal object to have this month-day.
Adjusts the specified temporal object to have this month-day.
This returns a temporal object of the same observable type as the input with the month and day-of-month changed to be the same as this.
The adjustment is equivalent to using Temporal#with(TemporalField, long)
twice, passing ChronoField#MONTH_OF_YEAR and
ChronoField#DAY_OF_MONTH as the fields.
If the specified temporal object does not use the ISO calendar system then
a DateTimeException is thrown.
In most cases, it is clearer to reverse the calling pattern by using
Temporal#with(TemporalAdjuster):
// these two lines are equivalent, but the second approach is recommended temporal = thisMonthDay.adjustInto(temporal); temporal = temporal.with(thisMonthDay);
This instance is immutable and unaffected by this method call.
the target object to be adjusted, not null
the adjusted object, not null
if numeric overflow occurs
DateTimeExceptionif unable to make the adjustment
Combines this month-day with a year to create a LocalDate.
Combines this month-day with a year to create a LocalDate.
This returns a LocalDate formed from this month-day and the specified year.
A month-day of February 29th will be adjusted to February 28th in the resulting date if the year is not a leap year.
This instance is immutable and unaffected by this method call.
the year to use, from MIN_YEAR to MAX_YEAR
the local date formed from this month-day and the specified year, not null
if the year is outside the valid range of years
Compares this month-day to another month-day.
Compares this month-day to another month-day.
The comparison is based first on value of the month, then on the value of the day.
It is "consistent with equals", as defined by Comparable.
the other month-day to compare to, not null
the comparator value, negative if less, positive if greater
Checks if this month-day is equal to another month-day.
Checks if this month-day is equal to another month-day.
The comparison is based on the time-line position of the month-day within a year.
the object to check, null returns false
true if this is equal to the other month-day
Outputs this month-day as a String using the formatter.
Outputs this month-day as a String using the formatter.
This month-day will be passed to the formatter
DateTimeFormatter#format(TemporalAccessor) print method.
the formatter to use, not null
the formatted month-day string, not null
if an error occurs during printing
Gets the value of the specified field from this month-day as an int.
Gets the value of the specified field from this month-day as an int.
This queries this month-day for the value for the specified field. The returned value will always be within the valid range of values for the field. If it is not possible to return the value, because the field is not supported or for some other reason, an exception is thrown.
If the field is a ChronoField then the query is implemented here.
The #isSupported(TemporalField) supported fields will return valid
values based on this month-day.
All other ChronoField instances will throw a DateTimeException.
If the field is not a ChronoField, then the result of this method
is obtained by invoking TemporalField.getFrom(TemporalAccessor)
passing this as the argument. Whether the value can be obtained,
and what the value represents, is determined by the field.
the field to get, not null
the value for the field
if numeric overflow occurs
DateTimeExceptionif a value for the field cannot be obtained
Gets the day-of-month field.
Gets the day-of-month field.
This method returns the primitive int value for the day-of-month.
the day-of-month, from 1 to 31
Gets the value of the specified field from this month-day as a long.
Gets the value of the specified field from this month-day as a long.
This queries this month-day for the value for the specified field. If it is not possible to return the value, because the field is not supported or for some other reason, an exception is thrown.
If the field is a ChronoField then the query is implemented here.
The #isSupported(TemporalField) supported fields will return valid
values based on this month-day.
All other ChronoField instances will throw a DateTimeException.
If the field is not a ChronoField, then the result of this method
is obtained by invoking TemporalField.getFrom(TemporalAccessor)
passing this as the argument. Whether the value can be obtained,
and what the value represents, is determined by the field.
the field to get, not null
the value for the field
if numeric overflow occurs
DateTimeExceptionif a value for the field cannot be obtained
Gets the month-of-year field using the Month enum.
Gets the month-of-year field using the Month enum.
This method returns the enum Month for the month.
This avoids confusion as to what int values mean.
If you need access to the primitive int value then the enum
provides the Month#getValue() int value.
the month-of-year, not null
#getMonthValue()
Gets the month-of-year field from 1 to 12.
Gets the month-of-year field from 1 to 12.
This method returns the month as an int from 1 to 12.
Application code is frequently clearer if the enum Month
is used by calling #getMonth().
the month-of-year, from 1 to 12
#getMonth()
A hash code for this month-day.
A hash code for this month-day.
a suitable hash code
Is this month-day after the specified month-day.
Is this month-day after the specified month-day.
the other month-day to compare to, not null
true if this is after the specified month-day
Is this month-day before the specified month-day.
Is this month-day before the specified month-day.
the other month-day to compare to, not null
true if this point is before the specified month-day
Checks if the specified field is supported.
Checks if the specified field is supported.
This checks if this month-day can be queried for the specified field.
If false, then calling the #range(TemporalField) range and
#get(TemporalField) get methods will throw an exception.
If the field is a ChronoField then the query is implemented here.
The #isSupported(TemporalField) supported fields will return valid
values based on this date-time.
The supported fields are:
MONTH_OF_YEAR YEARAll other ChronoField instances will return false.
If the field is not a ChronoField, then the result of this method
is obtained by invoking TemporalField.isSupportedBy(TemporalAccessor)
passing this as the argument.
Whether the field is supported is determined by the field.
the field to check, null returns false
true if the field is supported on this month-day, false if not
Checks if the year is valid for this month-day.
Checks if the year is valid for this month-day.
This method checks whether this month and day and the input year form a valid date. This can only return false for February 29th.
the year to validate, an out of range value returns false
true if the year is valid for this month-day
Year#isValidMonthDay(MonthDay)
Queries this month-day using the specified query.
Queries this month-day using the specified query.
This queries this month-day using the specified query strategy object.
The TemporalQuery object defines the logic to be used to
obtain the result. Read the documentation of the query to understand
what the result of this method will be.
The result of this method is obtained by invoking the
TemporalQuery#queryFrom(TemporalAccessor) method on the
specified query passing this as the argument.
the type of the result
the query to invoke, not null
the query result, null may be returned (defined by the query)
if numeric overflow occurs (defined by the query)
DateTimeExceptionif unable to query (defined by the query)
Gets the range of valid values for the specified field.
Gets the range of valid values for the specified field.
The range object expresses the minimum and maximum valid values for a field. This month-day is used to enhance the accuracy of the returned range. If it is not possible to return the range, because the field is not supported or for some other reason, an exception is thrown.
If the field is a ChronoField then the query is implemented here.
The #isSupported(TemporalField) supported fields will return
appropriate range instances.
All other ChronoField instances will throw a DateTimeException.
If the field is not a ChronoField, then the result of this method
is obtained by invoking TemporalField.rangeRefinedBy(TemporalAccessor)
passing this as the argument.
Whether the range can be obtained is determined by the field.
the field to query the range for, not null
the range of valid values for the field, not null
if the range for the field cannot be obtained
Outputs this month-day as a String, such as --12-03.
Outputs this month-day as a String, such as --12-03.
The output will be in the format --MM-dd:
a string representation of this month-day, not null
Returns a copy of this MonthDay with the month-of-year altered.
Returns a copy of this MonthDay with the month-of-year altered.
This returns a month-day with the specified month. If the day-of-month is invalid for the specified month, the day will be adjusted to the last valid day-of-month.
This instance is immutable and unaffected by this method call.
the month-of-year to set in the returned month-day, not null
a { @code MonthDay} based on this month-day with the requested month, not null
Returns a copy of this MonthDay with the day-of-month altered.
Returns a copy of this MonthDay with the day-of-month altered.
This returns a month-day with the specified day-of-month. If the day-of-month is invalid for the month, an exception is thrown.
This instance is immutable and unaffected by this method call.
the day-of-month to set in the return month-day, from 1 to 31
a { @code MonthDay} based on this month-day with the requested day, not null
if the day-of-month is invalid for the month
Returns a copy of this MonthDay with the month-of-year altered.
Returns a copy of this MonthDay with the month-of-year altered.
This returns a month-day with the specified month. If the day-of-month is invalid for the specified month, the day will be adjusted to the last valid day-of-month.
This instance is immutable and unaffected by this method call.
the month-of-year to set in the returned month-day, from 1 (January) to 12 (December)
a { @code MonthDay} based on this month-day with the requested month, not null
if the month-of-year value is invalid
A month-day in the ISO-8601 calendar system, such as
--12-03.MonthDayis an immutable date-time object that represents the combination of a year and month. Any field that can be derived from a month and day, such as quarter-of-year, can be obtained.This class does not store or represent a year, time or time-zone. For example, the value "December 3rd" can be stored in a
MonthDay.Since a
MonthDaydoes not possess a year, the leap day of February 29th is considered valid.This class implements
TemporalAccessorrather thanTemporal. This is because it is not possible to define whether February 29th is valid or not without external information, preventing the implementation of plus/minus. Related to this,MonthDayonly provides access to query and set the fieldsMONTH_OF_YEARandDAY_OF_MONTH.The ISO-8601 calendar system is the modern civil calendar system used today in most of the world. It is equivalent to the proleptic Gregorian calendar system, in which today's rules for leap years are applied for all time. For most applications written today, the ISO-8601 rules are entirely suitable. However, any application that makes use of historical dates, and requires them to be accurate will find the ISO-8601 approach unsuitable.
Specification for implementors
This class is immutable and thread-safe.