Stowage/ladybird
2
0
Fork 0
mirror of https://github.com/LadybirdBrowser/ladybird.git synced 2025-10-31 13:20:59 +00:00
Code Issues Projects Releases Packages Wiki Activity
ladybird/Libraries/LibJS/Runtime/Date.h

94 lines
3.3 KiB
C
Raw Normal View History

LibJS: Start implementing Date :^) This adds: - A global Date object (with `length` property and `now` function) - The Date constructor (no arguments yet) - The Date prototype (with `get*` functions)
2020-03-30 00:21:56 +01:00
/*
LibJS: Move Hours/Minutes/Seconds/ms constants out of the Date class They can remain in this header, but will be used outside the Date context in Temporal.
2022-05-06 19:10:34 +02:00
* Copyright (c) 2020-2022, Linus Groh <linusg@serenityos.org>
LibJS: Use Temporal's ISO8601 parser to parse UTC offset strings We now have the Temporal facilities to implement the Date AOs which parse UTC offset strings using the ISO8601 parser. This patch updates those AOs and their callers in accordance with the Temporal spec.
2024-11-20 20:06:42 -05:00
* Copyright (c) 2022-2024, Tim Flynn <trflynn89@ladybird.org>
LibJS: Start implementing Date :^) This adds: - A global Date object (with `length` property and `now` function) - The Date constructor (no arguments yet) - The Date prototype (with `get*` functions)
2020-03-30 00:21:56 +01:00
*
Everything: Move to SPDX license identifiers in all files. SPDX License Identifiers are a more compact / standardized way of representing file license information. See: https://spdx.dev/resources/use/#identifiers This was done with the `ambr` search and replace tool. ambr --no-parent-ignore --key-from-file --rep-from-file key.txt rep.txt *
2021-04-22 01:24:48 -07:00
* SPDX-License-Identifier: BSD-2-Clause
LibJS: Start implementing Date :^) This adds: - A global Date object (with `length` property and `now` function) - The Date constructor (no arguments yet) - The Date prototype (with `get*` functions)
2020-03-30 00:21:56 +01:00
*/
Meta: Add a script check the presence of "#pragma once" in header files .. and make travis run it. I renamed check-license-headers.sh to check-style.sh and expanded it so that it now also checks for the presence of "#pragma once" in .h files. It also checks the presence of a (single) blank line above and below the "#pragma once" line. I also added "#pragma once" to all the files that need it: even the ones we are not check. I also added/removed blank lines in order to make the script not fail. I also ran clang-format on the files I modified.
2020-05-28 20:40:53 +02:00
#pragma once
LibJS+LibWeb: Move headers around to allow including Value from Cell The goal here is to allow Cell::initialize to return a ThrowCompletion, to handle OOM for example. Cell.h will then need to include Completion.h which must include Value.h. This currently can't happen because Value.h includes BigInt.h, which in turn includes Cell.h. So we would have an include cycle. This removes BigInt.h from Value.h, as it is forward-declarable (it is only referred to with a reference or pointer). Then the Value overload for Cell::Visitor::visit is moved to Cell.h, and missing BigInt.h includes as peppered as needed.
2023-01-28 11:26:03 -05:00
#include <LibCrypto/BigInt/SignedBigInteger.h>
LibJS: Start implementing Date :^) This adds: - A global Date object (with `length` property and `now` function) - The Date constructor (no arguments yet) - The Date prototype (with `get*` functions)
2020-03-30 00:21:56 +01:00
#include <LibJS/Runtime/Object.h>
LibCore+LibJS+LibUnicode: Port retrieving time zone offsets to ICU The changes to tests are due to LibTimeZone incorrectly interpreting time stamps in the TZDB. The TZDB will list zone transitions in either UTC or the zone's local time (which is then subject to DST offsets). LibTimeZone did not handle the latter at all. For example: The following rule is in effect until November 18, 6PM UTC. America/Chicago -5:50:36 - LMT 1883 Nov 18 18:00u The following rule is in effect until March 1, 2AM in Chicago time. But at that time, a DST transition occurs, so the local time is actually 3AM. America/Chicago -6:00 Chicago C%sT 1936 Mar 1 2:00
2024-06-25 15:27:20 -04:00
#include <LibUnicode/TimeZone.h>
LibJS: Start implementing Date :^) This adds: - A global Date object (with `length` property and `now` function) - The Date constructor (no arguments yet) - The Date prototype (with `get*` functions)
2020-03-30 00:21:56 +01:00
namespace JS {
class Date final : public Object {
LibJS+LibWeb: Add JS::Object::inherits(class_name) To allow implementing the DOM class hierarchy in JS bindings, this patch adds an inherits() function that can be used to ask an Object if it inherits from a specific C++ class (by name). The necessary overrides are baked into each Object subclass by the new JS_OBJECT macro, which works similarly to C_OBJECT in LibCore. Thanks to @Dexesttp for suggesting this approach. :^)
2020-06-21 15:14:02 +02:00
JS_OBJECT(Date, Object);
LibGC+Everywhere: Factor out a LibGC from LibJS Resulting in a massive rename across almost everywhere! Alongside the namespace change, we now have the following names: * JS::NonnullGCPtr -> GC::Ref * JS::GCPtr -> GC::Ptr * JS::HeapFunction -> GC::Function * JS::CellImpl -> GC::Cell * JS::Handle -> GC::Root
2024-11-15 04:01:23 +13:00
GC_DECLARE_ALLOCATOR(Date);
LibJS+LibWeb: Add JS::Object::inherits(class_name) To allow implementing the DOM class hierarchy in JS bindings, this patch adds an inherits() function that can be used to ask an Object if it inherits from a specific C++ class (by name). The necessary overrides are baked into each Object subclass by the new JS_OBJECT macro, which works similarly to C_OBJECT in LibCore. Thanks to @Dexesttp for suggesting this approach. :^)
2020-06-21 15:14:02 +02:00
LibJS: Start implementing Date :^) This adds: - A global Date object (with `length` property and `now` function) - The Date constructor (no arguments yet) - The Date prototype (with `get*` functions)
2020-03-30 00:21:56 +01:00
public:
LibGC+Everywhere: Factor out a LibGC from LibJS Resulting in a massive rename across almost everywhere! Alongside the namespace change, we now have the following names: * JS::NonnullGCPtr -> GC::Ref * JS::GCPtr -> GC::Ptr * JS::HeapFunction -> GC::Function * JS::CellImpl -> GC::Cell * JS::Handle -> GC::Root
2024-11-15 04:01:23 +13:00
static GC::Ref<Date> create(Realm&, double date_value);
LibJS: Pass prototype to Date constructor
2020-04-17 19:07:59 +02:00
LibJS: Ensure JS::Date has a key function and its vtable is in LibJS Without a key function, the vtable for this class can be emitted into every shared object or executable that needs it. This can cause bugs and bad behavior when trying to access the vtable or RTTI for the class. This is most easily seen when trying to call ``is<JS::Date>``, which currently will do a dynamic_cast. Based on compiler, linker and loader choices about ordering, it's possible that the code checking the RTTI and the code that created the object could have a different vtable and type_info in mind, causing false negatives for the ``is`` check.
2024-01-09 16:01:28 -07:00
// Out of line to ensure we have a key function
virtual ~Date() override;
LibJS: Start implementing Date :^) This adds: - A global Date object (with `length` property and `now` function) - The Date constructor (no arguments yet) - The Date prototype (with `get*` functions)
2020-03-30 00:21:56 +01:00
LibJS: Re-implement the Date constructor / prototype for spec compliance First, this adds a constructor to the Date object to be created from a plain double. This is a first step to removing Core::DateTime as the basis for the Date object. A subsequent commit will remove the now- unused data from the object. Next, this implements the constructor in accordance to the spec. The constructor when NewTarget is undefined no longer allocates a Date on the heap. The other constructor properly uses recently created AOs to handle time zone and ensure the created [[DateValue]] is valid. Other methods on the constructor (Date.now) have not been touched yet. Last, the prototype is reimplemented. Again, we use other AOs to handle time zones and time clipping. Not all prototypes are fixed; most of them are, but a few (e.g. Date.prototype.getTimezoneOffset) were not fixed, but left in a mostly unimplemented state for another commit. In all of the above, spec comments are added. This is a rather large change; but it's tough to do any of these parts individually without breaking everything else.
2022-01-14 17:42:42 -05:00
double date_value() const { return m_date_value; }
void set_date_value(double value) { m_date_value = value; }
LibJS: Replace a DeprecatedString with String Refactors Date class to use String instead of DeprecatedString. Changes use of the Date class in DatePrototype accordingly.
2023-05-18 17:46:01 -07:00
ErrorOr<String> iso_date_string() const;
LibJS: Implement Date.prototype.toISOString()
2020-08-20 16:29:27 -04:00
LibJS: Start implementing Date :^) This adds: - A global Date object (with `length` property and `now` function) - The Date constructor (no arguments yet) - The Date prototype (with `get*` functions)
2020-03-30 00:21:56 +01:00
private:
LibJS: Hide all the constructors! Now that the GC allocator is able to invoke Cell subclass constructors directly via friendship, we no longer need to keep them public. :^)
2022-08-28 23:51:28 +02:00
Date(double date_value, Object& prototype);
LibJS: Re-implement the Date constructor / prototype for spec compliance First, this adds a constructor to the Date object to be created from a plain double. This is a first step to removing Core::DateTime as the basis for the Date object. A subsequent commit will remove the now- unused data from the object. Next, this implements the constructor in accordance to the spec. The constructor when NewTarget is undefined no longer allocates a Date on the heap. The other constructor properly uses recently created AOs to handle time zone and ensure the created [[DateValue]] is valid. Other methods on the constructor (Date.now) have not been touched yet. Last, the prototype is reimplemented. Again, we use other AOs to handle time zones and time clipping. Not all prototypes are fixed; most of them are, but a few (e.g. Date.prototype.getTimezoneOffset) were not fixed, but left in a mostly unimplemented state for another commit. In all of the above, spec comments are added. This is a rather large change; but it's tough to do any of these parts individually without breaking everything else.
2022-01-14 17:42:42 -05:00
double m_date_value { 0 }; // [[DateValue]]
LibJS: Start implementing Date :^) This adds: - A global Date object (with `length` property and `now` function) - The Date constructor (no arguments yet) - The Date prototype (with `get*` functions)
2020-03-30 00:21:56 +01:00
};
LibJS: Implement time zone identifier AOs centrally within Date This is an editorial change in the ECMA-262 spec. See: https://github.com/tc39/ecma262/commit/73926a5 The idea here is to reduce duplication of these AOs between ECMA-262, ECMA-402, and Temporal. This patch contains only the ECMA-262 changes.
2023-10-03 12:14:59 -04:00
// 21.4.1.22 Time Zone Identifier Record, https://tc39.es/ecma262/#sec-time-zone-identifier-record
struct TimeZoneIdentifier {
LibCore+LibJS+LibUnicode: Port retrieving available time zones to ICU This required updating some LibJS spec steps to their latest versions, as the data expected by the old steps does not quite match the APIs that are available with the ICU. The new spec steps are much more aligned.
2024-06-25 11:06:08 -04:00
String identifier; // [[Identifier]]
String primary_identifier; // [[PrimaryIdentifier]]
LibJS: Implement time zone identifier AOs centrally within Date This is an editorial change in the ECMA-262 spec. See: https://github.com/tc39/ecma262/commit/73926a5 The idea here is to reduce duplication of these AOs between ECMA-262, ECMA-402, and Temporal. This patch contains only the ECMA-262 changes.
2023-10-03 12:14:59 -04:00
};
LibJS: Move Hours/Minutes/Seconds/ms constants out of the Date class They can remain in this header, but will be used outside the Date context in Temporal.
2022-05-06 19:10:34 +02:00
// https://tc39.es/ecma262/#eqn-HoursPerDay
LibJS: Define Date constants such that translation units don't copy them Variables that are constexpr must be delcared inline in the global namespace to prevent copying them. The static keyword is meaningless on variables in headers in the global namespace. Declare the static bigint as extern and define it out-of-line instead.
2023-01-28 11:12:54 -05:00
constexpr inline double hours_per_day = 24;
LibJS: Move Hours/Minutes/Seconds/ms constants out of the Date class They can remain in this header, but will be used outside the Date context in Temporal.
2022-05-06 19:10:34 +02:00
// https://tc39.es/ecma262/#eqn-MinutesPerHour
LibJS: Define Date constants such that translation units don't copy them Variables that are constexpr must be delcared inline in the global namespace to prevent copying them. The static keyword is meaningless on variables in headers in the global namespace. Declare the static bigint as extern and define it out-of-line instead.
2023-01-28 11:12:54 -05:00
constexpr inline double minutes_per_hour = 60;
LibJS: Move Hours/Minutes/Seconds/ms constants out of the Date class They can remain in this header, but will be used outside the Date context in Temporal.
2022-05-06 19:10:34 +02:00
// https://tc39.es/ecma262/#eqn-SecondsPerMinute
LibJS: Define Date constants such that translation units don't copy them Variables that are constexpr must be delcared inline in the global namespace to prevent copying them. The static keyword is meaningless on variables in headers in the global namespace. Declare the static bigint as extern and define it out-of-line instead.
2023-01-28 11:12:54 -05:00
constexpr inline double seconds_per_minute = 60;
LibJS: Move Hours/Minutes/Seconds/ms constants out of the Date class They can remain in this header, but will be used outside the Date context in Temporal.
2022-05-06 19:10:34 +02:00
// https://tc39.es/ecma262/#eqn-msPerSecond
LibJS: Define Date constants such that translation units don't copy them Variables that are constexpr must be delcared inline in the global namespace to prevent copying them. The static keyword is meaningless on variables in headers in the global namespace. Declare the static bigint as extern and define it out-of-line instead.
2023-01-28 11:12:54 -05:00
constexpr inline double ms_per_second = 1'000;
LibJS: Move Hours/Minutes/Seconds/ms constants out of the Date class They can remain in this header, but will be used outside the Date context in Temporal.
2022-05-06 19:10:34 +02:00
// https://tc39.es/ecma262/#eqn-msPerMinute
LibJS: Define Date constants such that translation units don't copy them Variables that are constexpr must be delcared inline in the global namespace to prevent copying them. The static keyword is meaningless on variables in headers in the global namespace. Declare the static bigint as extern and define it out-of-line instead.
2023-01-28 11:12:54 -05:00
constexpr inline double ms_per_minute = 60'000;
LibJS: Move Hours/Minutes/Seconds/ms constants out of the Date class They can remain in this header, but will be used outside the Date context in Temporal.
2022-05-06 19:10:34 +02:00
// https://tc39.es/ecma262/#eqn-msPerHour
LibJS: Define Date constants such that translation units don't copy them Variables that are constexpr must be delcared inline in the global namespace to prevent copying them. The static keyword is meaningless on variables in headers in the global namespace. Declare the static bigint as extern and define it out-of-line instead.
2023-01-28 11:12:54 -05:00
constexpr inline double ms_per_hour = 3'600'000;
LibJS: Move Hours/Minutes/Seconds/ms constants out of the Date class They can remain in this header, but will be used outside the Date context in Temporal.
2022-05-06 19:10:34 +02:00
// https://tc39.es/ecma262/#eqn-msPerDay
LibJS: Define Date constants such that translation units don't copy them Variables that are constexpr must be delcared inline in the global namespace to prevent copying them. The static keyword is meaningless on variables in headers in the global namespace. Declare the static bigint as extern and define it out-of-line instead.
2023-01-28 11:12:54 -05:00
constexpr inline double ms_per_day = 86'400'000;
LibJS: Replace magic nanosecond numbers with constants This is an editorial change in the Temporal spec. See: https://github.com/tc39/proposal-temporal/commit/3fdbfda
2022-05-06 19:28:56 +02:00
// https://tc39.es/proposal-temporal/#eqn-nsPerDay
LibJS: Define Date constants such that translation units don't copy them Variables that are constexpr must be delcared inline in the global namespace to prevent copying them. The static keyword is meaningless on variables in headers in the global namespace. Declare the static bigint as extern and define it out-of-line instead.
2023-01-28 11:12:54 -05:00
constexpr inline double ns_per_day = 86'400'000'000'000;
extern Crypto::SignedBigInteger const ns_per_day_bigint;
LibJS: Move Hours/Minutes/Seconds/ms constants out of the Date class They can remain in this header, but will be used outside the Date context in Temporal.
2022-05-06 19:10:34 +02:00
LibJS: Convert Date-related equations into proper AOs This is an editorial change in the ECMA-262 spec. See: https://github.com/tc39/ecma262/commit/7178fa8
2023-10-03 11:01:19 -04:00
double day(double);
double time_within_day(double);
LibJS: Implement a bunch of time value related Date AOs We don't have these yet as our Date implementation doesn't use the time value algorithms and AOs from the spec, but Temporal will need these in various contexts.
2021-07-25 20:47:40 +01:00
u16 days_in_year(i32);
double day_from_year(i32);
LibJS: Adjust approximated result in year_from_time() if necessary
2021-11-05 01:18:27 +01:00
double time_from_year(i32);
LibJS: Implement a bunch of time value related Date AOs We don't have these yet as our Date implementation doesn't use the time value algorithms and AOs from the spec, but Temporal will need these in various contexts.
2021-07-25 20:47:40 +01:00
i32 year_from_time(double);
LibJS: Convert Date-related equations into proper AOs This is an editorial change in the ECMA-262 spec. See: https://github.com/tc39/ecma262/commit/7178fa8
2023-10-03 11:01:19 -04:00
u16 day_within_year(double);
LibJS: Implement a bunch of time value related Date AOs We don't have these yet as our Date implementation doesn't use the time value algorithms and AOs from the spec, but Temporal will need these in various contexts.
2021-07-25 20:47:40 +01:00
bool in_leap_year(double);
u8 month_from_time(double);
LibJS: Convert Date-related equations into proper AOs This is an editorial change in the ECMA-262 spec. See: https://github.com/tc39/ecma262/commit/7178fa8
2023-10-03 11:01:19 -04:00
u8 date_from_time(double);
u8 week_day(double);
LibJS: Implement a bunch of time value related Date AOs We don't have these yet as our Date implementation doesn't use the time value algorithms and AOs from the spec, but Temporal will need these in various contexts.
2021-07-25 20:47:40 +01:00
u8 hour_from_time(double);
u8 min_from_time(double);
u8 sec_from_time(double);
u16 ms_from_time(double);
LibJS: Update Date AOs to use Temporal Neglected to do this after the Temporal rewrite. This lets us eliminate the duplicated GetUTCEpochNanoseconds definition in Temporal.
2025-02-28 11:54:54 -05:00
Crypto::SignedBigInteger get_utc_epoch_nanoseconds(Temporal::ISODateTime const&);
Vector<Crypto::SignedBigInteger> get_named_time_zone_epoch_nanoseconds(StringView time_zone_identifier, Temporal::ISODateTime const&);
LibCore+LibJS+LibUnicode: Port retrieving time zone offsets to ICU The changes to tests are due to LibTimeZone incorrectly interpreting time stamps in the TZDB. The TZDB will list zone transitions in either UTC or the zone's local time (which is then subject to DST offsets). LibTimeZone did not handle the latter at all. For example: The following rule is in effect until November 18, 6PM UTC. America/Chicago -5:50:36 - LMT 1883 Nov 18 18:00u The following rule is in effect until March 1, 2AM in Chicago time. But at that time, a DST transition occurs, so the local time is actually 3AM. America/Chicago -6:00 Chicago C%sT 1936 Mar 1 2:00
2024-06-25 15:27:20 -04:00
Unicode::TimeZoneOffset get_named_time_zone_offset_nanoseconds(StringView time_zone_identifier, Crypto::SignedBigInteger const& epoch_nanoseconds);
LibJS: Add a non-BigInt overload of GetNamedTimeZoneOffsetNanoseconds In some cases, we have a timestamp as a double in milliseconds. We then would convert it to nanoseconds as a BigInt, just to bring it back to a double for TZDB lookups. Add an overload to avoid this needless round trip.
2024-09-03 10:26:03 -04:00
Unicode::TimeZoneOffset get_named_time_zone_offset_milliseconds(StringView time_zone_identifier, double epoch_milliseconds);
LibJS+LibUnicode: Port retrieving the system time zone to ICU
2024-06-24 10:17:32 -04:00
String system_time_zone_identifier();
LibJS+WebContent: Cache the resolved system time zone identifier Even though the underlying time zone is already cached by LibUnicode, JS performs additional expensive lookups with that time zone. There's no need to do those lookups again until the system time zone has changed.
2024-09-03 10:18:43 -04:00
void clear_system_time_zone_cache();
LibJS: Implement the LocalTime, UTC, and TimeWithinDay AOs
2022-01-14 13:10:07 -05:00
double local_time(double time);
double utc_time(double time);
LibJS: Convert remaining Date AOs using JS::Value as in/output to double There was an awful lot of JS::Value <-> double conversion going on, even through these AOs only work with number values anyway. They don't need a global object either as they won't allocate or throw, that was simply to pass it to infallible calls of ToIntegerOrInfinity.
2022-05-06 20:45:25 +02:00
double make_time(double hour, double min, double sec, double ms);
double make_day(double year, double month, double date);
double make_date(double day, double time);
double time_clip(double time);
LibJS: Use Temporal's ISO8601 parser to parse UTC offset strings We now have the Temporal facilities to implement the Date AOs which parse UTC offset strings using the ISO8601 parser. This patch updates those AOs and their callers in accordance with the Temporal spec.
2024-11-20 20:06:42 -05:00
bool is_offset_time_zone_identifier(StringView offset_string);
ThrowCompletionOr<double> parse_date_time_utc_offset(VM&, StringView offset_string);
double parse_date_time_utc_offset(StringView offset_string);
double parse_date_time_utc_offset(Temporal::TimeZoneOffset const&);
LibJS: Add the ToTemporalInstant Abstract Operation & its requirements This is Abstract Operation is required for the majority of InstantConstructor's and InstantPrototype's methods. The implementation is not entirely complete, (specifically 2 of the underlying required abstract operations, ParseTemporalTimeZoneString and ParseISODateTime are missing the required lexing, and as such are TODO()-ed) but the majority of it is done.
2021-07-11 21:04:11 +03:00
LibJS: Start implementing Date :^) This adds: - A global Date object (with `length` property and `now` function) - The Date constructor (no arguments yet) - The Date prototype (with `get*` functions)
2020-03-30 00:21:56 +01:00
}
Reference in a new issue Copy permalink