/* * Copyright (c) 2021-2023, Linus Groh * Copyright (c) 2024, Shannon Booth * Copyright (c) 2024, Tim Flynn * * SPDX-License-Identifier: BSD-2-Clause */ #include #include #include #include #include #include #include #include #include namespace JS::Temporal { // 11.1.5 FormatOffsetTimeZoneIdentifier ( offsetMinutes [ , style ] ), https://tc39.es/proposal-temporal/#sec-temporal-formatoffsettimezoneidentifier String format_offset_time_zone_identifier(i64 offset_minutes, Optional style) { // 1. If offsetMinutes ≥ 0, let sign be the code unit 0x002B (PLUS SIGN); otherwise, let sign be the code unit 0x002D (HYPHEN-MINUS). auto sign = offset_minutes >= 0 ? '+' : '-'; // 2. Let absoluteMinutes be abs(offsetMinutes). auto absolute_minutes = abs(offset_minutes); // 3. Let hour be floor(absoluteMinutes / 60). auto hour = static_cast(floor(static_cast(absolute_minutes) / 60.0)); // 4. Let minute be absoluteMinutes modulo 60. auto minute = static_cast(modulo(static_cast(absolute_minutes), 60.0)); // 5. Let timeString be FormatTimeString(hour, minute, 0, 0, MINUTE, style). auto time_string = format_time_string(hour, minute, 0, 0, SecondsStringPrecision::Minute {}, style); // 6. Return the string-concatenation of sign and timeString. return MUST(String::formatted("{}{}", sign, time_string)); } // 11.1.8 ToTemporalTimeZoneIdentifier ( temporalTimeZoneLike ), https://tc39.es/proposal-temporal/#sec-temporal-totemporaltimezoneidentifier ThrowCompletionOr to_temporal_time_zone_identifier(VM& vm, Value temporal_time_zone_like) { // 1. If temporalTimeZoneLike is an Object, then if (temporal_time_zone_like.is_object()) { // FIXME: a. If temporalTimeZoneLike has an [[InitializedTemporalZonedDateTime]] internal slot, then // FIXME: i. Return temporalTimeZoneLike.[[TimeZone]]. } // 2. If temporalTimeZoneLike is not a String, throw a TypeError exception. if (!temporal_time_zone_like.is_string()) return vm.throw_completion(ErrorType::TemporalInvalidTimeZoneName, temporal_time_zone_like); return to_temporal_time_zone_identifier(vm, temporal_time_zone_like.as_string().utf8_string_view()); } // 11.1.8 ToTemporalTimeZoneIdentifier ( temporalTimeZoneLike ), https://tc39.es/proposal-temporal/#sec-temporal-totemporaltimezoneidentifier ThrowCompletionOr to_temporal_time_zone_identifier(VM& vm, StringView temporal_time_zone_like) { // 3. Let parseResult be ? ParseTemporalTimeZoneString(temporalTimeZoneLike). auto parse_result = TRY(parse_temporal_time_zone_string(vm, temporal_time_zone_like)); // 4. Let offsetMinutes be parseResult.[[OffsetMinutes]]. // 5. If offsetMinutes is not empty, return FormatOffsetTimeZoneIdentifier(offsetMinutes). if (parse_result.offset_minutes.has_value()) return format_offset_time_zone_identifier(*parse_result.offset_minutes); // 6. Let name be parseResult.[[Name]]. // 7. Let timeZoneIdentifierRecord be GetAvailableNamedTimeZoneIdentifier(name). auto time_zone_identifier_record = Intl::get_available_named_time_zone_identifier(*parse_result.name); // 8. If timeZoneIdentifierRecord is empty, throw a RangeError exception. if (!time_zone_identifier_record.has_value()) return vm.throw_completion(ErrorType::TemporalInvalidTimeZoneName, temporal_time_zone_like); // 9. Return timeZoneIdentifierRecord.[[Identifier]]. return time_zone_identifier_record->identifier; } // 11.1.11 GetEpochNanosecondsFor ( timeZone, isoDateTime, disambiguation ), https://tc39.es/proposal-temporal/#sec-temporal-getepochnanosecondsfor ThrowCompletionOr get_epoch_nanoseconds_for(VM& vm, StringView time_zone, ISODateTime const& iso_date_time, Disambiguation disambiguation) { // 1. Let possibleEpochNs be ? GetPossibleEpochNanoseconds(timeZone, isoDateTime). auto possible_epoch_ns = TRY(get_possible_epoch_nanoseconds(vm, time_zone, iso_date_time)); // 2. Return ? DisambiguatePossibleEpochNanoseconds(possibleEpochNs, timeZone, isoDateTime, disambiguation). return TRY(disambiguate_possible_epoch_nanoseconds(vm, move(possible_epoch_ns), time_zone, iso_date_time, disambiguation)); } // 11.1.12 DisambiguatePossibleEpochNanoseconds ( possibleEpochNs, timeZone, isoDateTime, disambiguation ), https://tc39.es/proposal-temporal/#sec-temporal-disambiguatepossibleepochnanoseconds ThrowCompletionOr disambiguate_possible_epoch_nanoseconds(VM& vm, Vector possible_epoch_ns, StringView time_zone, ISODateTime const& iso_date_time, Disambiguation disambiguation) { // 1. Let n be possibleEpochNs's length. auto n = possible_epoch_ns.size(); // 2. If n = 1, then if (n == 1) { // a. Return possibleEpochNs[0]. return move(possible_epoch_ns[0]); } // 3. If n ≠ 0, then if (n != 0) { // a. If disambiguation is EARLIER or COMPATIBLE, then if (disambiguation == Disambiguation::Earlier || disambiguation == Disambiguation::Compatible) { // i. Return possibleEpochNs[0]. return move(possible_epoch_ns[0]); } // b. If disambiguation is LATER, then if (disambiguation == Disambiguation::Later) { // i. Return possibleEpochNs[n - 1]. return move(possible_epoch_ns[n - 1]); } // c. Assert: disambiguation is REJECT. VERIFY(disambiguation == Disambiguation::Reject); // d. Throw a RangeError exception. return vm.throw_completion(ErrorType::TemporalDisambiguatePossibleEpochNSRejectMoreThanOne); } // 4. Assert: n = 0. VERIFY(n == 0); // 5. If disambiguation is REJECT, then if (disambiguation == Disambiguation::Reject) { // a. Throw a RangeError exception. return vm.throw_completion(ErrorType::TemporalDisambiguatePossibleEpochNSRejectZero); } // FIXME: GetNamedTimeZoneEpochNanoseconds currently does not produce zero instants. (void)time_zone; (void)iso_date_time; TODO(); } // 11.1.13 GetPossibleEpochNanoseconds ( timeZone, isoDateTime ), https://tc39.es/proposal-temporal/#sec-temporal-getpossibleepochnanoseconds ThrowCompletionOr> get_possible_epoch_nanoseconds(VM& vm, StringView time_zone, ISODateTime const& iso_date_time) { Vector possible_epoch_nanoseconds; // 1. Let parseResult be ! ParseTimeZoneIdentifier(timeZone). auto parse_result = parse_time_zone_identifier(time_zone); // 2. If parseResult.[[OffsetMinutes]] is not empty, then if (parse_result.offset_minutes.has_value()) { // a. Let balanced be BalanceISODateTime(isoDateTime.[[ISODate]].[[Year]], isoDateTime.[[ISODate]].[[Month]], isoDateTime.[[ISODate]].[[Day]], isoDateTime.[[Time]].[[Hour]], isoDateTime.[[Time]].[[Minute]] - parseResult.[[OffsetMinutes]], isoDateTime.[[Time]].[[Second]], isoDateTime.[[Time]].[[Millisecond]], isoDateTime.[[Time]].[[Microsecond]], isoDateTime.[[Time]].[[Nanosecond]]). auto balanced = balance_iso_date_time( iso_date_time.iso_date.year, iso_date_time.iso_date.month, iso_date_time.iso_date.day, iso_date_time.time.hour, static_cast(iso_date_time.time.minute) - static_cast(*parse_result.offset_minutes), iso_date_time.time.second, iso_date_time.time.millisecond, iso_date_time.time.microsecond, iso_date_time.time.nanosecond); // b. Perform ? CheckISODaysRange(balanced.[[ISODate]]). TRY(check_iso_days_range(vm, balanced.iso_date)); // c. Let epochNanoseconds be GetUTCEpochNanoseconds(balanced). auto epoch_nanoseconds = get_utc_epoch_nanoseconds(balanced); // d. Let possibleEpochNanoseconds be « epochNanoseconds ». possible_epoch_nanoseconds.append(move(epoch_nanoseconds)); } // 3. Else, else { // a. Perform ? CheckISODaysRange(isoDateTime.[[ISODate]]). TRY(check_iso_days_range(vm, iso_date_time.iso_date)); // b. Let possibleEpochNanoseconds be GetNamedTimeZoneEpochNanoseconds(parseResult.[[Name]], isoDateTime). possible_epoch_nanoseconds = get_named_time_zone_epoch_nanoseconds( *parse_result.name, iso_date_time.iso_date.year, iso_date_time.iso_date.month, iso_date_time.iso_date.day, iso_date_time.time.hour, iso_date_time.time.minute, iso_date_time.time.second, iso_date_time.time.millisecond, iso_date_time.time.microsecond, iso_date_time.time.nanosecond); } // 4. For each value epochNanoseconds in possibleEpochNanoseconds, do for (auto const& epoch_nanoseconds : possible_epoch_nanoseconds) { // a. If IsValidEpochNanoseconds(epochNanoseconds) is false, throw a RangeError exception. if (!is_valid_epoch_nanoseconds(epoch_nanoseconds)) return vm.throw_completion(ErrorType::TemporalInvalidEpochNanoseconds); } // 5. Return possibleEpochNanoseconds. return possible_epoch_nanoseconds; } // 11.1.16 ParseTimeZoneIdentifier ( identifier ), https://tc39.es/proposal-temporal/#sec-parsetimezoneidentifier ThrowCompletionOr parse_time_zone_identifier(VM& vm, StringView identifier) { // 1. Let parseResult be ParseText(StringToCodePoints(identifier), TimeZoneIdentifier). auto parse_result = parse_iso8601(Production::TimeZoneIdentifier, identifier); // 2. If parseResult is a List of errors, throw a RangeError exception. if (!parse_result.has_value()) return vm.throw_completion(ErrorType::TemporalInvalidTimeZoneString, identifier); return parse_time_zone_identifier(*parse_result); } // 11.1.16 ParseTimeZoneIdentifier ( identifier ), https://tc39.es/proposal-temporal/#sec-parsetimezoneidentifier TimeZone parse_time_zone_identifier(StringView identifier) { // OPTIMIZATION: Some callers can assume that parsing will succeed. // 1. Let parseResult be ParseText(StringToCodePoints(identifier), TimeZoneIdentifier). auto parse_result = parse_iso8601(Production::TimeZoneIdentifier, identifier); VERIFY(parse_result.has_value()); return parse_time_zone_identifier(*parse_result); } // 11.1.16 ParseTimeZoneIdentifier ( identifier ), https://tc39.es/proposal-temporal/#sec-parsetimezoneidentifier TimeZone parse_time_zone_identifier(ParseResult const& parse_result) { // OPTIMIZATION: Some callers will have already parsed and validated the time zone identifier. // 3. If parseResult contains a TimeZoneIANAName Parse Node, then if (parse_result.time_zone_iana_name.has_value()) { // a. Let name be the source text matched by the TimeZoneIANAName Parse Node contained within parseResult. // b. NOTE: name is syntactically valid, but does not necessarily conform to IANA Time Zone Database naming // guidelines or correspond with an available named time zone identifier. // c. Return the Record { [[Name]]: CodePointsToString(name), [[OffsetMinutes]]: empty }. return TimeZone { .name = String::from_utf8_without_validation(parse_result.time_zone_iana_name->bytes()), .offset_minutes = {} }; } // 4. Else, else { // a. Assert: parseResult contains a UTCOffset[~SubMinutePrecision] Parse Node. VERIFY(parse_result.time_zone_offset.has_value()); // b. Let offsetString be the source text matched by the UTCOffset[~SubMinutePrecision] Parse Node contained within parseResult. // c. Let offsetNanoseconds be ! ParseDateTimeUTCOffset(offsetString). auto offset_nanoseconds = parse_date_time_utc_offset(parse_result.time_zone_offset->source_text); // d. Let offsetMinutes be offsetNanoseconds / (60 × 10**9). auto offset_minutes = offset_nanoseconds / 60'000'000'000; // e. Assert: offsetMinutes is an integer. VERIFY(trunc(offset_minutes) == offset_minutes); // f. Return the Record { [[Name]]: empty, [[OffsetMinutes]]: offsetMinutes }. return TimeZone { .name = {}, .offset_minutes = static_cast(offset_minutes) }; } } }