Duration.cpp 74 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468
  1. /*
  2. * Copyright (c) 2021-2023, Linus Groh <linusg@serenityos.org>
  3. * Copyright (c) 2021, Luke Wilde <lukew@serenityos.org>
  4. * Copyright (c) 2024, Shannon Booth <shannon@serenityos.org>
  5. * Copyright (c) 2024, Tim Flynn <trflynn89@ladybird.org>
  6. *
  7. * SPDX-License-Identifier: BSD-2-Clause
  8. */
  9. #include <AK/Math.h>
  10. #include <AK/NumericLimits.h>
  11. #include <LibJS/Runtime/AbstractOperations.h>
  12. #include <LibJS/Runtime/Date.h>
  13. #include <LibJS/Runtime/Intrinsics.h>
  14. #include <LibJS/Runtime/Realm.h>
  15. #include <LibJS/Runtime/Temporal/Calendar.h>
  16. #include <LibJS/Runtime/Temporal/Duration.h>
  17. #include <LibJS/Runtime/Temporal/DurationConstructor.h>
  18. #include <LibJS/Runtime/Temporal/Instant.h>
  19. #include <LibJS/Runtime/Temporal/PlainDateTime.h>
  20. #include <LibJS/Runtime/Temporal/TimeZone.h>
  21. #include <LibJS/Runtime/VM.h>
  22. #include <LibJS/Runtime/ValueInlines.h>
  23. #include <math.h>
  24. namespace JS::Temporal {
  25. GC_DEFINE_ALLOCATOR(Duration);
  26. // 7 Temporal.Duration Objects, https://tc39.es/proposal-temporal/#sec-temporal-duration-objects
  27. Duration::Duration(double years, double months, double weeks, double days, double hours, double minutes, double seconds, double milliseconds, double microseconds, double nanoseconds, Object& prototype)
  28. : Object(ConstructWithPrototypeTag::Tag, prototype)
  29. , m_years(years)
  30. , m_months(months)
  31. , m_weeks(weeks)
  32. , m_days(days)
  33. , m_hours(hours)
  34. , m_minutes(minutes)
  35. , m_seconds(seconds)
  36. , m_milliseconds(milliseconds)
  37. , m_microseconds(microseconds)
  38. , m_nanoseconds(nanoseconds)
  39. {
  40. auto fields = AK::Array {
  41. &Duration::m_years,
  42. &Duration::m_months,
  43. &Duration::m_weeks,
  44. &Duration::m_days,
  45. &Duration::m_hours,
  46. &Duration::m_minutes,
  47. &Duration::m_seconds,
  48. &Duration::m_milliseconds,
  49. &Duration::m_microseconds,
  50. &Duration::m_nanoseconds,
  51. };
  52. // NOTE: The spec stores these fields as mathematical values. VERIFY() that we have finite, integral values in them,
  53. // and normalize any negative zeros caused by floating point math. This is usually done using ℝ(𝔽(value)) at
  54. // the call site.
  55. for (auto const& field : fields) {
  56. auto& value = this->*field;
  57. VERIFY(isfinite(value));
  58. // FIXME: test-js contains a small number of cases where a Temporal.Duration is constructed with a non-integral
  59. // double. Eliminate these and VERIFY(trunc(value) == value) instead.
  60. if (trunc(value) != value)
  61. value = trunc(value);
  62. else if (bit_cast<u64>(value) == NEGATIVE_ZERO_BITS)
  63. value = 0;
  64. }
  65. }
  66. // maxTimeDuration = 2**53 × 10**9 - 1 = 9,007,199,254,740,991,999,999,999
  67. TimeDuration const MAX_TIME_DURATION = "9007199254740991999999999"_sbigint;
  68. // 7.5.4 ZeroDateDuration ( ), https://tc39.es/proposal-temporal/#sec-temporal-zerodateduration
  69. DateDuration zero_date_duration(VM& vm)
  70. {
  71. // 1. Return ! CreateDateDurationRecord(0, 0, 0, 0).
  72. return MUST(create_date_duration_record(vm, 0, 0, 0, 0));
  73. }
  74. // 7.5.5 ToInternalDurationRecord ( duration ), https://tc39.es/proposal-temporal/#sec-temporal-tointernaldurationrecord
  75. InternalDuration to_internal_duration_record(VM& vm, Duration const& duration)
  76. {
  77. // 1. Let dateDuration be ! CreateDateDurationRecord(duration.[[Years]], duration.[[Months]], duration.[[Weeks]], duration.[[Days]]).
  78. auto date_duration = MUST(create_date_duration_record(vm, duration.years(), duration.months(), duration.weeks(), duration.days()));
  79. // 2. Let timeDuration be TimeDurationFromComponents(duration.[[Hours]], duration.[[Minutes]], duration.[[Seconds]], duration.[[Milliseconds]], duration.[[Microseconds]], duration.[[Nanoseconds]]).
  80. auto time_duration = time_duration_from_components(duration.hours(), duration.minutes(), duration.seconds(), duration.milliseconds(), duration.microseconds(), duration.nanoseconds());
  81. // 3. Return ! CombineDateAndTimeDuration(dateDuration, timeDuration).
  82. return MUST(combine_date_and_time_duration(vm, date_duration, move(time_duration)));
  83. }
  84. // 7.5.6 ToInternalDurationRecordWith24HourDays ( duration ), https://tc39.es/proposal-temporal/#sec-temporal-tointernaldurationrecordwith24hourdays
  85. InternalDuration to_internal_duration_record_with_24_hour_days(VM& vm, Duration const& duration)
  86. {
  87. // 1. Let timeDuration be TimeDurationFromComponents(duration.[[Hours]], duration.[[Minutes]], duration.[[Seconds]], duration.[[Milliseconds]], duration.[[Microseconds]], duration.[[Nanoseconds]]).
  88. auto time_duration = time_duration_from_components(duration.hours(), duration.minutes(), duration.seconds(), duration.milliseconds(), duration.microseconds(), duration.nanoseconds());
  89. // 2. Set timeDuration to ! Add24HourDaysToTimeDuration(timeDuration, duration.[[Days]]).
  90. time_duration = MUST(add_24_hour_days_to_time_duration(vm, time_duration, duration.days()));
  91. // 3. Let dateDuration be ! CreateDateDurationRecord(duration.[[Years]], duration.[[Months]], duration.[[Weeks]], 0).
  92. auto date_duration = MUST(create_date_duration_record(vm, duration.years(), duration.months(), duration.weeks(), 0));
  93. // 4. Return ! CombineDateAndTimeDuration(dateDuration, timeDuration).
  94. return MUST(combine_date_and_time_duration(vm, date_duration, move(time_duration)));
  95. }
  96. // 7.5.8 TemporalDurationFromInternal ( internalDuration, largestUnit ), https://tc39.es/proposal-temporal/#sec-temporal-temporaldurationfrominternal
  97. ThrowCompletionOr<GC::Ref<Duration>> temporal_duration_from_internal(VM& vm, InternalDuration const& internal_duration, Unit largest_unit)
  98. {
  99. // 1. Let days, hours, minutes, seconds, milliseconds, and microseconds be 0.
  100. double days = 0;
  101. double hours = 0;
  102. double minutes = 0;
  103. double seconds = 0;
  104. double milliseconds = 0;
  105. double microseconds = 0;
  106. // 2. Let sign be TimeDurationSign(internalDuration.[[Time]]).
  107. auto sign = time_duration_sign(internal_duration.time);
  108. // 3. Let nanoseconds be abs(internalDuration.[[Time]]).
  109. auto const& absolute_nanoseconds = internal_duration.time.unsigned_value();
  110. double nanoseconds = 0;
  111. // 4. If TemporalUnitCategory(largestUnit) is date, then
  112. if (temporal_unit_category(largest_unit) == UnitCategory::Date) {
  113. // a. Set microseconds to floor(nanoseconds / 1000).
  114. auto nanoseconds_division_result = absolute_nanoseconds.divided_by(NANOSECONDS_PER_MICROSECOND);
  115. // b. Set nanoseconds to nanoseconds modulo 1000.
  116. nanoseconds = nanoseconds_division_result.remainder.to_double();
  117. // c. Set milliseconds to floor(microseconds / 1000).
  118. auto microseconds_division_result = nanoseconds_division_result.quotient.divided_by(MICROSECONDS_PER_MILLISECOND);
  119. // d. Set microseconds to microseconds modulo 1000.
  120. microseconds = microseconds_division_result.remainder.to_double();
  121. // e. Set seconds to floor(milliseconds / 1000).
  122. auto milliseconds_division_result = microseconds_division_result.quotient.divided_by(MILLISECONDS_PER_SECOND);
  123. // f. Set milliseconds to milliseconds modulo 1000.
  124. milliseconds = milliseconds_division_result.remainder.to_double();
  125. // g. Set minutes to floor(seconds / 60).
  126. auto seconds_division_result = milliseconds_division_result.quotient.divided_by(SECONDS_PER_MINUTE);
  127. // h. Set seconds to seconds modulo 60.
  128. seconds = seconds_division_result.remainder.to_double();
  129. // i. Set hours to floor(minutes / 60).
  130. auto minutes_division_result = seconds_division_result.quotient.divided_by(MINUTES_PER_HOUR);
  131. // j. Set minutes to minutes modulo 60.
  132. minutes = minutes_division_result.remainder.to_double();
  133. // k. Set days to floor(hours / 24).
  134. auto hours_division_result = minutes_division_result.quotient.divided_by(HOURS_PER_DAY);
  135. days = hours_division_result.quotient.to_double();
  136. // l. Set hours to hours modulo 24.
  137. hours = hours_division_result.remainder.to_double();
  138. }
  139. // 5. Else if largestUnit is hour, then
  140. else if (largest_unit == Unit::Hour) {
  141. // a. Set microseconds to floor(nanoseconds / 1000).
  142. auto nanoseconds_division_result = absolute_nanoseconds.divided_by(NANOSECONDS_PER_MICROSECOND);
  143. // b. Set nanoseconds to nanoseconds modulo 1000.
  144. nanoseconds = nanoseconds_division_result.remainder.to_double();
  145. // c. Set milliseconds to floor(microseconds / 1000).
  146. auto microseconds_division_result = nanoseconds_division_result.quotient.divided_by(MICROSECONDS_PER_MILLISECOND);
  147. // d. Set microseconds to microseconds modulo 1000.
  148. microseconds = microseconds_division_result.remainder.to_double();
  149. // e. Set seconds to floor(milliseconds / 1000).
  150. auto milliseconds_division_result = microseconds_division_result.quotient.divided_by(MILLISECONDS_PER_SECOND);
  151. // f. Set milliseconds to milliseconds modulo 1000.
  152. milliseconds = milliseconds_division_result.remainder.to_double();
  153. // g. Set minutes to floor(seconds / 60).
  154. auto seconds_division_result = milliseconds_division_result.quotient.divided_by(SECONDS_PER_MINUTE);
  155. // h. Set seconds to seconds modulo 60.
  156. seconds = seconds_division_result.remainder.to_double();
  157. // i. Set hours to floor(minutes / 60).
  158. auto minutes_division_result = seconds_division_result.quotient.divided_by(MINUTES_PER_HOUR);
  159. hours = minutes_division_result.quotient.to_double();
  160. // j. Set minutes to minutes modulo 60.
  161. minutes = minutes_division_result.remainder.to_double();
  162. }
  163. // 6. Else if largestUnit is minute, then
  164. else if (largest_unit == Unit::Minute) {
  165. // a. Set microseconds to floor(nanoseconds / 1000).
  166. auto nanoseconds_division_result = absolute_nanoseconds.divided_by(Crypto::UnsignedBigInteger(NANOSECONDS_PER_MICROSECOND));
  167. // b. Set nanoseconds to nanoseconds modulo 1000.
  168. nanoseconds = nanoseconds_division_result.remainder.to_double();
  169. // c. Set milliseconds to floor(microseconds / 1000).
  170. auto microseconds_division_result = nanoseconds_division_result.quotient.divided_by(MICROSECONDS_PER_MILLISECOND);
  171. // d. Set microseconds to microseconds modulo 1000.
  172. microseconds = microseconds_division_result.remainder.to_double();
  173. // e. Set seconds to floor(milliseconds / 1000).
  174. auto milliseconds_division_result = microseconds_division_result.quotient.divided_by(MILLISECONDS_PER_SECOND);
  175. // f. Set milliseconds to milliseconds modulo 1000.
  176. milliseconds = milliseconds_division_result.remainder.to_double();
  177. // g. Set minutes to floor(seconds / 60).
  178. auto seconds_division_result = milliseconds_division_result.quotient.divided_by(SECONDS_PER_MINUTE);
  179. minutes = seconds_division_result.quotient.to_double();
  180. // h. Set seconds to seconds modulo 60.
  181. seconds = seconds_division_result.remainder.to_double();
  182. }
  183. // 7. Else if largestUnit is second, then
  184. else if (largest_unit == Unit::Second) {
  185. // a. Set microseconds to floor(nanoseconds / 1000).
  186. auto nanoseconds_division_result = absolute_nanoseconds.divided_by(NANOSECONDS_PER_MICROSECOND);
  187. // b. Set nanoseconds to nanoseconds modulo 1000.
  188. nanoseconds = nanoseconds_division_result.remainder.to_double();
  189. // c. Set milliseconds to floor(microseconds / 1000).
  190. auto microseconds_division_result = nanoseconds_division_result.quotient.divided_by(MICROSECONDS_PER_MILLISECOND);
  191. // d. Set microseconds to microseconds modulo 1000.
  192. microseconds = microseconds_division_result.remainder.to_double();
  193. // e. Set seconds to floor(milliseconds / 1000).
  194. auto milliseconds_division_result = microseconds_division_result.quotient.divided_by(MILLISECONDS_PER_SECOND);
  195. seconds = milliseconds_division_result.quotient.to_double();
  196. // f. Set milliseconds to milliseconds modulo 1000.
  197. milliseconds = milliseconds_division_result.remainder.to_double();
  198. }
  199. // 8. Else if largestUnit is millisecond, then
  200. else if (largest_unit == Unit::Millisecond) {
  201. // a. Set microseconds to floor(nanoseconds / 1000).
  202. auto nanoseconds_division_result = absolute_nanoseconds.divided_by(NANOSECONDS_PER_MICROSECOND);
  203. // b. Set nanoseconds to nanoseconds modulo 1000.
  204. nanoseconds = nanoseconds_division_result.remainder.to_double();
  205. // c. Set milliseconds to floor(microseconds / 1000).
  206. auto microseconds_division_result = nanoseconds_division_result.quotient.divided_by(MICROSECONDS_PER_MILLISECOND);
  207. milliseconds = microseconds_division_result.quotient.to_double();
  208. // d. Set microseconds to microseconds modulo 1000.
  209. microseconds = microseconds_division_result.remainder.to_double();
  210. }
  211. // 9. Else if largestUnit is microsecond, then
  212. else if (largest_unit == Unit::Microsecond) {
  213. // a. Set microseconds to floor(nanoseconds / 1000).
  214. auto nanoseconds_division_result = absolute_nanoseconds.divided_by(NANOSECONDS_PER_MICROSECOND);
  215. microseconds = nanoseconds_division_result.quotient.to_double();
  216. // b. Set nanoseconds to nanoseconds modulo 1000.
  217. nanoseconds = nanoseconds_division_result.remainder.to_double();
  218. }
  219. // 10. Else,
  220. else {
  221. // a. Assert: largestUnit is nanosecond.
  222. VERIFY(largest_unit == Unit::Nanosecond);
  223. nanoseconds = absolute_nanoseconds.to_double();
  224. }
  225. // 11. NOTE: When largestUnit is millisecond, microsecond, or nanosecond, milliseconds, microseconds, or nanoseconds
  226. // may be an unsafe integer. In this case, care must be taken when implementing the calculation using floating
  227. // point arithmetic. It can be implemented in C++ using std::fma(). String manipulation will also give an exact
  228. // result, since the multiplication is by a power of 10.
  229. // 12. Return ? CreateTemporalDuration(internalDuration.[[Date]].[[Years]], internalDuration.[[Date]].[[Months]], internalDuration.[[Date]].[[Weeks]], internalDuration.[[Date]].[[Days]] + days × sign, hours × sign, minutes × sign, seconds × sign, milliseconds × sign, microseconds × sign, nanoseconds × sign).
  230. return TRY(create_temporal_duration(vm, internal_duration.date.years, internal_duration.date.months, internal_duration.date.weeks, internal_duration.date.days + (days * sign), hours * sign, minutes * sign, seconds * sign, milliseconds * sign, microseconds * sign, nanoseconds * sign));
  231. }
  232. // 7.5.9 CreateDateDurationRecord ( years, months, weeks, days ), https://tc39.es/proposal-temporal/#sec-temporal-createdatedurationrecord
  233. ThrowCompletionOr<DateDuration> create_date_duration_record(VM& vm, double years, double months, double weeks, double days)
  234. {
  235. // 1. If IsValidDuration(years, months, weeks, days, 0, 0, 0, 0, 0, 0) is false, throw a RangeError exception.
  236. if (!is_valid_duration(years, months, weeks, days, 0, 0, 0, 0, 0, 0))
  237. return vm.throw_completion<RangeError>(ErrorType::TemporalInvalidDuration);
  238. // 2. Return Date Duration Record { [[Years]]: ℝ(𝔽(years)), [[Months]]: ℝ(𝔽(months)), [[Weeks]]: ℝ(𝔽(weeks)), [[Days]]: ℝ(𝔽(days)) }.
  239. return DateDuration { years, months, weeks, days };
  240. }
  241. // 7.5.10 AdjustDateDurationRecord ( dateDuration, days [ , weeks [ , months ] ] ), https://tc39.es/proposal-temporal/#sec-temporal-adjustdatedurationrecord
  242. ThrowCompletionOr<DateDuration> adjust_date_duration_record(VM& vm, DateDuration const& date_duration, double days, Optional<double> weeks, Optional<double> months)
  243. {
  244. // 1. If weeks is not present, set weeks to dateDuration.[[Weeks]].
  245. if (!weeks.has_value())
  246. weeks = date_duration.weeks;
  247. // 2. If months is not present, set months to dateDuration.[[Months]].
  248. if (!months.has_value())
  249. months = date_duration.months;
  250. // 3. Return ? CreateDateDurationRecord(dateDuration.[[Years]], months, weeks, days).
  251. return TRY(create_date_duration_record(vm, date_duration.years, *months, *weeks, days));
  252. }
  253. // 7.5.11 CombineDateAndTimeDuration ( dateDuration, timeDuration ), https://tc39.es/proposal-temporal/#sec-temporal-combinedateandtimeduration
  254. ThrowCompletionOr<InternalDuration> combine_date_and_time_duration(VM& vm, DateDuration date_duration, TimeDuration time_duration)
  255. {
  256. // 1. Let dateSign be DateDurationSign(dateDuration).
  257. auto date_sign = date_duration_sign(date_duration);
  258. // 2. Let timeSign be TimeDurationSign(timeDuration).
  259. auto time_sign = time_duration_sign(time_duration);
  260. // 3. If dateSign ≠ 0 and timeSign ≠ 0 and dateSign ≠ timeSign, throw a RangeError exception.
  261. if (date_sign != 0 && time_sign != 0 && date_sign != time_sign)
  262. return vm.throw_completion<RangeError>(ErrorType::TemporalInvalidDuration);
  263. // 4. Return Internal Duration Record { [[Date]]: dateDuration, [[Time]]: timeDuration }.
  264. return InternalDuration { date_duration, move(time_duration) };
  265. }
  266. // 7.5.12 ToTemporalDuration ( item ), https://tc39.es/proposal-temporal/#sec-temporal-totemporalduration
  267. ThrowCompletionOr<GC::Ref<Duration>> to_temporal_duration(VM& vm, Value item)
  268. {
  269. // 1. If item is an Object and item has an [[InitializedTemporalDuration]] internal slot, then
  270. if (item.is_object() && is<Duration>(item.as_object())) {
  271. auto const& duration = static_cast<Duration const&>(item.as_object());
  272. // a. Return ! CreateTemporalDuration(item.[[Years]], item.[[Months]], item.[[Weeks]], item.[[Days]], item.[[Hours]], item.[[Minutes]], item.[[Seconds]], item.[[Milliseconds]], item.[[Microseconds]], item.[[Nanoseconds]]).
  273. return MUST(create_temporal_duration(vm, duration.years(), duration.months(), duration.weeks(), duration.days(), duration.hours(), duration.minutes(), duration.seconds(), duration.milliseconds(), duration.microseconds(), duration.nanoseconds()));
  274. }
  275. // 2. If item is not an Object, then
  276. if (!item.is_object()) {
  277. // a. If item is not a String, throw a TypeError exception.
  278. if (!item.is_string())
  279. return vm.throw_completion<TypeError>(ErrorType::NotAString, item);
  280. // b. Return ? ParseTemporalDurationString(item).
  281. return TRY(parse_temporal_duration_string(vm, item.as_string().utf8_string_view()));
  282. }
  283. // 3. Let result be a new Partial Duration Record with each field set to 0.
  284. auto result = PartialDuration::zero();
  285. // 4. Let partial be ? ToTemporalPartialDurationRecord(item).
  286. auto partial = TRY(to_temporal_partial_duration_record(vm, item));
  287. // 5. If partial.[[Years]] is not undefined, set result.[[Years]] to partial.[[Years]].
  288. if (partial.years.has_value())
  289. result.years = *partial.years;
  290. // 6. If partial.[[Months]] is not undefined, set result.[[Months]] to partial.[[Months]].
  291. if (partial.months.has_value())
  292. result.months = *partial.months;
  293. // 7. If partial.[[Weeks]] is not undefined, set result.[[Weeks]] to partial.[[Weeks]].
  294. if (partial.weeks.has_value())
  295. result.weeks = *partial.weeks;
  296. // 8. If partial.[[Days]] is not undefined, set result.[[Days]] to partial.[[Days]].
  297. if (partial.days.has_value())
  298. result.days = *partial.days;
  299. // 9. If partial.[[Hours]] is not undefined, set result.[[Hours]] to partial.[[Hours]].
  300. if (partial.hours.has_value())
  301. result.hours = *partial.hours;
  302. // 10. If partial.[[Minutes]] is not undefined, set result.[[Minutes]] to partial.[[Minutes]].
  303. if (partial.minutes.has_value())
  304. result.minutes = *partial.minutes;
  305. // 11. If partial.[[Seconds]] is not undefined, set result.[[Seconds]] to partial.[[Seconds]].
  306. if (partial.seconds.has_value())
  307. result.seconds = *partial.seconds;
  308. // 12. If partial.[[Milliseconds]] is not undefined, set result.[[Milliseconds]] to partial.[[Milliseconds]].
  309. if (partial.milliseconds.has_value())
  310. result.milliseconds = *partial.milliseconds;
  311. // 13. If partial.[[Microseconds]] is not undefined, set result.[[Microseconds]] to partial.[[Microseconds]].
  312. if (partial.microseconds.has_value())
  313. result.microseconds = *partial.microseconds;
  314. // 14. If partial.[[Nanoseconds]] is not undefined, set result.[[Nanoseconds]] to partial.[[Nanoseconds]].
  315. if (partial.nanoseconds.has_value())
  316. result.nanoseconds = *partial.nanoseconds;
  317. // 15. Return ? CreateTemporalDuration(result.[[Years]], result.[[Months]], result.[[Weeks]], result.[[Days]], result.[[Hours]], result.[[Minutes]], result.[[Seconds]], result.[[Milliseconds]], result.[[Microseconds]], result.[[Nanoseconds]]).
  318. return TRY(create_temporal_duration(vm, *result.years, *result.months, *result.weeks, *result.days, *result.hours, *result.minutes, *result.seconds, *result.milliseconds, *result.microseconds, *result.nanoseconds));
  319. }
  320. // 7.5.13 DurationSign ( duration ), https://tc39.es/proposal-temporal/#sec-temporal-durationsign
  321. i8 duration_sign(Duration const& duration)
  322. {
  323. // 1. For each value v of « duration.[[Years]], duration.[[Months]], duration.[[Weeks]], duration.[[Days]], duration.[[Hours]], duration.[[Minutes]], duration.[[Seconds]], duration.[[Milliseconds]], duration.[[Microseconds]], duration.[[Nanoseconds]] », do
  324. for (auto value : { duration.years(), duration.months(), duration.weeks(), duration.days(), duration.hours(), duration.minutes(), duration.seconds(), duration.milliseconds(), duration.microseconds(), duration.nanoseconds() }) {
  325. // a. If v < 0, return -1.
  326. if (value < 0)
  327. return -1;
  328. // b. If v > 0, return 1.
  329. if (value > 0)
  330. return 1;
  331. }
  332. // 2. Return 0.
  333. return 0;
  334. }
  335. // 7.5.14 DateDurationSign ( dateDuration ), https://tc39.es/proposal-temporal/#sec-temporal-datedurationsign
  336. i8 date_duration_sign(DateDuration const& date_duration)
  337. {
  338. // 1. For each value v of « dateDuration.[[Years]], dateDuration.[[Months]], dateDuration.[[Weeks]], dateDuration.[[Days]] », do
  339. for (auto value : { date_duration.years, date_duration.months, date_duration.weeks, date_duration.days }) {
  340. // a. If v < 0, return -1.
  341. if (value < 0)
  342. return -1;
  343. // b. If v > 0, return 1.
  344. if (value > 0)
  345. return 1;
  346. }
  347. // 2. Return 0.
  348. return 0;
  349. }
  350. // 7.5.15 InternalDurationSign ( internalDuration ), https://tc39.es/proposal-temporal/#sec-temporal-internaldurationsign
  351. i8 internal_duration_sign(InternalDuration const& internal_duration)
  352. {
  353. // 1. Let dateSign be DateDurationSign(internalDuration.[[Date]]).
  354. auto date_sign = date_duration_sign(internal_duration.date);
  355. // 2. If dateSign ≠ 0, return dateSign.
  356. if (date_sign != 0)
  357. return date_sign;
  358. // 3. Return TimeDurationSign(internalDuration.[[Time]]).
  359. return time_duration_sign(internal_duration.time);
  360. }
  361. // 7.5.16 IsValidDuration ( years, months, weeks, days, hours, minutes, seconds, milliseconds, microseconds, nanoseconds ), https://tc39.es/proposal-temporal/#sec-temporal-isvalidduration
  362. bool is_valid_duration(double years, double months, double weeks, double days, double hours, double minutes, double seconds, double milliseconds, double microseconds, double nanoseconds)
  363. {
  364. // 1. Let sign be 0.
  365. auto sign = 0;
  366. // 2. For each value v of « years, months, weeks, days, hours, minutes, seconds, milliseconds, microseconds, nanoseconds », do
  367. for (auto value : { years, months, weeks, days, hours, minutes, seconds, milliseconds, microseconds, nanoseconds }) {
  368. // a. If 𝔽(v) is not finite, return false.
  369. if (!isfinite(value))
  370. return false;
  371. // b. If v < 0, then
  372. if (value < 0) {
  373. // i. If sign > 0, return false.
  374. if (sign > 0)
  375. return false;
  376. // ii. Set sign to -1.
  377. sign = -1;
  378. }
  379. // c. Else if v > 0, then
  380. else if (value > 0) {
  381. // i. If sign < 0, return false.
  382. if (sign < 0)
  383. return false;
  384. // ii. Set sign to 1.
  385. sign = 1;
  386. }
  387. }
  388. // 3. If abs(years) ≥ 2**32, return false.
  389. if (AK::fabs(years) > NumericLimits<u32>::max())
  390. return false;
  391. // 4. If abs(months) ≥ 2**32, return false.
  392. if (AK::fabs(months) > NumericLimits<u32>::max())
  393. return false;
  394. // 5. If abs(weeks) ≥ 2**32, return false.
  395. if (AK::fabs(weeks) > NumericLimits<u32>::max())
  396. return false;
  397. // 6. Let totalFractionalSeconds be days × 86,400 + hours × 3600 + minutes × 60 + seconds + ℝ(𝔽(milliseconds)) × 10**-3 + ℝ(𝔽(microseconds)) × 10**-6 + ℝ(𝔽(nanoseconds)) × 10**-9.
  398. // 7. NOTE: The above step cannot be implemented directly using floating-point arithmetic. Multiplying by 10**-3,
  399. // 10**-6, and 10**-9 respectively may be imprecise when milliseconds, microseconds, or nanoseconds is an
  400. // unsafe integer. This multiplication can be implemented in C++ with an implementation of std::remquo()
  401. // with sufficient bits in the quotient. String manipulation will also give an exact result, since the
  402. // multiplication is by a power of 10.
  403. auto total_fractional_seconds = TimeDuration { days }.multiplied_by(NANOSECONDS_PER_DAY);
  404. total_fractional_seconds = total_fractional_seconds.plus(TimeDuration { hours }.multiplied_by(NANOSECONDS_PER_HOUR));
  405. total_fractional_seconds = total_fractional_seconds.plus(TimeDuration { minutes }.multiplied_by(NANOSECONDS_PER_MINUTE));
  406. total_fractional_seconds = total_fractional_seconds.plus(TimeDuration { seconds }.multiplied_by(NANOSECONDS_PER_SECOND));
  407. total_fractional_seconds = total_fractional_seconds.plus(TimeDuration { milliseconds }.multiplied_by(NANOSECONDS_PER_MILLISECOND));
  408. total_fractional_seconds = total_fractional_seconds.plus(TimeDuration { microseconds }.multiplied_by(NANOSECONDS_PER_MICROSECOND));
  409. total_fractional_seconds = total_fractional_seconds.plus(TimeDuration { nanoseconds });
  410. // 8. If abs(totalFractionalSeconds) ≥ 2**53, return false.
  411. if (total_fractional_seconds.unsigned_value() > MAX_TIME_DURATION.unsigned_value())
  412. return false;
  413. // 9. Return true.
  414. return true;
  415. }
  416. // 7.5.17 DefaultTemporalLargestUnit ( duration ), https://tc39.es/proposal-temporal/#sec-temporal-defaulttemporallargestunit
  417. Unit default_temporal_largest_unit(Duration const& duration)
  418. {
  419. // 1. If duration.[[Years]] ≠ 0, return YEAR.
  420. if (duration.years() != 0)
  421. return Unit::Year;
  422. // 2. If duration.[[Months]] ≠ 0, return MONTH.
  423. if (duration.months() != 0)
  424. return Unit::Month;
  425. // 3. If duration.[[Weeks]] ≠ 0, return WEEK.
  426. if (duration.weeks() != 0)
  427. return Unit::Week;
  428. // 4. If duration.[[Days]] ≠ 0, return DAY.
  429. if (duration.days() != 0)
  430. return Unit::Day;
  431. // 5. If duration.[[Hours]] ≠ 0, return HOUR.
  432. if (duration.hours() != 0)
  433. return Unit::Hour;
  434. // 6. If duration.[[Minutes]] ≠ 0, return MINUTE.
  435. if (duration.minutes() != 0)
  436. return Unit::Minute;
  437. // 7. If duration.[[Seconds]] ≠ 0, return SECOND.
  438. if (duration.seconds() != 0)
  439. return Unit::Second;
  440. // 8. If duration.[[Milliseconds]] ≠ 0, return MILLISECOND.
  441. if (duration.milliseconds() != 0)
  442. return Unit::Millisecond;
  443. // 9. If duration.[[Microseconds]] ≠ 0, return MICROSECOND.
  444. if (duration.microseconds() != 0)
  445. return Unit::Microsecond;
  446. // 10. Return NANOSECOND.
  447. return Unit::Nanosecond;
  448. }
  449. // 7.5.18 ToTemporalPartialDurationRecord ( temporalDurationLike ), https://tc39.es/proposal-temporal/#sec-temporal-totemporalpartialdurationrecord
  450. ThrowCompletionOr<PartialDuration> to_temporal_partial_duration_record(VM& vm, Value temporal_duration_like)
  451. {
  452. // 1. If temporalDurationLike is not an Object, then
  453. if (!temporal_duration_like.is_object()) {
  454. // a. Throw a TypeError exception.
  455. return vm.throw_completion<TypeError>(ErrorType::NotAnObject, temporal_duration_like);
  456. }
  457. // 2. Let result be a new partial Duration Record with each field set to undefined.
  458. PartialDuration result {};
  459. // 3. NOTE: The following steps read properties and perform independent validation in alphabetical order.
  460. auto to_integral_if_defined = [&vm, &temporal_duration = temporal_duration_like.as_object()](auto const& property, auto& field) -> ThrowCompletionOr<void> {
  461. if (auto value = TRY(temporal_duration.get(property)); !value.is_undefined())
  462. field = TRY(to_integer_if_integral(vm, value, ErrorType::TemporalInvalidDurationPropertyValueNonIntegral, property, value));
  463. return {};
  464. };
  465. // 4. Let days be ? Get(temporalDurationLike, "days").
  466. // 5. If days is not undefined, set result.[[Days]] to ? ToIntegerIfIntegral(days).
  467. TRY(to_integral_if_defined(vm.names.days, result.days));
  468. // 6. Let hours be ? Get(temporalDurationLike, "hours").
  469. // 7. If hours is not undefined, set result.[[Hours]] to ? ToIntegerIfIntegral(hours).
  470. TRY(to_integral_if_defined(vm.names.hours, result.hours));
  471. // 8. Let microseconds be ? Get(temporalDurationLike, "microseconds").
  472. // 9. If microseconds is not undefined, set result.[[Microseconds]] to ? ToIntegerIfIntegral(microseconds).
  473. TRY(to_integral_if_defined(vm.names.microseconds, result.microseconds));
  474. // 10. Let milliseconds be ? Get(temporalDurationLike, "milliseconds").
  475. // 11. If milliseconds is not undefined, set result.[[Milliseconds]] to ? ToIntegerIfIntegral(milliseconds).
  476. TRY(to_integral_if_defined(vm.names.milliseconds, result.milliseconds));
  477. // 12. Let minutes be ? Get(temporalDurationLike, "minutes").
  478. // 13. If minutes is not undefined, set result.[[Minutes]] to ? ToIntegerIfIntegral(minutes).
  479. TRY(to_integral_if_defined(vm.names.minutes, result.minutes));
  480. // 14. Let months be ? Get(temporalDurationLike, "months").
  481. // 15. If months is not undefined, set result.[[Months]] to ? ToIntegerIfIntegral(months).
  482. TRY(to_integral_if_defined(vm.names.months, result.months));
  483. // 16. Let nanoseconds be ? Get(temporalDurationLike, "nanoseconds").
  484. // 17. If nanoseconds is not undefined, set result.[[Nanoseconds]] to ? ToIntegerIfIntegral(nanoseconds).
  485. TRY(to_integral_if_defined(vm.names.nanoseconds, result.nanoseconds));
  486. // 18. Let seconds be ? Get(temporalDurationLike, "seconds").
  487. // 19. If seconds is not undefined, set result.[[Seconds]] to ? ToIntegerIfIntegral(seconds).
  488. TRY(to_integral_if_defined(vm.names.seconds, result.seconds));
  489. // 20. Let weeks be ? Get(temporalDurationLike, "weeks").
  490. // 21. If weeks is not undefined, set result.[[Weeks]] to ? ToIntegerIfIntegral(weeks).
  491. TRY(to_integral_if_defined(vm.names.weeks, result.weeks));
  492. // 22. Let years be ? Get(temporalDurationLike, "years").
  493. // 23. If years is not undefined, set result.[[Years]] to ? ToIntegerIfIntegral(years).
  494. TRY(to_integral_if_defined(vm.names.years, result.years));
  495. // 24. If years is undefined, and months is undefined, and weeks is undefined, and days is undefined, and hours is
  496. // undefined, and minutes is undefined, and seconds is undefined, and milliseconds is undefined, and microseconds
  497. // is undefined, and nanoseconds is undefined, throw a TypeError exception.
  498. if (!result.any_field_defined())
  499. return vm.throw_completion<TypeError>(ErrorType::TemporalInvalidDurationLikeObject);
  500. // 25. Return result.
  501. return result;
  502. }
  503. // 7.5.19 CreateTemporalDuration ( years, months, weeks, days, hours, minutes, seconds, milliseconds, microseconds, nanoseconds [ , newTarget ] ), https://tc39.es/proposal-temporal/#sec-temporal-createtemporalduration
  504. ThrowCompletionOr<GC::Ref<Duration>> create_temporal_duration(VM& vm, double years, double months, double weeks, double days, double hours, double minutes, double seconds, double milliseconds, double microseconds, double nanoseconds, GC::Ptr<FunctionObject> new_target)
  505. {
  506. auto& realm = *vm.current_realm();
  507. // 1. If IsValidDuration(years, months, weeks, days, hours, minutes, seconds, milliseconds, microseconds, nanoseconds) is false, throw a RangeError exception.
  508. if (!is_valid_duration(years, months, weeks, days, hours, minutes, seconds, milliseconds, microseconds, nanoseconds))
  509. return vm.throw_completion<RangeError>(ErrorType::TemporalInvalidDuration);
  510. // 2. If newTarget is not present, set newTarget to %Temporal.Duration%.
  511. if (!new_target)
  512. new_target = realm.intrinsics().temporal_duration_constructor();
  513. // 3. Let object be ? OrdinaryCreateFromConstructor(newTarget, "%Temporal.Duration.prototype%", « [[InitializedTemporalDuration]], [[Years]], [[Months]], [[Weeks]], [[Days]], [[Hours]], [[Minutes]], [[Seconds]], [[Milliseconds]], [[Microseconds]], [[Nanoseconds]] »).
  514. // 4. Set object.[[Years]] to ℝ(𝔽(years)).
  515. // 5. Set object.[[Months]] to ℝ(𝔽(months)).
  516. // 6. Set object.[[Weeks]] to ℝ(𝔽(weeks)).
  517. // 7. Set object.[[Days]] to ℝ(𝔽(days)).
  518. // 8. Set object.[[Hours]] to ℝ(𝔽(hours)).
  519. // 9. Set object.[[Minutes]] to ℝ(𝔽(minutes)).
  520. // 10. Set object.[[Seconds]] to ℝ(𝔽(seconds)).
  521. // 11. Set object.[[Milliseconds]] to ℝ(𝔽(milliseconds)).
  522. // 12. Set object.[[Microseconds]] to ℝ(𝔽(microseconds)).
  523. // 13. Set object.[[Nanoseconds]] to ℝ(𝔽(nanoseconds)).
  524. auto object = TRY(ordinary_create_from_constructor<Duration>(vm, *new_target, &Intrinsics::temporal_duration_prototype, years, months, weeks, days, hours, minutes, seconds, milliseconds, microseconds, nanoseconds));
  525. // 14. Return object.
  526. return object;
  527. }
  528. // 7.5.20 CreateNegatedTemporalDuration ( duration ), https://tc39.es/proposal-temporal/#sec-temporal-createnegatedtemporalduration
  529. GC::Ref<Duration> create_negated_temporal_duration(VM& vm, Duration const& duration)
  530. {
  531. // 1. Return ! CreateTemporalDuration(-duration.[[Years]], -duration.[[Months]], -duration.[[Weeks]], -duration.[[Days]], -duration.[[Hours]], -duration.[[Minutes]], -duration.[[Seconds]], -duration.[[Milliseconds]], -duration.[[Microseconds]], -duration.[[Nanoseconds]]).
  532. return MUST(create_temporal_duration(vm, -duration.years(), -duration.months(), -duration.weeks(), -duration.days(), -duration.hours(), -duration.minutes(), -duration.seconds(), -duration.milliseconds(), -duration.microseconds(), -duration.nanoseconds()));
  533. }
  534. // 7.5.21 TimeDurationFromComponents ( hours, minutes, seconds, milliseconds, microseconds, nanoseconds ), https://tc39.es/proposal-temporal/#sec-temporal-timedurationfromcomponents
  535. TimeDuration time_duration_from_components(double hours, double minutes, double seconds, double milliseconds, double microseconds, double nanoseconds)
  536. {
  537. // 1. Set minutes to minutes + hours × 60.
  538. auto total_minutes = TimeDuration { minutes }.plus(TimeDuration { hours }.multiplied_by(60_bigint));
  539. // 2. Set seconds to seconds + minutes × 60.
  540. auto total_seconds = TimeDuration { seconds }.plus(total_minutes.multiplied_by(60_bigint));
  541. // 3. Set milliseconds to milliseconds + seconds × 1000.
  542. auto total_milliseconds = TimeDuration { milliseconds }.plus(total_seconds.multiplied_by(1000_bigint));
  543. // 4. Set microseconds to microseconds + milliseconds × 1000.
  544. auto total_microseconds = TimeDuration { microseconds }.plus(total_milliseconds.multiplied_by(1000_bigint));
  545. // 5. Set nanoseconds to nanoseconds + microseconds × 1000.
  546. auto total_nanoseconds = TimeDuration { nanoseconds }.plus(total_microseconds.multiplied_by(1000_bigint));
  547. // 6. Assert: abs(nanoseconds) ≤ maxTimeDuration.
  548. VERIFY(total_nanoseconds.unsigned_value() <= MAX_TIME_DURATION.unsigned_value());
  549. // 7. Return nanoseconds.
  550. return total_nanoseconds;
  551. }
  552. // 7.5.22 AddTimeDuration ( one, two ), https://tc39.es/proposal-temporal/#sec-temporal-addtimeduration
  553. ThrowCompletionOr<TimeDuration> add_time_duration(VM& vm, TimeDuration const& one, TimeDuration const& two)
  554. {
  555. // 1. Let result be one + two.
  556. auto result = one.plus(two);
  557. // 2. If abs(result) > maxTimeDuration, throw a RangeError exception.
  558. if (result.unsigned_value() > MAX_TIME_DURATION.unsigned_value())
  559. return vm.throw_completion<RangeError>(ErrorType::TemporalInvalidDuration);
  560. // 3. Return result.
  561. return result;
  562. }
  563. // 7.5.23 Add24HourDaysToTimeDuration ( d, days ), https://tc39.es/proposal-temporal/#sec-temporal-add24hourdaystonormalizedtimeduration
  564. ThrowCompletionOr<TimeDuration> add_24_hour_days_to_time_duration(VM& vm, TimeDuration const& time_duration, double days)
  565. {
  566. // 1. Let result be d + days × nsPerDay.
  567. auto result = time_duration.plus(TimeDuration { days }.multiplied_by(NANOSECONDS_PER_DAY));
  568. // 2. If abs(result) > maxTimeDuration, throw a RangeError exception.
  569. if (result.unsigned_value() > MAX_TIME_DURATION.unsigned_value())
  570. return vm.throw_completion<RangeError>(ErrorType::TemporalInvalidDuration);
  571. // 3. Return result.
  572. return result;
  573. }
  574. // 7.5.24 AddTimeDurationToEpochNanoseconds ( d, epochNs ), https://tc39.es/proposal-temporal/#sec-temporal-addtimedurationtoepochnanoseconds
  575. TimeDuration add_time_duration_to_epoch_nanoseconds(TimeDuration const& duration, TimeDuration const& epoch_nanoseconds)
  576. {
  577. // 1. Return epochNs + ℤ(d).
  578. return epoch_nanoseconds.plus(duration);
  579. }
  580. // 7.5.25 CompareTimeDuration ( one, two ), https://tc39.es/proposal-temporal/#sec-temporal-comparetimeduration
  581. i8 compare_time_duration(TimeDuration const& one, TimeDuration const& two)
  582. {
  583. // 1. If one > two, return 1.
  584. if (one > two)
  585. return 1;
  586. // 2. If one < two, return -1.
  587. if (one < two)
  588. return -1;
  589. // 3. Return 0.
  590. return 0;
  591. }
  592. // 7.5.26 TimeDurationFromEpochNanosecondsDifference ( one, two ), https://tc39.es/proposal-temporal/#sec-temporal-timedurationfromepochnanosecondsdifference
  593. TimeDuration time_duration_from_epoch_nanoseconds_difference(TimeDuration const& one, TimeDuration const& two)
  594. {
  595. // 1. Let result be ℝ(one) - ℝ(two).
  596. auto result = one.minus(two);
  597. // 2. Assert: abs(result) ≤ maxTimeDuration.
  598. VERIFY(result.unsigned_value() <= MAX_TIME_DURATION.unsigned_value());
  599. // 3. Return result.
  600. return result;
  601. }
  602. // 7.5.27 RoundTimeDurationToIncrement ( d, increment, roundingMode ), https://tc39.es/proposal-temporal/#sec-temporal-roundtimedurationtoincrement
  603. ThrowCompletionOr<TimeDuration> round_time_duration_to_increment(VM& vm, TimeDuration const& duration, Crypto::UnsignedBigInteger const& increment, RoundingMode rounding_mode)
  604. {
  605. // 1. Let rounded be RoundNumberToIncrement(d, increment, roundingMode).
  606. auto rounded = round_number_to_increment(duration, increment, rounding_mode);
  607. // 2. If abs(rounded) > maxTimeDuration, throw a RangeError exception.
  608. if (rounded.unsigned_value() > MAX_TIME_DURATION.unsigned_value())
  609. return vm.throw_completion<RangeError>(ErrorType::TemporalInvalidDuration);
  610. // 3. Return rounded.
  611. return rounded;
  612. }
  613. // 7.5.28 TimeDurationSign ( d ), https://tc39.es/proposal-temporal/#sec-temporal-timedurationsign
  614. i8 time_duration_sign(TimeDuration const& time_duration)
  615. {
  616. // 1. If d < 0, return -1.
  617. if (time_duration.is_negative())
  618. return -1;
  619. // 2. If d > 0, return 1.
  620. if (time_duration.is_positive())
  621. return 1;
  622. // 3. Return 0.
  623. return 0;
  624. }
  625. // 7.5.30 RoundTimeDuration ( timeDuration, increment, unit, roundingMode ), https://tc39.es/proposal-temporal/#sec-temporal-roundtimeduration
  626. ThrowCompletionOr<TimeDuration> round_time_duration(VM& vm, TimeDuration const& time_duration, Crypto::UnsignedBigInteger const& increment, Unit unit, RoundingMode rounding_mode)
  627. {
  628. // 1. Let divisor be the value in the "Length in Nanoseconds" column of the row of Table 21 whose "Value" column contains unit.
  629. auto const& divisor = temporal_unit_length_in_nanoseconds(unit);
  630. // 2. Return ? RoundTimeDurationToIncrement(timeDuration, divisor × increment, roundingMode).
  631. return TRY(round_time_duration_to_increment(vm, time_duration, divisor.multiplied_by(increment), rounding_mode));
  632. }
  633. // 7.5.31 TotalTimeDuration ( timeDuration, unit ), https://tc39.es/proposal-temporal/#sec-temporal-totaltimeduration
  634. double total_time_duration(TimeDuration const& time_duration, Unit unit)
  635. {
  636. // 1. Let divisor be the value in the "Length in Nanoseconds" column of the row of Table 21 whose "Value" column contains unit.
  637. auto const& divisor = temporal_unit_length_in_nanoseconds(unit);
  638. // 2. NOTE: The following step cannot be implemented directly using floating-point arithmetic when 𝔽(timeDuration) is
  639. // not a safe integer. The division can be implemented in C++ with the __float128 type if the compiler supports it,
  640. // or with software emulation such as in the SoftFP library.
  641. // 3. Return timeDuration / divisor.
  642. auto result = Crypto::BigFraction { time_duration } / Crypto::BigFraction { Crypto::SignedBigInteger { divisor } };
  643. return result.to_double();
  644. }
  645. // 7.5.33 NudgeToCalendarUnit ( sign, duration, destEpochNs, isoDateTime, timeZone, calendar, increment, unit, roundingMode ), https://tc39.es/proposal-temporal/#sec-temporal-nudgetocalendarunit
  646. ThrowCompletionOr<CalendarNudgeResult> nudge_to_calendar_unit(VM& vm, i8 sign, InternalDuration const& duration, TimeDuration const& dest_epoch_ns, ISODateTime const& iso_date_time, Optional<StringView> time_zone, StringView calendar, u64 increment, Unit unit, RoundingMode rounding_mode)
  647. {
  648. DateDuration start_duration;
  649. DateDuration end_duration;
  650. double r1 = 0;
  651. double r2 = 0;
  652. // 1. If unit is YEAR, then
  653. if (unit == Unit::Year) {
  654. // a. Let years be RoundNumberToIncrement(duration.[[Date]].[[Years]], increment, TRUNC).
  655. auto years = round_number_to_increment(duration.date.years, increment, RoundingMode::Trunc);
  656. // b. Let r1 be years.
  657. r1 = years;
  658. // c. Let r2 be years + increment × sign.
  659. r2 = years + static_cast<double>(increment) * sign;
  660. // d. Let startDuration be ? CreateDateDurationRecord(r1, 0, 0, 0).
  661. start_duration = TRY(create_date_duration_record(vm, r1, 0, 0, 0));
  662. // e. Let endDuration be ? CreateDateDurationRecord(r2, 0, 0, 0).
  663. end_duration = TRY(create_date_duration_record(vm, r2, 0, 0, 0));
  664. }
  665. // 2. Else if unit is MONTH, then
  666. else if (unit == Unit::Month) {
  667. // a. Let months be RoundNumberToIncrement(duration.[[Date]].[[Months]], increment, TRUNC).
  668. auto months = round_number_to_increment(duration.date.months, increment, RoundingMode::Trunc);
  669. // b. Let r1 be months.
  670. r1 = months;
  671. // c. Let r2 be months + increment × sign.
  672. r2 = months + static_cast<double>(increment) * sign;
  673. // d. Let startDuration be ? AdjustDateDurationRecord(duration.[[Date]], 0, 0, r1).
  674. start_duration = TRY(adjust_date_duration_record(vm, duration.date, 0, 0, r1));
  675. // e. Let endDuration be ? AdjustDateDurationRecord(duration.[[Date]], 0, 0, r2).
  676. end_duration = TRY(adjust_date_duration_record(vm, duration.date, 0, 0, r2));
  677. }
  678. // 3. Else if unit is WEEK, then
  679. else if (unit == Unit::Week) {
  680. // a. Let yearsMonths be ! AdjustDateDurationRecord(duration.[[Date]], 0, 0).
  681. auto years_months = MUST(adjust_date_duration_record(vm, duration.date, 0, 0));
  682. // b. Let weeksStart be ? CalendarDateAdd(calendar, isoDateTime.[[ISODate]], yearsMonths, CONSTRAIN).
  683. auto weeks_start = TRY(calendar_date_add(vm, calendar, iso_date_time.iso_date, years_months, Overflow::Constrain));
  684. // c. Let weeksEnd be BalanceISODate(weeksStart.[[Year]], weeksStart.[[Month]], weeksStart.[[Day]] + duration.[[Date]].[[Days]]).
  685. auto weeks_end = balance_iso_date(weeks_start.year, weeks_start.month, static_cast<double>(weeks_start.day) + duration.date.days);
  686. // d. Let untilResult be CalendarDateUntil(calendar, weeksStart, weeksEnd, WEEK).
  687. auto until_result = calendar_date_until(vm, calendar, weeks_start, weeks_end, Unit::Week);
  688. // e. Let weeks be RoundNumberToIncrement(duration.[[Date]].[[Weeks]] + untilResult.[[Weeks]], increment, TRUNC).
  689. auto weeks = round_number_to_increment(duration.date.weeks + until_result.weeks, increment, RoundingMode::Trunc);
  690. // f. Let r1 be weeks.
  691. r1 = weeks;
  692. // g. Let r2 be weeks + increment × sign.
  693. r2 = weeks + static_cast<double>(increment) * sign;
  694. // h. Let startDuration be ? AdjustDateDurationRecord(duration.[[Date]], 0, r1).
  695. start_duration = TRY(adjust_date_duration_record(vm, duration.date, 0, r1));
  696. // i. Let endDuration be ? AdjustDateDurationRecord(duration.[[Date]], 0, r2).
  697. end_duration = TRY(adjust_date_duration_record(vm, duration.date, 0, r2));
  698. }
  699. // 4. Else,
  700. else {
  701. // a. Assert: unit is DAY.
  702. VERIFY(unit == Unit::Day);
  703. // b. Let days be RoundNumberToIncrement(duration.[[Date]].[[Days]], increment, TRUNC).
  704. auto days = round_number_to_increment(duration.date.days, increment, RoundingMode::Trunc);
  705. // c. Let r1 be days.
  706. r1 = days;
  707. // d. Let r2 be days + increment × sign.
  708. r2 = days + static_cast<double>(increment) * sign;
  709. // e. Let startDuration be ? AdjustDateDurationRecord(duration.[[Date]], r1).
  710. start_duration = TRY(adjust_date_duration_record(vm, duration.date, r1));
  711. // f. Let endDuration be ? AdjustDateDurationRecord(duration.[[Date]], r2).
  712. end_duration = TRY(adjust_date_duration_record(vm, duration.date, r2));
  713. }
  714. // 5. Assert: If sign is 1, r1 ≥ 0 and r1 < r2.
  715. if (sign == 1)
  716. VERIFY(r1 >= 0 && r1 < r2);
  717. // 6. Assert: If sign is -1, r1 ≤ 0 and r1 > r2.
  718. else if (sign == -1)
  719. VERIFY(r1 <= 0 && r1 > r2);
  720. // 7. Let start be ? CalendarDateAdd(calendar, isoDateTime.[[ISODate]], startDuration, CONSTRAIN).
  721. auto start = TRY(calendar_date_add(vm, calendar, iso_date_time.iso_date, start_duration, Overflow::Constrain));
  722. // 8. Let end be ? CalendarDateAdd(calendar, isoDateTime.[[ISODate]], endDuration, CONSTRAIN).
  723. auto end = TRY(calendar_date_add(vm, calendar, iso_date_time.iso_date, end_duration, Overflow::Constrain));
  724. // 9. Let startDateTime be CombineISODateAndTimeRecord(start, isoDateTime.[[Time]]).
  725. auto start_date_time = combine_iso_date_and_time_record(start, iso_date_time.time);
  726. // 10. Let endDateTime be CombineISODateAndTimeRecord(end, isoDateTime.[[Time]]).
  727. auto end_date_time = combine_iso_date_and_time_record(end, iso_date_time.time);
  728. TimeDuration start_epoch_ns;
  729. TimeDuration end_epoch_ns;
  730. // 11. If timeZone is UNSET, then
  731. if (!time_zone.has_value()) {
  732. // a. Let startEpochNs be GetUTCEpochNanoseconds(startDateTime).
  733. start_epoch_ns = get_utc_epoch_nanoseconds(start_date_time);
  734. // b. Let endEpochNs be GetUTCEpochNanoseconds(endDateTime).
  735. end_epoch_ns = get_utc_epoch_nanoseconds(end_date_time);
  736. }
  737. // 12. Else,
  738. else {
  739. // a. Let startEpochNs be ? GetEpochNanosecondsFor(timeZone, startDateTime, COMPATIBLE).
  740. start_epoch_ns = TRY(get_epoch_nanoseconds_for(vm, *time_zone, start_date_time, Disambiguation::Compatible));
  741. // b. Let endEpochNs be ? GetEpochNanosecondsFor(timeZone, endDateTime, COMPATIBLE).
  742. end_epoch_ns = TRY(get_epoch_nanoseconds_for(vm, *time_zone, end_date_time, Disambiguation::Compatible));
  743. }
  744. // 13. If sign is 1, then
  745. if (sign == 1) {
  746. // a. Assert: startEpochNs ≤ destEpochNs ≤ endEpochNs.
  747. VERIFY(start_epoch_ns <= dest_epoch_ns);
  748. VERIFY(dest_epoch_ns <= end_epoch_ns);
  749. }
  750. // 14. Else,
  751. else {
  752. // a. Assert: endEpochNs ≤ destEpochNs ≤ startEpochNs.
  753. VERIFY(end_epoch_ns <= dest_epoch_ns);
  754. VERIFY(dest_epoch_ns <= start_epoch_ns);
  755. }
  756. // 15. Assert: startEpochNs ≠ endEpochNs.
  757. VERIFY(start_epoch_ns != end_epoch_ns);
  758. // 16. Let progress be (destEpochNs - startEpochNs) / (endEpochNs - startEpochNs).
  759. auto progress_numerator = dest_epoch_ns.minus(start_epoch_ns);
  760. auto progress_denominator = end_epoch_ns.minus(start_epoch_ns);
  761. auto progress_equals_one = progress_numerator == progress_denominator;
  762. // 17. Let total be r1 + progress × increment × sign.
  763. auto total_numerator = progress_numerator.multiplied_by(Crypto::UnsignedBigInteger { increment });
  764. if (sign == -1)
  765. total_numerator.negate();
  766. if (progress_denominator.is_negative())
  767. total_numerator.negate();
  768. auto total_mv = Crypto::BigFraction { Crypto::SignedBigInteger { r1 } } + Crypto::BigFraction { move(total_numerator), progress_denominator.unsigned_value() };
  769. auto total = total_mv.to_double();
  770. // 18. NOTE: The above two steps cannot be implemented directly using floating-point arithmetic. This division can be
  771. // implemented as if expressing the denominator and numerator of total as two time durations, and performing one
  772. // division operation with a floating-point result.
  773. // 19. Assert: 0 ≤ progress ≤ 1.
  774. // 20. If sign < 0, let isNegative be NEGATIVE; else let isNegative be POSITIVE.
  775. auto is_negative = sign < 0 ? Sign::Negative : Sign::Positive;
  776. // 21. Let unsignedRoundingMode be GetUnsignedRoundingMode(roundingMode, isNegative).
  777. auto unsigned_rounding_mode = get_unsigned_rounding_mode(rounding_mode, is_negative);
  778. double rounded_unit = 0;
  779. // 22. If progress = 1, then
  780. if (progress_equals_one) {
  781. // a. Let roundedUnit be abs(r2).
  782. rounded_unit = fabs(r2);
  783. }
  784. // 23. Else,
  785. else {
  786. // a. Assert: abs(r1) ≤ abs(total) < abs(r2).
  787. VERIFY(fabs(r1) <= fabs(total));
  788. VERIFY(fabs(total) <= fabs(r2));
  789. // b. Let roundedUnit be ApplyUnsignedRoundingMode(abs(total), abs(r1), abs(r2), unsignedRoundingMode).
  790. rounded_unit = apply_unsigned_rounding_mode(fabs(total), fabs(r1), fabs(r2), unsigned_rounding_mode);
  791. }
  792. auto did_expand_calendar_unit = false;
  793. DateDuration result_duration;
  794. TimeDuration nudged_epoch_ns;
  795. // 24. If roundedUnit is abs(r2), then
  796. if (rounded_unit == fabs(r2)) {
  797. // a. Let didExpandCalendarUnit be true.
  798. did_expand_calendar_unit = true;
  799. // b. Let resultDuration be endDuration.
  800. result_duration = end_duration;
  801. // c. Let nudgedEpochNs be endEpochNs.
  802. nudged_epoch_ns = move(end_epoch_ns);
  803. }
  804. // 25. Else,
  805. else {
  806. // a. Let didExpandCalendarUnit be false.
  807. did_expand_calendar_unit = false;
  808. // b. Let resultDuration be startDuration.
  809. result_duration = start_duration;
  810. // c. Let nudgedEpochNs be startEpochNs.
  811. nudged_epoch_ns = move(start_epoch_ns);
  812. }
  813. // 26. Set resultDuration to ! CombineDateAndTimeDuration(resultDuration, 0).
  814. auto result_date_and_time_duration = MUST(combine_date_and_time_duration(vm, result_duration, TimeDuration { 0 }));
  815. // 27. Let nudgeResult be Duration Nudge Result Record { [[Duration]]: resultDuration, [[NudgedEpochNs]]: nudgedEpochNs, [[DidExpandCalendarUnit]]: didExpandCalendarUnit }.
  816. DurationNudgeResult nudge_result { .duration = move(result_date_and_time_duration), .nudged_epoch_ns = move(nudged_epoch_ns), .did_expand_calendar_unit = did_expand_calendar_unit };
  817. // 28. Return the Record { [[NudgeResult]]: nudgeResult, [[Total]]: total }.
  818. return CalendarNudgeResult { .nudge_result = move(nudge_result), .total = move(total_mv) };
  819. }
  820. // 7.5.34 NudgeToZonedTime ( sign, duration, isoDateTime, timeZone, calendar, increment, unit, roundingMode ), https://tc39.es/proposal-temporal/#sec-temporal-nudgetozonedtime
  821. ThrowCompletionOr<DurationNudgeResult> nudge_to_zoned_time(VM& vm, i8 sign, InternalDuration const& duration, ISODateTime const& iso_date_time, StringView time_zone, StringView calendar, u64 increment, Unit unit, RoundingMode rounding_mode)
  822. {
  823. // 1. Let start be ? CalendarDateAdd(calendar, isoDateTime.[[ISODate]], duration.[[Date]], CONSTRAIN).
  824. auto start = TRY(calendar_date_add(vm, calendar, iso_date_time.iso_date, duration.date, Overflow::Constrain));
  825. // 2. Let startDateTime be CombineISODateAndTimeRecord(start, isoDateTime.[[Time]]).
  826. auto start_date_time = combine_iso_date_and_time_record(start, iso_date_time.time);
  827. // 3. Let endDate be BalanceISODate(start.[[Year]], start.[[Month]], start.[[Day]] + sign).
  828. auto end_date = balance_iso_date(start.year, start.month, static_cast<double>(start.day) + sign);
  829. // 4. Let endDateTime be CombineISODateAndTimeRecord(endDate, isoDateTime.[[Time]]).
  830. auto end_date_time = combine_iso_date_and_time_record(end_date, iso_date_time.time);
  831. // 5. Let startEpochNs be ? GetEpochNanosecondsFor(timeZone, startDateTime, COMPATIBLE).
  832. auto start_epoch_ns = TRY(get_epoch_nanoseconds_for(vm, time_zone, start_date_time, Disambiguation::Compatible));
  833. // 6. Let endEpochNs be ? GetEpochNanosecondsFor(timeZone, endDateTime, COMPATIBLE).
  834. auto end_epoch_ns = TRY(get_epoch_nanoseconds_for(vm, time_zone, end_date_time, Disambiguation::Compatible));
  835. // 7. Let daySpan be TimeDurationFromEpochNanosecondsDifference(endEpochNs, startEpochNs).
  836. auto day_span = time_duration_from_epoch_nanoseconds_difference(end_epoch_ns, start_epoch_ns);
  837. // 8. Assert: TimeDurationSign(daySpan) = sign.
  838. VERIFY(time_duration_sign(day_span) == sign);
  839. // 9. Let unitLength be the value in the "Length in Nanoseconds" column of the row of Table 21 whose "Value" column contains unit.
  840. auto const& unit_length = temporal_unit_length_in_nanoseconds(unit);
  841. // 10. Let roundedTimeDuration be ? RoundTimeDurationToIncrement(duration.[[Time]], increment × unitLength, roundingMode).
  842. auto unit_length_multiplied_by_increment = unit_length.multiplied_by(Crypto::UnsignedBigInteger { increment });
  843. auto rounded_time_duration = TRY(round_time_duration_to_increment(vm, duration.time, unit_length_multiplied_by_increment, rounding_mode));
  844. // 11. Let beyondDaySpan be ? AddTimeDuration(roundedTimeDuration, -daySpan).
  845. day_span.negate();
  846. auto beyond_day_span = TRY(add_time_duration(vm, rounded_time_duration, day_span));
  847. auto did_round_beyond_day = false;
  848. TimeDuration nudged_epoch_ns;
  849. i8 day_delta = 0;
  850. // 12. If TimeDurationSign(beyondDaySpan) ≠ -sign, then
  851. if (time_duration_sign(beyond_day_span) != -sign) {
  852. // a. Let didRoundBeyondDay be true.
  853. did_round_beyond_day = true;
  854. // b. Let dayDelta be sign.
  855. day_delta = sign;
  856. // c. Set roundedTimeDuration to ? RoundTimeDurationToIncrement(beyondDaySpan, increment × unitLength, roundingMode).
  857. rounded_time_duration = TRY(round_time_duration_to_increment(vm, beyond_day_span, unit_length_multiplied_by_increment, rounding_mode));
  858. // d. Let nudgedEpochNs be AddTimeDurationToEpochNanoseconds(roundedTimeDuration, endEpochNs).
  859. nudged_epoch_ns = add_time_duration_to_epoch_nanoseconds(rounded_time_duration, end_epoch_ns);
  860. }
  861. // 13. Else,
  862. else {
  863. // a. Let didRoundBeyondDay be false.
  864. did_round_beyond_day = false;
  865. // b. Let dayDelta be 0.
  866. day_delta = 0;
  867. // c. Let nudgedEpochNs be AddTimeDurationToEpochNanoseconds(roundedTimeDuration, startEpochNs).
  868. nudged_epoch_ns = add_time_duration_to_epoch_nanoseconds(rounded_time_duration, start_epoch_ns);
  869. }
  870. // 14. Let dateDuration be ? AdjustDateDurationRecord(duration.[[Date]], duration.[[Date]].[[Days]] + dayDelta).
  871. auto date_duration = TRY(adjust_date_duration_record(vm, duration.date, duration.date.days + day_delta));
  872. // 15. Let resultDuration be ? CombineDateAndTimeDuration(dateDuration, roundedTimeDuration).
  873. auto result_duration = TRY(combine_date_and_time_duration(vm, date_duration, move(rounded_time_duration)));
  874. // 16. Return Duration Nudge Result Record { [[Duration]]: resultDuration, [[NudgedEpochNs]]: nudgedEpochNs, [[DidExpandCalendarUnit]]: didRoundBeyondDay }.
  875. return DurationNudgeResult { .duration = move(result_duration), .nudged_epoch_ns = move(nudged_epoch_ns), .did_expand_calendar_unit = did_round_beyond_day };
  876. }
  877. // 7.5.35 NudgeToDayOrTime ( duration, destEpochNs, largestUnit, increment, smallestUnit, roundingMode ), https://tc39.es/proposal-temporal/#sec-temporal-nudgetodayortime
  878. ThrowCompletionOr<DurationNudgeResult> nudge_to_day_or_time(VM& vm, InternalDuration const& duration, TimeDuration const& dest_epoch_ns, Unit largest_unit, u64 increment, Unit smallest_unit, RoundingMode rounding_mode)
  879. {
  880. // 1. Let timeDuration be ! Add24HourDaysToTimeDuration(duration.[[Time]], duration.[[Date]].[[Days]]).
  881. auto time_duration = MUST(add_24_hour_days_to_time_duration(vm, duration.time, duration.date.days));
  882. // 2. Let unitLength be the value in the "Length in Nanoseconds" column of the row of Table 21 whose "Value" column contains smallestUnit.
  883. auto const& unit_length = temporal_unit_length_in_nanoseconds(smallest_unit);
  884. // 3. Let roundedTime be ? RoundTimeDurationToIncrement(timeDuration, unitLength × increment, roundingMode).
  885. auto unit_length_multiplied_by_increment = unit_length.multiplied_by(Crypto::UnsignedBigInteger { increment });
  886. auto rounded_time = TRY(round_time_duration_to_increment(vm, time_duration, unit_length_multiplied_by_increment, rounding_mode));
  887. // 4. Let diffTime be ! AddTimeDuration(roundedTime, -timeDuration).
  888. time_duration.negate();
  889. auto diff_time = MUST(add_time_duration(vm, rounded_time, time_duration));
  890. time_duration.negate();
  891. // 5. Let wholeDays be truncate(TotalTimeDuration(timeDuration, DAY)).
  892. auto whole_days = trunc(total_time_duration(time_duration, Unit::Day));
  893. // 6. Let roundedWholeDays be truncate(TotalTimeDuration(roundedTime, DAY)).
  894. auto rounded_whole_days = trunc(total_time_duration(rounded_time, Unit::Day));
  895. // 7. Let dayDelta be roundedWholeDays - wholeDays.
  896. auto day_delta = rounded_whole_days - whole_days;
  897. // 8. If dayDelta < 0, let dayDeltaSign be -1; else if dayDelta > 0, let dayDeltaSign be 1; else let dayDeltaSign be 0.
  898. auto day_delta_sign = day_delta < 0 ? -1 : (day_delta > 0 ? 1 : 0);
  899. // 9. If dayDeltaSign = TimeDurationSign(timeDuration), let didExpandDays be true; else let didExpandDays be false.
  900. auto did_expand_days = day_delta_sign == time_duration_sign(time_duration);
  901. // 10. Let nudgedEpochNs be AddTimeDurationToEpochNanoseconds(diffTime, destEpochNs).
  902. auto nudged_epoch_ns = add_time_duration_to_epoch_nanoseconds(diff_time, dest_epoch_ns);
  903. // 11. Let days be 0.
  904. double days = 0;
  905. // 12. Let remainder be roundedTime.
  906. TimeDuration remainder;
  907. // 13. If TemporalUnitCategory(largestUnit) is DATE, then
  908. if (temporal_unit_category(largest_unit) == UnitCategory::Date) {
  909. // a. Set days to roundedWholeDays.
  910. days = rounded_whole_days;
  911. // b. Set remainder to ! AddTimeDuration(roundedTime, TimeDurationFromComponents(-roundedWholeDays * HoursPerDay, 0, 0, 0, 0, 0)).
  912. remainder = MUST(add_time_duration(vm, rounded_time, time_duration_from_components(-rounded_whole_days * JS::hours_per_day, 0, 0, 0, 0, 0)));
  913. } else {
  914. remainder = move(rounded_time);
  915. }
  916. // 14. Let dateDuration be ? AdjustDateDurationRecord(duration.[[Date]], days).
  917. auto date_duration = TRY(adjust_date_duration_record(vm, duration.date, days));
  918. // 15. Let resultDuration be ? CombineDateAndTimeDuration(dateDuration, remainder).
  919. auto result_duration = TRY(combine_date_and_time_duration(vm, date_duration, move(remainder)));
  920. // 16. Return Duration Nudge Result Record { [[Duration]]: resultDuration, [[NudgedEpochNs]]: nudgedEpochNs, [[DidExpandCalendarUnit]]: didExpandDays }.
  921. return DurationNudgeResult { .duration = move(result_duration), .nudged_epoch_ns = move(nudged_epoch_ns), .did_expand_calendar_unit = did_expand_days };
  922. }
  923. // 7.5.36 BubbleRelativeDuration ( sign, duration, nudgedEpochNs, isoDateTime, timeZone, calendar, largestUnit, smallestUnit ), https://tc39.es/proposal-temporal/#sec-temporal-bubblerelativeduration
  924. ThrowCompletionOr<InternalDuration> bubble_relative_duration(VM& vm, i8 sign, InternalDuration duration, TimeDuration const& nudged_epoch_ns, ISODateTime const& iso_date_time, Optional<StringView> time_zone, StringView calendar, Unit largest_unit, Unit smallest_unit)
  925. {
  926. // 1. If smallestUnit is largestUnit, return duration.
  927. if (smallest_unit == largest_unit)
  928. return duration;
  929. // 2. Let largestUnitIndex be the ordinal index of the row of Table 21 whose "Value" column contains largestUnit.
  930. auto largest_unit_index = to_underlying(largest_unit);
  931. // 3. Let smallestUnitIndex be the ordinal index of the row of Table 21 whose "Value" column contains smallestUnit.
  932. auto smallest_unit_index = to_underlying(smallest_unit);
  933. // 4. Let unitIndex be smallestUnitIndex - 1.
  934. auto unit_index = smallest_unit_index - 1;
  935. // 5. Let done be false.
  936. auto done = false;
  937. // 6. Repeat, while unitIndex ≥ largestUnitIndex and done is false,
  938. while (unit_index >= largest_unit_index && !done) {
  939. // a. Let unit be the value in the "Value" column of Table 21 in the row whose ordinal index is unitIndex.
  940. auto unit = static_cast<Unit>(unit_index);
  941. // b. If unit is not WEEK, or largestUnit is WEEK, then
  942. if (unit != Unit::Week || largest_unit == Unit::Week) {
  943. DateDuration end_duration;
  944. // i. If unit is YEAR, then
  945. if (unit == Unit::Year) {
  946. // 1. Let years be duration.[[Date]].[[Years]] + sign.
  947. auto years = duration.date.years + sign;
  948. // 2. Let endDuration be ? CreateDateDurationRecord(years, 0, 0, 0).
  949. end_duration = TRY(create_date_duration_record(vm, years, 0, 0, 0));
  950. }
  951. // ii. Else if unit is MONTH, then
  952. else if (unit == Unit::Month) {
  953. // 1. Let months be duration.[[Date]].[[Months]] + sign.
  954. auto months = duration.date.months + sign;
  955. // 2. Let endDuration be ? AdjustDateDurationRecord(duration.[[Date]], 0, 0, months).
  956. end_duration = TRY(adjust_date_duration_record(vm, duration.date, 0, 0, months));
  957. }
  958. // iii. Else,
  959. else {
  960. // 1. Assert: unit is WEEK.
  961. VERIFY(unit == Unit::Week);
  962. // 2. Let weeks be duration.[[Date]].[[Weeks]] + sign.
  963. auto weeks = duration.date.weeks + sign;
  964. // 3. Let endDuration be ? AdjustDateDurationRecord(duration.[[Date]], 0, weeks).
  965. end_duration = TRY(adjust_date_duration_record(vm, duration.date, 0, weeks));
  966. }
  967. // iv. Let end be ? CalendarDateAdd(calendar, isoDateTime.[[ISODate]], endDuration, CONSTRAIN).
  968. auto end = TRY(calendar_date_add(vm, calendar, iso_date_time.iso_date, end_duration, Overflow::Constrain));
  969. // v. Let endDateTime be CombineISODateAndTimeRecord(end, isoDateTime.[[Time]]).
  970. auto end_date_time = combine_iso_date_and_time_record(end, iso_date_time.time);
  971. TimeDuration end_epoch_ns;
  972. // vi. If timeZone is UNSET, then
  973. if (!time_zone.has_value()) {
  974. // 1. Let endEpochNs be GetUTCEpochNanoseconds(endDateTime).
  975. end_epoch_ns = get_utc_epoch_nanoseconds(end_date_time);
  976. }
  977. // vii. Else,
  978. else {
  979. // 1. Let endEpochNs be ? GetEpochNanosecondsFor(timeZone, endDateTime, COMPATIBLE).
  980. end_epoch_ns = TRY(get_epoch_nanoseconds_for(vm, *time_zone, end_date_time, Disambiguation::Compatible));
  981. }
  982. // viii. Let beyondEnd be nudgedEpochNs - endEpochNs.
  983. auto beyond_end = nudged_epoch_ns.minus(end_epoch_ns);
  984. // ix. If beyondEnd < 0, let beyondEndSign be -1; else if beyondEnd > 0, let beyondEndSign be 1; else let beyondEndSign be 0.
  985. auto beyond_end_sign = beyond_end.is_negative() ? -1 : (beyond_end.is_positive() ? 1 : 0);
  986. // x. If beyondEndSign ≠ -sign, then
  987. if (beyond_end_sign != -sign) {
  988. // 1. Set duration to ! CombineDateAndTimeDuration(endDuration, 0).
  989. duration = MUST(combine_date_and_time_duration(vm, end_duration, TimeDuration { 0 }));
  990. }
  991. // xi. Else,
  992. else {
  993. // 1. Set done to true.
  994. done = true;
  995. }
  996. }
  997. // c. Set unitIndex to unitIndex - 1.
  998. --unit_index;
  999. }
  1000. // 7. Return duration.
  1001. return duration;
  1002. }
  1003. // 7.5.37 RoundRelativeDuration ( duration, destEpochNs, isoDateTime, timeZone, calendar, largestUnit, increment, smallestUnit, roundingMode ), https://tc39.es/proposal-temporal/#sec-temporal-roundrelativeduration
  1004. ThrowCompletionOr<InternalDuration> round_relative_duration(VM& vm, InternalDuration duration, TimeDuration const& dest_epoch_ns, ISODateTime const& iso_date_time, Optional<StringView> time_zone, StringView calendar, Unit largest_unit, u64 increment, Unit smallest_unit, RoundingMode rounding_mode)
  1005. {
  1006. // 1. Let irregularLengthUnit be false.
  1007. auto irregular_length_unit = false;
  1008. // 2. If IsCalendarUnit(smallestUnit) is true, set irregularLengthUnit to true.
  1009. if (is_calendar_unit(smallest_unit))
  1010. irregular_length_unit = true;
  1011. // 3. If timeZone is not UNSET and smallestUnit is DAY, set irregularLengthUnit to true.
  1012. if (time_zone.has_value() && smallest_unit == Unit::Day)
  1013. irregular_length_unit = true;
  1014. // 4. If InternalDurationSign(duration) < 0, let sign be -1; else let sign be 1.
  1015. i8 sign = internal_duration_sign(duration) < 0 ? -1 : 1;
  1016. DurationNudgeResult nudge_result;
  1017. // 5. If irregularLengthUnit is true, then
  1018. if (irregular_length_unit) {
  1019. // a. Let record be ? NudgeToCalendarUnit(sign, duration, destEpochNs, isoDateTime, timeZone, calendar, increment, smallestUnit, roundingMode).
  1020. auto record = TRY(nudge_to_calendar_unit(vm, sign, duration, dest_epoch_ns, iso_date_time, time_zone, calendar, increment, smallest_unit, rounding_mode));
  1021. // b. Let nudgeResult be record.[[NudgeResult]].
  1022. nudge_result = move(record.nudge_result);
  1023. }
  1024. // 6. Else if timeZone is not UNSET, then
  1025. else if (time_zone.has_value()) {
  1026. // a. Let nudgeResult be ? NudgeToZonedTime(sign, duration, isoDateTime, timeZone, calendar, increment, smallestUnit, roundingMode).
  1027. nudge_result = TRY(nudge_to_zoned_time(vm, sign, duration, iso_date_time, *time_zone, calendar, increment, smallest_unit, rounding_mode));
  1028. }
  1029. // 7. Else,
  1030. else {
  1031. // a. Let nudgeResult be ? NudgeToDayOrTime(duration, destEpochNs, largestUnit, increment, smallestUnit, roundingMode).
  1032. nudge_result = TRY(nudge_to_day_or_time(vm, duration, dest_epoch_ns, largest_unit, increment, smallest_unit, rounding_mode));
  1033. }
  1034. // 8. Set duration to nudgeResult.[[Duration]].
  1035. duration = move(nudge_result.duration);
  1036. // 9. If nudgeResult.[[DidExpandCalendarUnit]] is true and smallestUnit is not WEEK, then
  1037. if (nudge_result.did_expand_calendar_unit && smallest_unit != Unit::Week) {
  1038. // a. Let startUnit be LargerOfTwoTemporalUnits(smallestUnit, DAY).
  1039. auto start_unit = larger_of_two_temporal_units(smallest_unit, Unit::Day);
  1040. // b. Set duration to ? BubbleRelativeDuration(sign, duration, nudgeResult.[[NudgedEpochNs]], isoDateTime, timeZone, calendar, largestUnit, startUnit).
  1041. duration = TRY(bubble_relative_duration(vm, sign, move(duration), nudge_result.nudged_epoch_ns, iso_date_time, time_zone, calendar, largest_unit, start_unit));
  1042. }
  1043. // 10. Return duration.
  1044. return duration;
  1045. }
  1046. // 7.5.39 TemporalDurationToString ( duration, precision ), https://tc39.es/proposal-temporal/#sec-temporal-temporaldurationtostring
  1047. String temporal_duration_to_string(Duration const& duration, Precision precision)
  1048. {
  1049. // 1. Let sign be DurationSign(duration).
  1050. auto sign = duration_sign(duration);
  1051. // 2. Let datePart be the empty String.
  1052. StringBuilder date_part;
  1053. // 3. If duration.[[Years]] ≠ 0, then
  1054. if (duration.years() != 0) {
  1055. // a. Set datePart to the string concatenation of abs(duration.[[Years]]) formatted as a decimal number and the
  1056. // code unit 0x0059 (LATIN CAPITAL LETTER Y).
  1057. date_part.appendff("{}Y", AK::fabs(duration.years()));
  1058. }
  1059. // 4. If duration.[[Months]] ≠ 0, then
  1060. if (duration.months() != 0) {
  1061. // a. Set datePart to the string concatenation of datePart, abs(duration.[[Months]]) formatted as a decimal number,
  1062. // and the code unit 0x004D (LATIN CAPITAL LETTER M).
  1063. date_part.appendff("{}M", AK::fabs(duration.months()));
  1064. }
  1065. // 5. If duration.[[Weeks]] ≠ 0, then
  1066. if (duration.weeks() != 0) {
  1067. // a. Set datePart to the string concatenation of datePart, abs(duration.[[Weeks]]) formatted as a decimal number,
  1068. // and the code unit 0x0057 (LATIN CAPITAL LETTER W).
  1069. date_part.appendff("{}W", AK::fabs(duration.weeks()));
  1070. }
  1071. // 6. If duration.[[Days]] ≠ 0, then
  1072. if (duration.days() != 0) {
  1073. // a. Set datePart to the string concatenation of datePart, abs(duration.[[Days]]) formatted as a decimal number,
  1074. // and the code unit 0x0044 (LATIN CAPITAL LETTER D).
  1075. date_part.appendff("{}D", AK::fabs(duration.days()));
  1076. }
  1077. // 7. Let timePart be the empty String.
  1078. StringBuilder time_part;
  1079. // 8. If duration.[[Hours]] ≠ 0, then
  1080. if (duration.hours() != 0) {
  1081. // a. Set timePart to the string concatenation of abs(duration.[[Hours]]) formatted as a decimal number and the
  1082. // code unit 0x0048 (LATIN CAPITAL LETTER H).
  1083. time_part.appendff("{}H", AK::fabs(duration.hours()));
  1084. }
  1085. // 9. If duration.[[Minutes]] ≠ 0, then
  1086. if (duration.minutes() != 0) {
  1087. // a. Set timePart to the string concatenation of timePart, abs(duration.[[Minutes]]) formatted as a decimal number,
  1088. // and the code unit 0x004D (LATIN CAPITAL LETTER M).
  1089. time_part.appendff("{}M", AK::fabs(duration.minutes()));
  1090. }
  1091. // 10. Let zeroMinutesAndHigher be false.
  1092. auto zero_minutes_and_higher = false;
  1093. // 11. If DefaultTemporalLargestUnit(duration) is SECOND, MILLISECOND, MICROSECOND, or NANOSECOND, set zeroMinutesAndHigher to true.
  1094. if (auto unit = default_temporal_largest_unit(duration); unit == Unit::Second || unit == Unit::Millisecond || unit == Unit::Microsecond || unit == Unit::Nanosecond)
  1095. zero_minutes_and_higher = true;
  1096. // 12. Let secondsDuration be TimeDurationFromComponents(0, 0, duration.[[Seconds]], duration.[[Milliseconds]], duration.[[Microseconds]], duration.[[Nanoseconds]]).
  1097. auto seconds_duration = time_duration_from_components(0, 0, duration.seconds(), duration.milliseconds(), duration.microseconds(), duration.nanoseconds());
  1098. // 13. If secondsDuration ≠ 0, or zeroMinutesAndHigher is true, or precision is not auto, then
  1099. if (!seconds_duration.is_zero() || zero_minutes_and_higher || !precision.has<Auto>()) {
  1100. auto division_result = seconds_duration.divided_by(NANOSECONDS_PER_SECOND);
  1101. // a. Let secondsPart be abs(truncate(secondsDuration / 10**9)) formatted as a decimal number.
  1102. auto seconds_part = MUST(division_result.quotient.unsigned_value().to_base(10));
  1103. // b. Let subSecondsPart be FormatFractionalSeconds(abs(remainder(secondsDuration, 10**9)), precision).
  1104. auto sub_seconds_part = format_fractional_seconds(division_result.remainder.unsigned_value().to_u64(), precision);
  1105. // c. Set timePart to the string concatenation of timePart, secondsPart, subSecondsPart, and the code unit
  1106. // 0x0053 (LATIN CAPITAL LETTER S).
  1107. time_part.appendff("{}{}S", seconds_part, sub_seconds_part);
  1108. }
  1109. // 14. Let signPart be the code unit 0x002D (HYPHEN-MINUS) if sign < 0, and otherwise the empty String.
  1110. auto sign_part = sign < 0 ? "-"sv : ""sv;
  1111. // 15. Let result be the string concatenation of signPart, the code unit 0x0050 (LATIN CAPITAL LETTER P) and datePart.
  1112. StringBuilder result;
  1113. result.appendff("{}P{}", sign_part, date_part.string_view());
  1114. // 16. If timePart is not the empty String, then
  1115. if (!time_part.is_empty()) {
  1116. // a. Set result to the string concatenation of result, the code unit 0x0054 (LATIN CAPITAL LETTER T), and timePart.
  1117. result.appendff("T{}", time_part.string_view());
  1118. }
  1119. // 17. Return result.
  1120. return MUST(result.to_string());
  1121. }
  1122. // 7.5.40 AddDurations ( operation, duration, other ), https://tc39.es/proposal-temporal/#sec-temporal-adddurations
  1123. ThrowCompletionOr<GC::Ref<Duration>> add_durations(VM& vm, ArithmeticOperation operation, Duration const& duration, Value other_value)
  1124. {
  1125. // 1. Set other to ? ToTemporalDuration(other).
  1126. auto other = TRY(to_temporal_duration(vm, other_value));
  1127. // 2. If operation is subtract, set other to CreateNegatedTemporalDuration(other).
  1128. if (operation == ArithmeticOperation::Subtract)
  1129. other = create_negated_temporal_duration(vm, other);
  1130. // 3. Let largestUnit1 be DefaultTemporalLargestUnit(duration).
  1131. auto largest_unit1 = default_temporal_largest_unit(duration);
  1132. // 4. Let largestUnit2 be DefaultTemporalLargestUnit(other).
  1133. auto largest_unit2 = default_temporal_largest_unit(other);
  1134. // 5. Let largestUnit be LargerOfTwoTemporalUnits(largestUnit1, largestUnit2).
  1135. auto largest_unit = larger_of_two_temporal_units(largest_unit1, largest_unit2);
  1136. // 6. If IsCalendarUnit(largestUnit) is true, throw a RangeError exception.
  1137. if (is_calendar_unit(largest_unit))
  1138. return vm.throw_completion<RangeError>(ErrorType::TemporalInvalidLargestUnit, "a calendar unit"sv);
  1139. // 7. Let d1 be ToInternalDurationRecordWith24HourDays(duration).
  1140. auto duration1 = to_internal_duration_record_with_24_hour_days(vm, duration);
  1141. // 8. Let d2 be ToInternalDurationRecordWith24HourDays(other).
  1142. auto duration2 = to_internal_duration_record_with_24_hour_days(vm, other);
  1143. // 9. Let timeResult be ? AddTimeDuration(d1.[[Time]], d2.[[Time]]).
  1144. auto time_result = TRY(add_time_duration(vm, duration1.time, duration2.time));
  1145. // 10. Let result be ! CombineDateAndTimeDuration(ZeroDateDuration(), timeResult).
  1146. auto result = MUST(combine_date_and_time_duration(vm, zero_date_duration(vm), move(time_result)));
  1147. // 11. Return ? TemporalDurationFromInternal(result, largestUnit).
  1148. return TRY(temporal_duration_from_internal(vm, result, largest_unit));
  1149. }
  1150. }