7025dd1fa7
Thread UTF-16 string input through JSON, script parsing, Date parsing, Intl option parsing, Temporal parsing, and the helper library boundaries that feed those parsers. Preserve ASCII fast paths where the source data is known to be ASCII.
190 lines
12 KiB
C++
190 lines
12 KiB
C++
/*
|
|
* Copyright (c) 2021-2026, Tim Flynn <trflynn89@ladybird.org>
|
|
*
|
|
* SPDX-License-Identifier: BSD-2-Clause
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <AK/Array.h>
|
|
#include <AK/String.h>
|
|
#include <AK/StringView.h>
|
|
#include <AK/Types.h>
|
|
#include <AK/Utf16View.h>
|
|
#include <AK/Vector.h>
|
|
#include <LibJS/Runtime/Completion.h>
|
|
#include <LibJS/Runtime/Intl/DateTimeFormatConstructor.h>
|
|
#include <LibJS/Runtime/Intl/IntlObject.h>
|
|
#include <LibJS/Runtime/VM.h>
|
|
#include <LibUnicode/DateTimeFormat.h>
|
|
|
|
namespace JS::Intl {
|
|
|
|
class DateTimeFormat final : public IntlObject {
|
|
JS_OBJECT(DateTimeFormat, IntlObject);
|
|
GC_DECLARE_ALLOCATOR(DateTimeFormat);
|
|
|
|
using Patterns = Unicode::CalendarPattern;
|
|
|
|
public:
|
|
virtual ~DateTimeFormat() override = default;
|
|
|
|
virtual ReadonlySpan<StringView> relevant_extension_keys() const override;
|
|
virtual ReadonlySpan<ResolutionOptionDescriptor> resolution_option_descriptors(VM&) const override;
|
|
|
|
String const& locale() const { return m_locale; }
|
|
void set_locale(String locale) { m_locale = move(locale); }
|
|
|
|
String const& icu_locale() const { return m_icu_locale; }
|
|
void set_icu_locale(String icu_locale) { m_icu_locale = move(icu_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<Unicode::DateTimeStyle> 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(Utf16View style) { m_date_style = Unicode::date_time_style_from_string(style); }
|
|
|
|
bool has_time_style() const { return m_time_style.has_value(); }
|
|
Optional<Unicode::DateTimeStyle> 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(Utf16View 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<Unicode::DateTimeFormat> formatter) { m_formatter = move(formatter); }
|
|
|
|
Optional<Unicode::DateTimeFormat const&> temporal_plain_date_formatter();
|
|
void set_temporal_plain_date_format(Optional<Unicode::CalendarPattern> temporal_plain_date_format) { m_temporal_plain_date_format = move(temporal_plain_date_format); }
|
|
|
|
Optional<Unicode::DateTimeFormat const&> temporal_plain_year_month_formatter();
|
|
void set_temporal_plain_year_month_format(Optional<Unicode::CalendarPattern> temporal_plain_year_month_format) { m_temporal_plain_year_month_format = move(temporal_plain_year_month_format); }
|
|
|
|
Optional<Unicode::DateTimeFormat const&> temporal_plain_month_day_formatter();
|
|
void set_temporal_plain_month_day_format(Optional<Unicode::CalendarPattern> temporal_plain_month_day_format) { m_temporal_plain_month_day_format = move(temporal_plain_month_day_format); }
|
|
|
|
Optional<Unicode::DateTimeFormat const&> temporal_plain_time_formatter();
|
|
void set_temporal_plain_time_format(Optional<Unicode::CalendarPattern> temporal_plain_time_format) { m_temporal_plain_time_format = move(temporal_plain_time_format); }
|
|
|
|
Optional<Unicode::DateTimeFormat const&> temporal_plain_date_time_formatter();
|
|
void set_temporal_plain_date_time_format(Optional<Unicode::CalendarPattern> temporal_plain_date_time_format) { m_temporal_plain_date_time_format = move(temporal_plain_date_time_format); }
|
|
|
|
Optional<Unicode::DateTimeFormat const&> temporal_instant_formatter();
|
|
void set_temporal_instant_format(Optional<Unicode::CalendarPattern> 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:
|
|
explicit 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<Unicode::DateTimeStyle> m_date_style; // [[DateStyle]]
|
|
Optional<Unicode::DateTimeStyle> m_time_style; // [[TimeStyle]]
|
|
Unicode::CalendarPattern m_date_time_format; // [[DateTimeFormat]]
|
|
Optional<Unicode::CalendarPattern> m_temporal_plain_date_format; // [[TemporalPlainDateFormat]]
|
|
Optional<Unicode::CalendarPattern> m_temporal_plain_year_month_format; // [[TemporalPlainYearMonthFormat]]
|
|
Optional<Unicode::CalendarPattern> m_temporal_plain_month_day_format; // [[TemporalPlainMonthDayFormat]]
|
|
Optional<Unicode::CalendarPattern> m_temporal_plain_time_format; // [[TemporalPlainTimeFormat]]
|
|
Optional<Unicode::CalendarPattern> m_temporal_plain_date_time_format; // [[TemporalPlainDateTimeFormat]]
|
|
Optional<Unicode::CalendarPattern> m_temporal_instant_format; // [[TemporalInstantFormat]]
|
|
GC::Ptr<NativeFunction> m_bound_format; // [[BoundFormat]]
|
|
|
|
// Non-standard. Stores the ICU date-time formatters for the Intl object's formatting options.
|
|
String m_icu_locale;
|
|
OwnPtr<Unicode::DateTimeFormat> m_formatter;
|
|
OwnPtr<Unicode::DateTimeFormat> m_temporal_plain_date_formatter;
|
|
OwnPtr<Unicode::DateTimeFormat> m_temporal_plain_year_month_formatter;
|
|
OwnPtr<Unicode::DateTimeFormat> m_temporal_plain_month_day_formatter;
|
|
OwnPtr<Unicode::DateTimeFormat> m_temporal_plain_time_formatter;
|
|
OwnPtr<Unicode::DateTimeFormat> m_temporal_plain_date_time_formatter;
|
|
OwnPtr<Unicode::DateTimeFormat> m_temporal_instant_formatter;
|
|
String m_temporal_time_zone;
|
|
};
|
|
|
|
using FormattableDateTime = Variant<
|
|
double,
|
|
GC::Ref<Temporal::PlainDate>,
|
|
GC::Ref<Temporal::PlainYearMonth>,
|
|
GC::Ref<Temporal::PlainMonthDay>,
|
|
GC::Ref<Temporal::PlainTime>,
|
|
GC::Ref<Temporal::PlainDateTime>,
|
|
GC::Ref<Temporal::ZonedDateTime>,
|
|
GC::Ref<Temporal::Instant>>;
|
|
|
|
// 15.6.14 Value Format Records, https://tc39.es/proposal-temporal/#datetimeformat-value-format-record
|
|
// NB: 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.
|
|
// NB: We do not create an [[IsPlain]] internal slot. The spec assumes we have a single formatter, and re-use that
|
|
// formatter for each format invocation. Instead, we have separate formatters for each formattable type. So we bake
|
|
// the [[IsPlain]] aspect into each formatter by using UTC as the formatter's time zone as appropriate.
|
|
struct ValueFormat {
|
|
Unicode::DateTimeFormat const& formatter; // [[Format]]
|
|
double epoch_milliseconds { 0 }; // [[EpochNanoseconds]]
|
|
};
|
|
|
|
Vector<Unicode::DateTimeFormat::Partition> format_date_time_pattern(ValueFormat const&);
|
|
ThrowCompletionOr<Vector<Unicode::DateTimeFormat::Partition>> partition_date_time_pattern(VM&, DateTimeFormat&, FormattableDateTime const&);
|
|
ThrowCompletionOr<Utf16String> format_date_time(VM&, DateTimeFormat&, FormattableDateTime const&);
|
|
ThrowCompletionOr<GC::Ref<Array>> format_date_time_to_parts(VM&, DateTimeFormat&, FormattableDateTime const&);
|
|
ThrowCompletionOr<Vector<Unicode::DateTimeFormat::Partition>> partition_date_time_range_pattern(VM&, DateTimeFormat&, FormattableDateTime const& start, FormattableDateTime const& end);
|
|
ThrowCompletionOr<Utf16String> format_date_time_range(VM&, DateTimeFormat&, FormattableDateTime const& start, FormattableDateTime const& end);
|
|
ThrowCompletionOr<GC::Ref<Array>> format_date_time_range_to_parts(VM&, DateTimeFormat&, FormattableDateTime const& start, FormattableDateTime const& end);
|
|
|
|
Optional<Unicode::CalendarPattern> get_date_time_format(Unicode::CalendarPattern const& options, OptionRequired, OptionDefaults, OptionInherit);
|
|
Unicode::CalendarPattern adjust_date_time_style_format(VM&, Unicode::CalendarPattern& base_format, ReadonlySpan<Unicode::CalendarPattern::Field> allowed_options);
|
|
ThrowCompletionOr<FormattableDateTime> to_date_time_formattable(VM&, Value);
|
|
bool is_temporal_object(FormattableDateTime const&);
|
|
bool same_temporal_type(FormattableDateTime const&, FormattableDateTime const&);
|
|
ThrowCompletionOr<ValueFormat> handle_date_time_temporal_date(VM&, DateTimeFormat&, Temporal::PlainDate const&);
|
|
ThrowCompletionOr<ValueFormat> handle_date_time_temporal_year_month(VM&, DateTimeFormat&, Temporal::PlainYearMonth const&);
|
|
ThrowCompletionOr<ValueFormat> handle_date_time_temporal_month_day(VM&, DateTimeFormat&, Temporal::PlainMonthDay const&);
|
|
ThrowCompletionOr<ValueFormat> handle_date_time_temporal_time(VM&, DateTimeFormat&, Temporal::PlainTime const&);
|
|
ThrowCompletionOr<ValueFormat> handle_date_time_temporal_date_time(VM&, DateTimeFormat&, Temporal::PlainDateTime const&);
|
|
ValueFormat handle_date_time_temporal_instant(DateTimeFormat&, Temporal::Instant const&);
|
|
ThrowCompletionOr<ValueFormat> handle_date_time_others(VM&, DateTimeFormat&, double);
|
|
ThrowCompletionOr<ValueFormat> handle_date_time_value(VM&, DateTimeFormat&, FormattableDateTime const&);
|
|
|
|
template<typename Callback>
|
|
ThrowCompletionOr<void> 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 };
|
|
|
|
using enum Unicode::CalendarPattern::Field;
|
|
|
|
// Table 16: Components of date and time formats, https://tc39.es/ecma402/#table-datetimeformat-components
|
|
TRY(callback(Weekday, pattern.weekday, vm.names.weekday, narrow_short_long));
|
|
TRY(callback(Era, pattern.era, vm.names.era, narrow_short_long));
|
|
TRY(callback(Year, pattern.year, vm.names.year, two_digit_numeric));
|
|
TRY(callback(Month, pattern.month, vm.names.month, two_digit_numeric_narrow_short_long));
|
|
TRY(callback(Day, pattern.day, vm.names.day, two_digit_numeric));
|
|
TRY(callback(DayPeriod, pattern.day_period, vm.names.dayPeriod, narrow_short_long));
|
|
TRY(callback(Hour, pattern.hour, vm.names.hour, two_digit_numeric));
|
|
TRY(callback(Minute, pattern.minute, vm.names.minute, two_digit_numeric));
|
|
TRY(callback(Second, pattern.second, vm.names.second, two_digit_numeric));
|
|
TRY(callback(FractionalSecondDigits, pattern.fractional_second_digits, vm.names.fractionalSecondDigits, Empty {}));
|
|
TRY(callback(TimeZoneName, pattern.time_zone_name, vm.names.timeZoneName, time_zone));
|
|
|
|
return {};
|
|
}
|
|
|
|
}
|