Java : MonthDay (月・日) - API使用例
公開日：2023年10月23日
MonthDay (Java SE 20 & JDK 20) の使用例まとめです。
だいたいのメソッドを網羅済みです。
API仕様のおともにどうぞ。
概要
ISO-8601暦体系における月日(--12-03など)。
MonthDay は、日付の月と日を表します。
例えば、
- 4月15日
- 12月31日
などが表現できます。
オブジェクトの生成には of メソッドを使います。
final var monthDay = MonthDay.of(Month.APRIL, 15);
System.out.println(monthDay); // --04-15
System.out.println(monthDay.getMonth()); // APRIL
System.out.println(monthDay.getMonthValue()); // 4
System.out.println(monthDay.getDayOfMonth()); // 15
メソッド
Temporal adjustInto (Temporal temporal)
指定された時間的オブジェクトを、この月-日が含まれるように調整します。
final var monthDay = MonthDay.of(Month.DECEMBER, 15);
System.out.println(monthDay); // --12-15
final var date = LocalDate.of(2100, 2, 3);
System.out.println(date); // 2100-02-03
final var ret = monthDay.adjustInto(date);
System.out.println(ret); // 2100-12-15
LocalDate atYear (int year)
この月-日を年と組み合せてLocalDateを作成します。
final var monthDay = MonthDay.of(Month.APRIL, 15);
System.out.println(monthDay); // --04-15
System.out.println(monthDay.atYear(1999)); // 1999-04-15
System.out.println(monthDay.atYear(2100)); // 2100-04-15
int compareTo (MonthDay other)
この月-日をもう一方の月-日と比較します。
final var monthDay1 = MonthDay.of(Month.JANUARY, 15);
final var monthDay2 = MonthDay.of(Month.JANUARY, 15);
System.out.println(monthDay1); // --01-15
System.out.println(monthDay2); // --01-15
System.out.println(monthDay1.compareTo(monthDay2)); // 0
System.out.println(monthDay2.compareTo(monthDay1)); // 0
final var monthDay1 = MonthDay.of(Month.JANUARY, 15);
final var monthDay2 = MonthDay.of(Month.FEBRUARY, 15);
System.out.println(monthDay1); // --01-15
System.out.println(monthDay2); // --02-15
System.out.println(monthDay1.compareTo(monthDay2)); // -1
System.out.println(monthDay2.compareTo(monthDay1)); // 1
final var monthDay1 = MonthDay.of(Month.APRIL, 2);
final var monthDay2 = MonthDay.of(Month.APRIL, 1);
System.out.println(monthDay1); // --04-02
System.out.println(monthDay2); // --04-01
System.out.println(monthDay1.compareTo(monthDay2)); // 1
System.out.println(monthDay2.compareTo(monthDay1)); // -1
boolean equals (Object obj)
この月-日がもう一方の月-日と等しいかどうかを確認します。
final var monthDay1 = MonthDay.of(Month.JANUARY, 15);
final var monthDay2 = MonthDay.of(Month.JANUARY, 15);
System.out.println(monthDay1); // --01-15
System.out.println(monthDay2); // --01-15
System.out.println(monthDay1.equals(monthDay2)); // true
System.out.println(monthDay2.equals(monthDay1)); // true
final var monthDay1 = MonthDay.of(Month.JANUARY, 15);
final var monthDay2 = MonthDay.of(Month.FEBRUARY, 15);
System.out.println(monthDay1); // --01-15
System.out.println(monthDay2); // --02-15
System.out.println(monthDay1.equals(monthDay2)); // false
System.out.println(monthDay2.equals(monthDay1)); // false
final var monthDay1 = MonthDay.of(Month.APRIL, 2);
final var monthDay2 = MonthDay.of(Month.APRIL, 1);
System.out.println(monthDay1); // --04-02
System.out.println(monthDay2); // --04-01
System.out.println(monthDay1.equals(monthDay2)); // false
System.out.println(monthDay2.equals(monthDay1)); // false
String format (DateTimeFormatter formatter)
指定されたフォーマッタを使用してこの月-日を書式設定します。
final var monthDay = MonthDay.of(Month.APRIL, 1);
System.out.println(monthDay); // --04-01
final var ret1 = monthDay.format(DateTimeFormatter.ofPattern("MM-dd"));
System.out.println(ret1); // 04-01
final var ret2 = monthDay.format(DateTimeFormatter.ofPattern("M-d"));
System.out.println(ret2); // 4-1
static MonthDay from (TemporalAccessor temporal)
時間的オブジェクトからMonthDayのインスタンスを取得します。
final var date = LocalDate.of(2100, 2, 3);
System.out.println(date); // 2100-02-03
final var ret = MonthDay.from(date);
System.out.println(ret); // --02-03
final var dateTime = LocalDateTime.of(1999, 12, 31, 7, 30);
System.out.println(dateTime); // 1999-12-31T07:30
final var ret = MonthDay.from(dateTime);
System.out.println(ret); // --12-31
int get (TemporalField field)
指定されたフィールドの値をこの月-日からintとして取得します。
final var monthDay = MonthDay.of(Month.JANUARY, 15);
System.out.println(monthDay); // --01-15
System.out.println(monthDay.get(ChronoField.MONTH_OF_YEAR)); // 1
System.out.println(monthDay.get(ChronoField.DAY_OF_MONTH)); // 15
final var monthDay = MonthDay.of(Month.DECEMBER, 31);
System.out.println(monthDay); // --12-31
System.out.println(monthDay.get(ChronoField.MONTH_OF_YEAR)); // 12
System.out.println(monthDay.get(ChronoField.DAY_OF_MONTH)); // 31
int getDayOfMonth ()
「月の日」フィールドを取得します。
final var monthDay = MonthDay.of(Month.APRIL, 15);
System.out.println(monthDay); // --04-15
System.out.println(monthDay.getMonth()); // APRIL
System.out.println(monthDay.getMonthValue()); // 4
System.out.println(monthDay.getDayOfMonth()); // 15
long getLong (TemporalField field)
指定されたフィールドの値をこの月-日からlongとして取得します。
final var monthDay = MonthDay.of(Month.JANUARY, 15);
System.out.println(monthDay); // --01-15
System.out.println(monthDay.getLong(ChronoField.MONTH_OF_YEAR)); // 1
System.out.println(monthDay.getLong(ChronoField.DAY_OF_MONTH)); // 15
final var monthDay = MonthDay.of(Month.DECEMBER, 31);
System.out.println(monthDay); // --12-31
System.out.println(monthDay.getLong(ChronoField.MONTH_OF_YEAR)); // 12
System.out.println(monthDay.getLong(ChronoField.DAY_OF_MONTH)); // 31
Month getMonth ()
列挙型Monthを使用して、月フィールドを取得します。
このメソッドの使用例は、getDayOfMonth() にまとめて記載しました。
そちらのAPI使用例をご参照ください。
int getMonthValue ()
月フィールドを取得します(1-12)。
このメソッドの使用例は、getDayOfMonth() にまとめて記載しました。
そちらのAPI使用例をご参照ください。
int hashCode ()
この月-日のハッシュ・コードです。
final var monthDay = MonthDay.of(Month.JANUARY, 15);
System.out.println(monthDay); // --01-15
System.out.println(monthDay.hashCode()); // 79
final var monthDay = MonthDay.of(Month.DECEMBER, 31);
System.out.println(monthDay); // --12-31
System.out.println(monthDay.hashCode()); // 799
boolean isAfter (MonthDay other)
この月/日が、指定された月/日より後にあるかどうかをチェックします。
final var monthDay = MonthDay.of(Month.FEBRUARY, 1);
System.out.println(monthDay); // --02-01
final var monthDay2 = MonthDay.of(Month.JANUARY, 31);
final var monthDay3 = MonthDay.of(Month.FEBRUARY, 1);
final var monthDay4 = MonthDay.of(Month.FEBRUARY, 2);
System.out.println(monthDay2); // --01-31
System.out.println(monthDay3); // --02-01
System.out.println(monthDay4); // --02-02
System.out.println(monthDay.isAfter(monthDay2)); // true
System.out.println(monthDay.isAfter(monthDay3)); // false
System.out.println(monthDay.isAfter(monthDay4)); // false
boolean isBefore (MonthDay other)
この月/日が、指定された月/日より前にあるかどうかをチェックします。
final var monthDay = MonthDay.of(Month.FEBRUARY, 1);
System.out.println(monthDay); // --02-01
final var monthDay2 = MonthDay.of(Month.JANUARY, 31);
final var monthDay3 = MonthDay.of(Month.FEBRUARY, 1);
final var monthDay4 = MonthDay.of(Month.FEBRUARY, 2);
System.out.println(monthDay2); // --01-31
System.out.println(monthDay3); // --02-01
System.out.println(monthDay4); // --02-02
System.out.println(monthDay.isBefore(monthDay2)); // true
System.out.println(monthDay.isBefore(monthDay3)); // false
System.out.println(monthDay.isBefore(monthDay4)); // false
boolean isSupported (TemporalField field)
指定されたフィールドがサポートされているかどうかをチェックします。
final var monthDay = MonthDay.of(Month.APRIL, 15);
System.out.println(monthDay); // --04-15
System.out.println(monthDay.isSupported(ChronoField.MONTH_OF_YEAR)); // true
System.out.println(monthDay.isSupported(ChronoField.DAY_OF_MONTH)); // true
System.out.println(monthDay.isSupported(ChronoField.YEAR)); // false
boolean isValidYear (int year)
この月-日に対して年が有効であるかどうかを確認します。
final var monthDay = MonthDay.of(Month.FEBRUARY, 29);
System.out.println(monthDay); // --02-29
System.out.println(Year.isLeap(2103)); // false
System.out.println(monthDay.isValidYear(2103)); // false
System.out.println(Year.isLeap(2104)); // true
System.out.println(monthDay.isValidYear(2104)); // true
static MonthDay now ()
デフォルトのタイムゾーンのシステム・クロックから現在の月-日を取得します。
final var now = MonthDay.now();
System.out.println(now); // --10-19
static MonthDay now (Clock clock)
指定されたクロックから現在の月-日を取得します。
// 意図的に5日進めたClock
final var clock = Clock.offset(Clock.systemDefaultZone(), Duration.ofDays(5));
System.out.println(MonthDay.now()); // --10-19
System.out.println(MonthDay.now(clock)); // --10-24
static MonthDay now (ZoneId zone)
指定されたタイムゾーンのシステム・クロックから現在の月-日を取得します。
final var zone = ZoneOffset.UTC;
System.out.println(zone); // Z
final var now = MonthDay.now(zone);
System.out.println(now); // --10-19
static MonthDay of (int month, int dayOfMonth)
MonthDayのインスタンスを取得します。
final var monthDay = MonthDay.of(1, 2);
System.out.println(monthDay.getMonth()); // JANUARY
System.out.println(monthDay.getMonthValue()); // 1
System.out.println(monthDay.getDayOfMonth()); // 2
final var monthDay = MonthDay.of(12, 15);
System.out.println(monthDay.getMonth()); // DECEMBER
System.out.println(monthDay.getMonthValue()); // 12
System.out.println(monthDay.getDayOfMonth()); // 15
static MonthDay of (Month month, int dayOfMonth)
MonthDayのインスタンスを取得します。
final var monthDay = MonthDay.of(Month.JANUARY, 2);
System.out.println(monthDay.getMonth()); // JANUARY
System.out.println(monthDay.getMonthValue()); // 1
System.out.println(monthDay.getDayOfMonth()); // 2
final var monthDay = MonthDay.of(Month.DECEMBER, 15);
System.out.println(monthDay.getMonth()); // DECEMBER
System.out.println(monthDay.getMonthValue()); // 12
System.out.println(monthDay.getDayOfMonth()); // 15
static MonthDay parse (CharSequence text)
--12-03などのテキスト文字列からMonthDayのインスタンスを取得します。
final var monthDay1 = MonthDay.parse("--04-05");
System.out.println(monthDay1); // --04-05
final var monthDay2 = MonthDay.parse("--12-31");
System.out.println(monthDay2); // --12-31
static MonthDay parse (CharSequence text, DateTimeFormatter formatter)
特定のフォーマッタを使用して、テキスト文字列からMonthDayのインスタンスを取得します。
final var monthDay1 = MonthDay.parse(
"04-05", DateTimeFormatter.ofPattern("MM-dd"));
System.out.println(monthDay1); // --04-05
final var monthDay2 = MonthDay.parse(
"8-1", DateTimeFormatter.ofPattern("M-d"));
System.out.println(monthDay2); // --08-01
<R> R query (TemporalQuery<R> query)
指定された問合せを使用してこの月-日を問い合わせます。
final var monthDay = MonthDay.of(Month.APRIL, 15);
System.out.println(monthDay); // --04-15
final var ret = monthDay.query(TemporalQueries.chronology());
System.out.println(ret); // ISO
ValueRange range (TemporalField field)
指定されたフィールドの有効な値の範囲を取得します。
final var monthDay = MonthDay.of(Month.JANUARY, 1);
System.out.println(monthDay); // --01-01
System.out.println(monthDay.range(ChronoField.MONTH_OF_YEAR)); // 1 - 12
System.out.println(monthDay.range(ChronoField.DAY_OF_MONTH)); // 1 - 31
final var monthDay = MonthDay.of(Month.FEBRUARY, 1);
System.out.println(monthDay); // --02-01
System.out.println(monthDay.range(ChronoField.MONTH_OF_YEAR)); // 1 - 12
System.out.println(monthDay.range(ChronoField.DAY_OF_MONTH)); // 1 - 28/29
String toString ()
この月-日をStringとして出力します(--12-03など)。
final var monthDay = MonthDay.of(Month.JANUARY, 15);
final var str = monthDay.toString();
System.out.println(str); // --01-15
final var monthDay = MonthDay.of(Month.DECEMBER, 31);
final var str = monthDay.toString();
System.out.println(str); // --12-31
MonthDay with (Month month)
月を変更して、このMonthDayのコピーを返します。
final var monthDay = MonthDay.of(Month.APRIL, 15);
System.out.println(monthDay); // --04-15
final var ret1 = monthDay.with(Month.DECEMBER);
System.out.println(ret1); // --12-15
final var ret2 = monthDay.withDayOfMonth(30);
System.out.println(ret2); // --04-30
final var ret3 = monthDay.withMonth(1);
System.out.println(ret3); // --01-15
MonthDay withDayOfMonth (int dayOfMonth)
「月の日」を変更して、このMonthDayのコピーを返します。
このメソッドの使用例は、with(Month month) にまとめて記載しました。
そちらのAPI使用例をご参照ください。
MonthDay withMonth (int month)
月を変更して、このMonthDayのコピーを返します。
このメソッドの使用例は、with(Month month) にまとめて記載しました。
そちらのAPI使用例をご参照ください。
関連記事
- 日付・時刻の基本
- Date, CalendarではなくLocalDateTime, ZonedDateTimeを使おう
- 文字列と日付・時刻の変換
- 日付と時刻、曜日の計算
- 現在時刻(日時)の取得いろいろ
- 現在の曜日(DayOfWeek)を取得
- ZoneIdとZoneOffsetの違い
- API 使用例
- Calendar (カレンダー)
- ChronoLocalDate
- Clock (時計)
- Date (日付・時刻)
- DateTimeException (日付・時刻の例外)
- DateTimeParseException (日付・時刻の解析例外)
- DayOfWeek (曜日)
- Duration (時間の量)
- Era (紀元)
- Instant (時点)
- InstantSource
- JapaneseDate (和暦を使った日付)
- LocalDate (日付・タイムゾーンなし)
- LocalDateTime (日時・タイムゾーンなし)
- LocalTime (時刻・タイムゾーンなし)
- Month (月)
- OffsetDateTime (日時・オフセットあり)
- OffsetTime (時刻・オフセットあり)
- Period (日付の量)
- Temporal
- TemporalAccessor
- TemporalAdjuster (日付・時刻の調整)
- TemporalAdjusters (日付・時刻の調整ユーティリティ)
- TimeZone (タイムゾーン)
- Year (年)
- YearMonth (年・月)
- ZonedDateTime (日時・タイムゾーンあり)
- ZoneId (タイムゾーンID)
- ZoneOffset (タイムゾーン・オフセット)