/* * Copyright (c) 2021-2024, Tim Flynn * * SPDX-License-Identifier: BSD-2-Clause */ #pragma once #include #include #include #include #include #include #include #include #include #include namespace JS::Intl { class DateTimeFormat final : public Object { JS_OBJECT(DateTimeFormat, Object); GC_DECLARE_ALLOCATOR(DateTimeFormat); using Patterns = Unicode::CalendarPattern; public: static constexpr auto relevant_extension_keys() { // 11.2.3 Internal slots, https://tc39.es/ecma402/#sec-intl.datetimeformat-internal-slots // The value of the [[RelevantExtensionKeys]] internal slot is « "ca", "hc", "nu" ». return AK::Array { "ca"sv, "hc"sv, "nu"sv }; } virtual ~DateTimeFormat() override = default; String const& locale() const { return m_locale; } void set_locale(String locale) { m_locale = move(locale); } String const& calendar() const { return m_calendar; } void set_calendar(String calendar) { m_calendar = move(calendar); } String const& numbering_system() const { return m_numbering_system; } void set_numbering_system(String numbering_system) { m_numbering_system = move(numbering_system); } String const& time_zone() const { return m_time_zone; } void set_time_zone(String time_zone) { m_time_zone = move(time_zone); } bool has_date_style() const { return m_date_style.has_value(); } Optional const& date_style() const { return m_date_style; } StringView date_style_string() const { return Unicode::date_time_style_to_string(*m_date_style); } void set_date_style(StringView style) { m_date_style = Unicode::date_time_style_from_string(style); } bool has_time_style() const { return m_time_style.has_value(); } Optional const& time_style() const { return m_time_style; } StringView time_style_string() const { return Unicode::date_time_style_to_string(*m_time_style); } void set_time_style(StringView style) { m_time_style = Unicode::date_time_style_from_string(style); } Unicode::CalendarPattern& date_time_format() { return m_date_time_format; } void set_date_time_format(Unicode::CalendarPattern date_time_format) { m_date_time_format = move(date_time_format); } NativeFunction* bound_format() const { return m_bound_format; } void set_bound_format(NativeFunction* bound_format) { m_bound_format = bound_format; } Unicode::DateTimeFormat const& formatter() const { return *m_formatter; } void set_formatter(NonnullOwnPtr formatter) { m_formatter = move(formatter); } Optional temporal_plain_date_formatter(); void set_temporal_plain_date_format(Optional temporal_plain_date_format) { m_temporal_plain_date_format = move(temporal_plain_date_format); } Optional temporal_plain_year_month_formatter(); void set_temporal_plain_year_month_format(Optional temporal_plain_year_month_format) { m_temporal_plain_year_month_format = move(temporal_plain_year_month_format); } Optional temporal_plain_month_day_formatter(); void set_temporal_plain_month_day_format(Optional temporal_plain_month_day_format) { m_temporal_plain_month_day_format = move(temporal_plain_month_day_format); } Optional temporal_plain_time_formatter(); void set_temporal_plain_time_format(Optional temporal_plain_time_format) { m_temporal_plain_time_format = move(temporal_plain_time_format); } Optional temporal_plain_date_time_formatter(); void set_temporal_plain_date_time_format(Optional temporal_plain_date_time_format) { m_temporal_plain_date_time_format = move(temporal_plain_date_time_format); } Optional temporal_instant_formatter(); void set_temporal_instant_format(Optional temporal_instant_format) { m_temporal_instant_format = move(temporal_instant_format); } void set_temporal_time_zone(String temporal_time_zone) { m_temporal_time_zone = move(temporal_time_zone); } private: DateTimeFormat(Object& prototype); virtual void visit_edges(Visitor&) override; String m_locale; // [[Locale]] String m_calendar; // [[Calendar]] String m_numbering_system; // [[NumberingSystem]] String m_time_zone; // [[TimeZone]] Optional m_date_style; // [[DateStyle]] Optional m_time_style; // [[TimeStyle]] Unicode::CalendarPattern m_date_time_format; // [[DateTimeFormat]] Optional m_temporal_plain_date_format; // [[TemporalPlainDateFormat]] Optional m_temporal_plain_year_month_format; // [[TemporalPlainYearMonthFormat]] Optional m_temporal_plain_month_day_format; // [[TemporalPlainMonthDayFormat]] Optional m_temporal_plain_time_format; // [[TemporalPlainTimeFormat]] Optional m_temporal_plain_date_time_format; // [[TemporalPlainDateTimeFormat]] Optional m_temporal_instant_format; // [[TemporalInstantFormat]] GC::Ptr m_bound_format; // [[BoundFormat]] // Non-standard. Stores the ICU date-time formatters for the Intl object's formatting options. OwnPtr m_formatter; OwnPtr m_temporal_plain_date_formatter; OwnPtr m_temporal_plain_year_month_formatter; OwnPtr m_temporal_plain_month_day_formatter; OwnPtr m_temporal_plain_time_formatter; OwnPtr m_temporal_plain_date_time_formatter; OwnPtr m_temporal_instant_formatter; String m_temporal_time_zone; }; using FormattableDateTime = Variant< double, GC::Ref, GC::Ref, GC::Ref, GC::Ref, GC::Ref, GC::Ref, GC::Ref>; // https://tc39.es/proposal-temporal/#datetimeformat-value-format-record // NOTE: ICU does not support nanoseconds in its date-time formatter. Thus, we do do not store the epoch nanoseconds as // a BigInt here. Instead, we store the epoch in milliseconds as a double. struct ValueFormat { Unicode::DateTimeFormat const& formatter; // [[Format]] double epoch_milliseconds { 0 }; // [[EpochNanoseconds]] }; Vector format_date_time_pattern(ValueFormat const&); ThrowCompletionOr> partition_date_time_pattern(VM&, DateTimeFormat&, FormattableDateTime const&); ThrowCompletionOr format_date_time(VM&, DateTimeFormat&, FormattableDateTime const&); ThrowCompletionOr> format_date_time_to_parts(VM&, DateTimeFormat&, FormattableDateTime const&); ThrowCompletionOr> partition_date_time_range_pattern(VM&, DateTimeFormat&, FormattableDateTime const& start, FormattableDateTime const& end); ThrowCompletionOr format_date_time_range(VM&, DateTimeFormat&, FormattableDateTime const& start, FormattableDateTime const& end); ThrowCompletionOr> format_date_time_range_to_parts(VM&, DateTimeFormat&, FormattableDateTime const& start, FormattableDateTime const& end); Optional get_date_time_format(Unicode::CalendarPattern const& options, OptionRequired, OptionDefaults, OptionInherit); Unicode::CalendarPattern adjust_date_time_style_format(Unicode::CalendarPattern const& base_format, ReadonlySpan allowed_options); ThrowCompletionOr to_date_time_formattable(VM&, Value); bool is_temporal_object(FormattableDateTime const&); bool same_temporal_type(FormattableDateTime const&, FormattableDateTime const&); ThrowCompletionOr handle_date_time_temporal_date(VM&, DateTimeFormat&, Temporal::PlainDate const&); ThrowCompletionOr handle_date_time_temporal_year_month(VM&, DateTimeFormat&, Temporal::PlainYearMonth const&); ThrowCompletionOr handle_date_time_temporal_month_day(VM&, DateTimeFormat&, Temporal::PlainMonthDay const&); ThrowCompletionOr handle_date_time_temporal_time(VM&, DateTimeFormat&, Temporal::PlainTime const&); ThrowCompletionOr handle_date_time_temporal_date_time(VM&, DateTimeFormat&, Temporal::PlainDateTime const&); ValueFormat handle_date_time_temporal_instant(DateTimeFormat&, Temporal::Instant const&); ThrowCompletionOr handle_date_time_others(VM&, DateTimeFormat&, double); ThrowCompletionOr handle_date_time_value(VM&, DateTimeFormat&, FormattableDateTime const&); template ThrowCompletionOr for_each_calendar_field(VM& vm, Unicode::CalendarPattern& pattern, Callback&& callback) { constexpr auto narrow_short_long = AK::Array { "narrow"sv, "short"sv, "long"sv }; constexpr auto two_digit_numeric = AK::Array { "2-digit"sv, "numeric"sv }; constexpr auto two_digit_numeric_narrow_short_long = AK::Array { "2-digit"sv, "numeric"sv, "narrow"sv, "short"sv, "long"sv }; constexpr auto time_zone = AK::Array { "short"sv, "long"sv, "shortOffset"sv, "longOffset"sv, "shortGeneric"sv, "longGeneric"sv }; // Table 6: Components of date and time formats, https://tc39.es/ecma402/#table-datetimeformat-components TRY(callback(pattern.weekday, vm.names.weekday, narrow_short_long)); TRY(callback(pattern.era, vm.names.era, narrow_short_long)); TRY(callback(pattern.year, vm.names.year, two_digit_numeric)); TRY(callback(pattern.month, vm.names.month, two_digit_numeric_narrow_short_long)); TRY(callback(pattern.day, vm.names.day, two_digit_numeric)); TRY(callback(pattern.day_period, vm.names.dayPeriod, narrow_short_long)); TRY(callback(pattern.hour, vm.names.hour, two_digit_numeric)); TRY(callback(pattern.minute, vm.names.minute, two_digit_numeric)); TRY(callback(pattern.second, vm.names.second, two_digit_numeric)); TRY(callback(pattern.fractional_second_digits, vm.names.fractionalSecondDigits, Empty {})); TRY(callback(pattern.time_zone_name, vm.names.timeZoneName, time_zone)); return {}; } }