Add the AM/PM getters on FixedCalendarDateTimeNames

Author: WaterWhisperer

components/datetime/src/pattern/names.rs

@@ -2665,6 +2665,86 @@ impl<C: CldrCalendar, FSet: DateTimeNamesMarker> FixedCalendarDateTimeNames<C, F
 }
 
 impl<C, FSet: DateTimeNamesMarker> FixedCalendarDateTimeNames<C, FSet> {
+    /// Gets the "AM" day period symbol if the data is loaded.
+    ///
+    /// Returns `Some` if the data is loaded or `None` if not loaded.
+    ///
+    /// # Examples
+    ///
+    /// ```
+    /// use icu::calendar::Gregorian;
+    /// use icu::datetime::pattern::{DayPeriodNameLength, FixedCalendarDateTimeNames};
+    /// use icu::locale::locale;
+    ///
+    /// let mut names =
+    ///     FixedCalendarDateTimeNames::<Gregorian>::try_new(locale!("en").into())
+    ///         .unwrap();
+    ///
+    /// // Before loading data, the getter returns None:
+    /// assert_eq!(names.get_am(), None);
+    ///
+    /// // Load the day period names:
+    /// names
+    ///     .include_day_period_names(DayPeriodNameLength::Abbreviated)
+    ///     .unwrap();
+    ///
+    /// // Now we can get the AM symbol:
+    /// assert_eq!(names.get_am(), Some("AM"));
+    /// ```
+    pub fn get_am(&self) -> Option<&str> {
+        let borrowed = self.inner.as_borrowed();
+        for length in [
+            DayPeriodNameLength::Abbreviated,
+            DayPeriodNameLength::Wide,
+            DayPeriodNameLength::Narrow,
+        ] {
+            if let Some(names) = borrowed.dayperiod_names.get_with_variables(length) {
+                return names.am();
+            }
+        }
+        None
+    }
+
+    /// Gets the "PM" day period symbol if the data is loaded.
+    ///
+    /// Returns `Some` if the data is loaded or `None` if not loaded.
+    ///
+    /// # Examples
+    ///
+    /// ```
+    /// use icu::calendar::Gregorian;
+    /// use icu::datetime::pattern::{DayPeriodNameLength, FixedCalendarDateTimeNames};
+    /// use icu::locale::locale;
+    ///
+    /// let mut names =
+    ///     FixedCalendarDateTimeNames::<Gregorian>::try_new(locale!("en").into())
+    ///         .unwrap();
+    ///
+    /// // Before loading data, the getter returns None:
+    /// assert_eq!(names.get_pm(), None);
+    ///
+    /// // Load the day period names:
+    /// names
+    ///     .include_day_period_names(DayPeriodNameLength::Wide)
+    ///     .unwrap();
+    ///
+    /// // Now we can get the PM symbol:
+    /// assert_eq!(names.get_pm(), Some("PM"));
+    /// ```
+    pub fn get_pm(&self) -> Option<&str> {
+        let borrowed = self.inner.as_borrowed();
+        for length in [
+            DayPeriodNameLength::Abbreviated,
+            DayPeriodNameLength::Wide,
+            DayPeriodNameLength::Narrow,
+        ] {
+            if let Some(names) = borrowed.dayperiod_names.get_with_variables(length) {
+                return names.pm();
+            }
+        }
+        None
+    }
+
     /// Maps a [`FixedCalendarDateTimeNames`] of a specific `FSet` to a more general `FSet`.
     ///
     /// For example, this can transform a formatter for [`DateFieldSet`] to one for