extended-year

Author: robertbastian

components/calendar/fuzz/fuzz_targets/construction.rs

@@ -25,7 +25,6 @@ fuzz_target!(|data: FuzzInput| {
         let _ = date.day_of_year();
         let _ = date.days_in_month();
         let _ = date.days_in_year();
-        let _ = date.extended_year();
         let _ = date.is_in_leap_year();
         let _ = date.month();
         let _ = date.months_in_year();

components/calendar/src/any_calendar.rs

@@ -1589,7 +1589,7 @@ mod tests {
         } else {
             assert_eq!(
                 year,
-                date.extended_year(),
+                date.year().extended_year(),
                 "Failed to roundtrip year for calendar {}",
                 calendar.debug_name()
             );

components/calendar/src/cal/east_asian_traditional.rs

@@ -1206,7 +1206,7 @@ mod test {
             let chinese = Date::from_rata_die(rata_die, ChineseTraditional::new());
             assert_eq!(
                 case.expected_year,
-                chinese.extended_year(),
+                chinese.year().extended_year(),
                 "Chinese from RD failed, case: {case:?}"
             );
             assert_eq!(
@@ -1869,21 +1869,21 @@ mod test {
                     'outer: for long in [false, true] {
                         for (start_year, start_month, end_year, end_month, by) in [
                             (
-                                reference_year_end.extended_year(),
+                                reference_year_end.year().extended_year(),
                                 reference_year_end.month().number(),
-                                year_1900_start.extended_year(),
+                                year_1900_start.year().extended_year(),
                                 year_1900_start.month().number(),
                                 -1,
                             ),
                             (
-                                reference_year_end.extended_year(),
+                                reference_year_end.year().extended_year(),
                                 reference_year_end.month().number(),
-                                year_2035_end.extended_year(),
+                                year_2035_end.year().extended_year(),
                                 year_2035_end.month().number(),
                                 1,
                             ),
                             (
-                                year_1900_start.extended_year(),
+                                year_1900_start.year().extended_year(),
                                 year_1900_start.month().number(),
                                 -10000,
                                 1,

components/calendar/src/cal/ethiopian.rs

@@ -314,7 +314,7 @@ mod test {
         // 11th September 2023 in gregorian is 6/13/2015 in ethiopian
         let iso_date = Date::try_new_iso(2023, 9, 11).unwrap();
         let date_ethiopian = Date::new_from_iso(iso_date, Ethiopian::new());
-        assert_eq!(date_ethiopian.extended_year(), 2015);
+        assert_eq!(date_ethiopian.year().extended_year(), 2015);
         assert_eq!(date_ethiopian.month().ordinal, 13);
         assert_eq!(date_ethiopian.day_of_month().0, 6);
     }
@@ -324,7 +324,7 @@ mod test {
         let iso_date = Date::try_new_iso(1970, 1, 2).unwrap();
         let date_ethiopian = Date::new_from_iso(iso_date, Ethiopian::new());
 
-        assert_eq!(date_ethiopian.extended_year(), 1962);
+        assert_eq!(date_ethiopian.year().extended_year(), 1962);
         assert_eq!(date_ethiopian.month().ordinal, 4);
         assert_eq!(date_ethiopian.day_of_month().0, 24);
 
@@ -339,7 +339,7 @@ mod test {
         let iso_date = Date::try_new_iso(1970, 1, 2).unwrap();
         let date_ethiopian = Date::new_from_iso(iso_date, Ethiopian(EthiopianEraStyle::AmeteAlem));
 
-        assert_eq!(date_ethiopian.extended_year(), 7462);
+        assert_eq!(date_ethiopian.year().extended_year(), 7462);
         assert_eq!(date_ethiopian.month().ordinal, 4);
         assert_eq!(date_ethiopian.day_of_month().0, 24);
 
@@ -365,6 +365,7 @@ mod test {
                 Date::try_new_iso(-5500 + 9, 1, 1).unwrap(),
                 Ethiopian(EthiopianEraStyle::AmeteAlem)
             )
+            .year()
             .extended_year(),
             1
         );
@@ -373,6 +374,7 @@ mod test {
                 Date::try_new_iso(9, 1, 1).unwrap(),
                 Ethiopian(EthiopianEraStyle::AmeteAlem)
             )
+            .year()
             .extended_year(),
             5501
         );
@@ -382,6 +384,7 @@ mod test {
                 Date::try_new_iso(-5500 + 9, 1, 1).unwrap(),
                 Ethiopian(EthiopianEraStyle::AmeteMihret)
             )
+            .year()
             .extended_year(),
             -5499
         );
@@ -390,6 +393,7 @@ mod test {
                 Date::try_new_iso(9, 1, 1).unwrap(),
                 Ethiopian(EthiopianEraStyle::AmeteMihret)
             )
+            .year()
             .extended_year(),
             1
         );

components/calendar/src/cal/roc.rs

@@ -150,7 +150,7 @@ mod test {
             "Failed era check from RD: {case:?}\nISO: {iso_from_rd:?}\nROC: {roc_from_rd:?}"
         );
         assert_eq!(
-            roc_from_rd.extended_year(),
+            roc_from_rd.year().extended_year(),
             if case.expected_era == "roc" {
                 case.expected_year
             } else {

components/calendar/src/date.rs

@@ -285,19 +285,9 @@ impl<A: AsCalendar> Date<A> {
         self.calendar.as_calendar().year_info(&self.inner).into()
     }
 
-    /// The "extended year" of this date.
-    ///
-    /// This year number can be used when you need a simple numeric representation
-    /// of the year, and can be meaningfully compared with extended years from other
-    /// eras or used in arithmetic.
-    ///
-    /// For calendars defined in Temporal, this will match the "arithmetic year"
-    /// as defined in <https://tc39.es/proposal-intl-era-monthcode/>.
-    /// This is typically anchored with year 1 as the year 1 of either the most modern or
-    /// otherwise some "major" era for the calendar.
-    ///
-    /// See [`Self::year()`] for more information about the year.
+    /// Use [`YearInfo::extended_year`](types::YearInfo::extended_year)
     #[inline]
+    #[deprecated(since = "2.2.0", note = "use `date.year().extended_year()`")]
     pub fn extended_year(&self) -> i32 {
         self.year().extended_year()
     }

components/calendar/src/types.rs

@@ -70,7 +70,7 @@ mod unstable {
         ///
         /// For an example, see [`Self::extended_year`].
         pub era_year: Option<i32>,
-        /// See [`Date::extended_year()`](crate::Date::extended_year).
+        /// See [`YearInfo::extended_year()`](crate::types::YearInfo::extended_year).
         ///
         /// If both this and [`Self::era`]/[`Self::era_year`] are set, they must
         /// refer to the same year.
@@ -259,8 +259,16 @@ impl YearInfo {
         }
     }
 
-    /// Get the extended year (See [`Date::extended_year`](crate::Date::extended_year))
-    /// for more information
+    /// The "extended year".
+    ///
+    /// This year number can be used when you need a simple numeric representation
+    /// of the year, and can be meaningfully compared with extended years from other
+    /// eras or used in arithmetic.
+    ///
+    /// For calendars defined in Temporal, this will match the "arithmetic year"
+    /// as defined in <https://tc39.es/proposal-intl-era-monthcode/>.
+    /// This is typically anchored with year 1 as the year 1 of either the most modern or
+    /// otherwise some "major" era for the calendar.
     pub fn extended_year(self) -> i32 {
         match self {
             YearInfo::Era(e) => e.extended_year,

components/calendar/tests/extended_year.rs

@@ -44,7 +44,7 @@ fn test_extended_year() {
             Date::try_new_from_codes(None, 0, m_01.code(), 1, calendar.clone()).unwrap();
         let iso_date_in_epoch_year = date_in_epoch_year.to_calendar(iso);
         assert_eq!(
-            iso_date_in_epoch_year.extended_year(),
+            iso_date_in_epoch_year.year().extended_year(),
             *extended_epoch,
             "Extended year for {date_in_epoch_year:?} should be {extended_epoch}"
         );
@@ -67,7 +67,7 @@ fn test_extended_year() {
             AnyCalendarKind::Japanese | AnyCalendarKind::JapaneseExtended
         ) {
             assert_eq!(
-                date_in_2025.extended_year(),
+                date_in_2025.year().extended_year(),
                 2025,
                 "Extended year for {date_in_2025:?} should be 2025"
             );
@@ -76,7 +76,7 @@ fn test_extended_year() {
             // These two function calls are not equivalent in general.
             let expected = date_in_2025.year().era_year_or_related_iso();
             assert_eq!(
-                date_in_2025.extended_year(),
+                date_in_2025.year().extended_year(),
                 expected,
                 "Extended year for {date_in_2025:?} should be {expected}"
             );

components/icu/examples/iso_date_manipulations.rs

@@ -32,7 +32,7 @@ fn main() {
         let date = Date::try_new_iso(year, month, day).expect("date should parse");
         println!(
             "Year: {}, Month: {}, Day: {}",
-            date.extended_year(),
+            date.year().extended_year(),
             date.month().ordinal,
             date.day_of_month().0,
         );

components/time/src/ixdtf.rs

@@ -469,7 +469,7 @@ impl<A: AsCalendar> ZonedDateTime<A, TimeZoneInfo<models::AtTime>> {
     /// )
     /// .unwrap();
     ///
-    /// assert_eq!(zoneddatetime.date.extended_year(), 5784);
+    /// assert_eq!(zoneddatetime.date.year().extended_year(), 5784);
     /// assert_eq!(
     ///     zoneddatetime.date.month().standard_code,
     ///     icu::calendar::types::MonthCode(tinystr::tinystr!(4, "M11"))