DurationFormat.h 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257
  1. /*
  2. * Copyright (c) 2022, Idan Horowitz <idan.horowitz@serenityos.org>
  3. * Copyright (c) 2022-2024, Tim Flynn <trflynn89@serenityos.org>
  4. *
  5. * SPDX-License-Identifier: BSD-2-Clause
  6. */
  7. #pragma once
  8. #include <AK/Array.h>
  9. #include <AK/String.h>
  10. #include <LibJS/Runtime/Intl/AbstractOperations.h>
  11. #include <LibJS/Runtime/Object.h>
  12. #include <LibJS/Runtime/Temporal/Duration.h>
  13. #include <LibLocale/Locale.h>
  14. namespace JS::Intl {
  15. class DurationFormat final : public Object {
  16. JS_OBJECT(DurationFormat, Object);
  17. JS_DECLARE_ALLOCATOR(DurationFormat);
  18. public:
  19. enum class Style {
  20. Long,
  21. Short,
  22. Narrow,
  23. Digital
  24. };
  25. enum class ValueStyle {
  26. Long,
  27. Short,
  28. Narrow,
  29. Numeric,
  30. TwoDigit,
  31. Fractional,
  32. };
  33. static_assert(to_underlying(ValueStyle::Long) == to_underlying(::Locale::Style::Long));
  34. static_assert(to_underlying(ValueStyle::Short) == to_underlying(::Locale::Style::Short));
  35. static_assert(to_underlying(ValueStyle::Narrow) == to_underlying(::Locale::Style::Narrow));
  36. enum class Display {
  37. Auto,
  38. Always
  39. };
  40. static constexpr auto relevant_extension_keys()
  41. {
  42. // 1.3.3 Internal slots, https://tc39.es/proposal-intl-duration-format/#sec-Intl.DurationFormat-internal-slots
  43. // The value of the [[RelevantExtensionKeys]] internal slot is « "nu" ».
  44. return AK::Array { "nu"sv };
  45. }
  46. virtual ~DurationFormat() override = default;
  47. void set_locale(String locale) { m_locale = move(locale); }
  48. String const& locale() const { return m_locale; }
  49. void set_data_locale(String data_locale) { m_data_locale = move(data_locale); }
  50. String const& data_locale() const { return m_data_locale; }
  51. void set_numbering_system(String numbering_system) { m_numbering_system = move(numbering_system); }
  52. String const& numbering_system() const { return m_numbering_system; }
  53. void set_hours_minutes_separator(String hours_minutes_separator) { m_hours_minutes_separator = move(hours_minutes_separator); }
  54. String const& hours_minutes_separator() const { return m_hours_minutes_separator; }
  55. void set_minutes_seconds_separator(String minutes_seconds_separator) { m_minutes_seconds_separator = move(minutes_seconds_separator); }
  56. String const& minutes_seconds_separator() const { return m_minutes_seconds_separator; }
  57. void set_two_digit_hours(bool two_digit_hours) { m_two_digit_hours = two_digit_hours; }
  58. bool two_digit_hours() const { return m_two_digit_hours; }
  59. void set_style(StringView style) { m_style = style_from_string(style); }
  60. Style style() const { return m_style; }
  61. StringView style_string() const { return style_to_string(m_style); }
  62. void set_years_style(StringView years_style) { m_years_style = date_style_from_string(years_style); }
  63. ValueStyle years_style() const { return m_years_style; }
  64. StringView years_style_string() const { return value_style_to_string(m_years_style); }
  65. void set_years_display(StringView years_display) { m_years_display = display_from_string(years_display); }
  66. Display years_display() const { return m_years_display; }
  67. StringView years_display_string() const { return display_to_string(m_years_display); }
  68. void set_months_style(StringView months_style) { m_months_style = date_style_from_string(months_style); }
  69. ValueStyle months_style() const { return m_months_style; }
  70. StringView months_style_string() const { return value_style_to_string(m_months_style); }
  71. void set_months_display(StringView months_display) { m_months_display = display_from_string(months_display); }
  72. Display months_display() const { return m_months_display; }
  73. StringView months_display_string() const { return display_to_string(m_months_display); }
  74. void set_weeks_style(StringView weeks_style) { m_weeks_style = date_style_from_string(weeks_style); }
  75. ValueStyle weeks_style() const { return m_weeks_style; }
  76. StringView weeks_style_string() const { return value_style_to_string(m_weeks_style); }
  77. void set_weeks_display(StringView weeks_display) { m_weeks_display = display_from_string(weeks_display); }
  78. Display weeks_display() const { return m_weeks_display; }
  79. StringView weeks_display_string() const { return display_to_string(m_weeks_display); }
  80. void set_days_style(StringView days_style) { m_days_style = date_style_from_string(days_style); }
  81. ValueStyle days_style() const { return m_days_style; }
  82. StringView days_style_string() const { return value_style_to_string(m_days_style); }
  83. void set_days_display(StringView days_display) { m_days_display = display_from_string(days_display); }
  84. Display days_display() const { return m_days_display; }
  85. StringView days_display_string() const { return display_to_string(m_days_display); }
  86. void set_hours_style(StringView hours_style) { m_hours_style = time_style_from_string(hours_style); }
  87. ValueStyle hours_style() const { return m_hours_style; }
  88. StringView hours_style_string() const { return value_style_to_string(m_hours_style); }
  89. void set_hours_display(StringView hours_display) { m_hours_display = display_from_string(hours_display); }
  90. Display hours_display() const { return m_hours_display; }
  91. StringView hours_display_string() const { return display_to_string(m_hours_display); }
  92. void set_minutes_style(StringView minutes_style) { m_minutes_style = time_style_from_string(minutes_style); }
  93. ValueStyle minutes_style() const { return m_minutes_style; }
  94. StringView minutes_style_string() const { return value_style_to_string(m_minutes_style); }
  95. void set_minutes_display(StringView minutes_display) { m_minutes_display = display_from_string(minutes_display); }
  96. Display minutes_display() const { return m_minutes_display; }
  97. StringView minutes_display_string() const { return display_to_string(m_minutes_display); }
  98. void set_seconds_style(StringView seconds_style) { m_seconds_style = time_style_from_string(seconds_style); }
  99. ValueStyle seconds_style() const { return m_seconds_style; }
  100. StringView seconds_style_string() const { return value_style_to_string(m_seconds_style); }
  101. void set_seconds_display(StringView seconds_display) { m_seconds_display = display_from_string(seconds_display); }
  102. Display seconds_display() const { return m_seconds_display; }
  103. StringView seconds_display_string() const { return display_to_string(m_seconds_display); }
  104. void set_milliseconds_style(StringView milliseconds_style) { m_milliseconds_style = sub_second_style_from_string(milliseconds_style); }
  105. ValueStyle milliseconds_style() const { return m_milliseconds_style; }
  106. StringView milliseconds_style_string() const { return value_style_to_string(m_milliseconds_style); }
  107. void set_milliseconds_display(StringView milliseconds_display) { m_milliseconds_display = display_from_string(milliseconds_display); }
  108. Display milliseconds_display() const { return m_milliseconds_display; }
  109. StringView milliseconds_display_string() const { return display_to_string(m_milliseconds_display); }
  110. void set_microseconds_style(StringView microseconds_style) { m_microseconds_style = sub_second_style_from_string(microseconds_style); }
  111. ValueStyle microseconds_style() const { return m_microseconds_style; }
  112. StringView microseconds_style_string() const { return value_style_to_string(m_microseconds_style); }
  113. void set_microseconds_display(StringView microseconds_display) { m_microseconds_display = display_from_string(microseconds_display); }
  114. Display microseconds_display() const { return m_microseconds_display; }
  115. StringView microseconds_display_string() const { return display_to_string(m_microseconds_display); }
  116. void set_nanoseconds_style(StringView nanoseconds_style) { m_nanoseconds_style = sub_second_style_from_string(nanoseconds_style); }
  117. ValueStyle nanoseconds_style() const { return m_nanoseconds_style; }
  118. StringView nanoseconds_style_string() const { return value_style_to_string(m_nanoseconds_style); }
  119. void set_nanoseconds_display(StringView nanoseconds_display) { m_nanoseconds_display = display_from_string(nanoseconds_display); }
  120. Display nanoseconds_display() const { return m_nanoseconds_display; }
  121. StringView nanoseconds_display_string() const { return display_to_string(m_nanoseconds_display); }
  122. void set_fractional_digits(Optional<u8> fractional_digits) { m_fractional_digits = move(fractional_digits); }
  123. bool has_fractional_digits() const { return m_fractional_digits.has_value(); }
  124. u8 fractional_digits() const { return m_fractional_digits.value(); }
  125. private:
  126. explicit DurationFormat(Object& prototype);
  127. static Style style_from_string(StringView style);
  128. static StringView style_to_string(Style);
  129. static ValueStyle date_style_from_string(StringView date_style);
  130. static ValueStyle time_style_from_string(StringView time_style);
  131. static ValueStyle sub_second_style_from_string(StringView sub_second_style);
  132. static StringView value_style_to_string(ValueStyle);
  133. static Display display_from_string(StringView display);
  134. static StringView display_to_string(Display);
  135. String m_locale; // [[Locale]]
  136. String m_data_locale; // [[DataLocale]]
  137. String m_numbering_system; // [[NumberingSystem]]
  138. String m_hours_minutes_separator; // [[HourMinutesSeparator]]
  139. String m_minutes_seconds_separator; // [[MinutesSecondsSeparator]]
  140. bool m_two_digit_hours { false }; // [[TwoDigitHours]]
  141. Style m_style { Style::Long }; // [[Style]]
  142. ValueStyle m_years_style { ValueStyle::Long }; // [[YearsStyle]]
  143. Display m_years_display { Display::Auto }; // [[YearsDisplay]]
  144. ValueStyle m_months_style { ValueStyle::Long }; // [[MonthsStyle]]
  145. Display m_months_display { Display::Auto }; // [[MonthsDisplay]]
  146. ValueStyle m_weeks_style { ValueStyle::Long }; // [[WeeksStyle]]
  147. Display m_weeks_display { Display::Auto }; // [[WeeksDisplay]]
  148. ValueStyle m_days_style { ValueStyle::Long }; // [[DaysStyle]]
  149. Display m_days_display { Display::Auto }; // [[DaysDisplay]]
  150. ValueStyle m_hours_style { ValueStyle::Long }; // [[HoursStyle]]
  151. Display m_hours_display { Display::Auto }; // [[HoursDisplay]]
  152. ValueStyle m_minutes_style { ValueStyle::Long }; // [[MinutesStyle]]
  153. Display m_minutes_display { Display::Auto }; // [[MinutesDisplay]]
  154. ValueStyle m_seconds_style { ValueStyle::Long }; // [[SecondsStyle]]
  155. Display m_seconds_display { Display::Auto }; // [[SecondsDisplay]]
  156. ValueStyle m_milliseconds_style { ValueStyle::Long }; // [[MillisecondsStyle]]
  157. Display m_milliseconds_display { Display::Auto }; // [[MillisecondsDisplay]]
  158. ValueStyle m_microseconds_style { ValueStyle::Long }; // [[MicrosecondsStyle]]
  159. Display m_microseconds_display { Display::Auto }; // [[MicrosecondsDisplay]]
  160. ValueStyle m_nanoseconds_style { ValueStyle::Long }; // [[NanosecondsStyle]]
  161. Display m_nanoseconds_display { Display::Auto }; // [[NanosecondsDisplay]]
  162. Optional<u8> m_fractional_digits; // [[FractionalDigits]]
  163. };
  164. struct DurationInstanceComponent {
  165. double Temporal::DurationRecord::*value_slot;
  166. DurationFormat::ValueStyle (DurationFormat::*get_style_slot)() const;
  167. void (DurationFormat::*set_style_slot)(StringView);
  168. DurationFormat::Display (DurationFormat::*get_display_slot)() const;
  169. void (DurationFormat::*set_display_slot)(StringView);
  170. StringView unit;
  171. StringView number_format_unit;
  172. ReadonlySpan<StringView> values;
  173. StringView digital_default;
  174. };
  175. // Table 1: Components of Duration Instances, https://tc39.es/proposal-intl-duration-format/#table-duration-component
  176. static constexpr AK::Array<StringView, 3> date_values = { "long"sv, "short"sv, "narrow"sv };
  177. static constexpr AK::Array<StringView, 5> time_values = { "long"sv, "short"sv, "narrow"sv, "numeric"sv, "2-digit"sv };
  178. static constexpr AK::Array<StringView, 4> sub_second_values = { "long"sv, "short"sv, "narrow"sv, "numeric"sv };
  179. static constexpr AK::Array<DurationInstanceComponent, 10> duration_instances_components {
  180. DurationInstanceComponent { &Temporal::DurationRecord::years, &DurationFormat::years_style, &DurationFormat::set_years_style, &DurationFormat::years_display, &DurationFormat::set_years_display, "years"sv, "year"sv, date_values, "short"sv },
  181. DurationInstanceComponent { &Temporal::DurationRecord::months, &DurationFormat::months_style, &DurationFormat::set_months_style, &DurationFormat::months_display, &DurationFormat::set_months_display, "months"sv, "month"sv, date_values, "short"sv },
  182. DurationInstanceComponent { &Temporal::DurationRecord::weeks, &DurationFormat::weeks_style, &DurationFormat::set_weeks_style, &DurationFormat::weeks_display, &DurationFormat::set_weeks_display, "weeks"sv, "week"sv, date_values, "short"sv },
  183. DurationInstanceComponent { &Temporal::DurationRecord::days, &DurationFormat::days_style, &DurationFormat::set_days_style, &DurationFormat::days_display, &DurationFormat::set_days_display, "days"sv, "day"sv, date_values, "short"sv },
  184. DurationInstanceComponent { &Temporal::DurationRecord::hours, &DurationFormat::hours_style, &DurationFormat::set_hours_style, &DurationFormat::hours_display, &DurationFormat::set_hours_display, "hours"sv, "hour"sv, time_values, "numeric"sv },
  185. DurationInstanceComponent { &Temporal::DurationRecord::minutes, &DurationFormat::minutes_style, &DurationFormat::set_minutes_style, &DurationFormat::minutes_display, &DurationFormat::set_minutes_display, "minutes"sv, "minute"sv, time_values, "numeric"sv },
  186. DurationInstanceComponent { &Temporal::DurationRecord::seconds, &DurationFormat::seconds_style, &DurationFormat::set_seconds_style, &DurationFormat::seconds_display, &DurationFormat::set_seconds_display, "seconds"sv, "second"sv, time_values, "numeric"sv },
  187. DurationInstanceComponent { &Temporal::DurationRecord::milliseconds, &DurationFormat::milliseconds_style, &DurationFormat::set_milliseconds_style, &DurationFormat::milliseconds_display, &DurationFormat::set_milliseconds_display, "milliseconds"sv, "millisecond"sv, sub_second_values, "numeric"sv },
  188. DurationInstanceComponent { &Temporal::DurationRecord::microseconds, &DurationFormat::microseconds_style, &DurationFormat::set_microseconds_style, &DurationFormat::microseconds_display, &DurationFormat::set_microseconds_display, "microseconds"sv, "microsecond"sv, sub_second_values, "numeric"sv },
  189. DurationInstanceComponent { &Temporal::DurationRecord::nanoseconds, &DurationFormat::nanoseconds_style, &DurationFormat::set_nanoseconds_style, &DurationFormat::nanoseconds_display, &DurationFormat::set_nanoseconds_display, "nanoseconds"sv, "nanosecond"sv, sub_second_values, "numeric"sv },
  190. };
  191. struct DurationUnitOptions {
  192. String style;
  193. String display;
  194. };
  195. struct DurationFormatPart {
  196. StringView type;
  197. String value;
  198. StringView unit;
  199. };
  200. ThrowCompletionOr<Temporal::DurationRecord> to_duration_record(VM&, Value input);
  201. ThrowCompletionOr<DurationUnitOptions> get_duration_unit_options(VM&, String const& unit, Object const& options, StringView base_style, ReadonlySpan<StringView> styles_list, StringView digital_base, StringView previous_style, bool two_digit_hours);
  202. double add_fractional_digits(DurationFormat const&, Temporal::DurationRecord const&);
  203. bool next_unit_fractional(DurationFormat const&, StringView unit);
  204. Vector<DurationFormatPart> format_numeric_hours(VM&, DurationFormat const&, double hours_value, bool sign_displayed);
  205. Vector<DurationFormatPart> format_numeric_minutes(VM&, DurationFormat const&, double minutes_value, bool hours_displayed, bool sign_displayed);
  206. Vector<DurationFormatPart> format_numeric_seconds(VM&, DurationFormat const&, double seconds_value, bool minutes_displayed, bool sign_displayed);
  207. Vector<DurationFormatPart> format_numeric_units(VM&, DurationFormat const&, Temporal::DurationRecord const&, StringView first_numeric_unit, bool sign_displayed);
  208. Vector<DurationFormatPart> list_format_parts(VM&, DurationFormat const&, Vector<Vector<DurationFormatPart>>& partitioned_parts_list);
  209. Vector<DurationFormatPart> partition_duration_format_pattern(VM&, DurationFormat const&, Temporal::DurationRecord const&);
  210. }