mirror of
https://github.com/denoland/deno.git
synced 2024-11-24 15:19:26 -05:00
BREAKING(temporal/unstable): Remove obsoleted Temporal APIs (#24836)
This commit is contained in:
Kenta Moriuchi
GitHub
parent
930ccf928a
commit
d2b66e50fd
2 changed files with 78 additions and 129 deletions
159
cli/tsc/dts/lib.deno.unstable.d.ts
vendored
159
cli/tsc/dts/lib.deno.unstable.d.ts
vendored
|
|
@ -2606,7 +2606,7 @@ declare namespace Temporal {
|
|||
/**
|
||||
* When the name of a unit is provided to a Temporal API as a string, it is
|
||||
* usually singular, e.g. 'day' or 'hour'. But plural unit names like 'days'
|
||||
* or 'hours' are aso accepted too.
|
||||
* or 'hours' are also accepted.
|
||||
*
|
||||
* @category Temporal
|
||||
* @experimental
|
||||
|
|
@ -2925,8 +2925,8 @@ declare namespace Temporal {
|
|||
* This value must be either a `Temporal.PlainDateTime`, a
|
||||
* `Temporal.ZonedDateTime`, or a string or object value that can be
|
||||
* passed to `from()` of those types. Examples:
|
||||
* - `'2020-01'01T00:00-08:00[America/Los_Angeles]'`
|
||||
* - `'2020-01'01'`
|
||||
* - `'2020-01-01T00:00-08:00[America/Los_Angeles]'`
|
||||
* - `'2020-01-01'`
|
||||
* - `Temporal.PlainDate.from('2020-01-01')`
|
||||
*
|
||||
* `Temporal.ZonedDateTime` will be tried first because it's more
|
||||
|
|
@ -2971,8 +2971,8 @@ declare namespace Temporal {
|
|||
* This value must be either a `Temporal.PlainDateTime`, a
|
||||
* `Temporal.ZonedDateTime`, or a string or object value that can be passed
|
||||
* to `from()` of those types. Examples:
|
||||
* - `'2020-01'01T00:00-08:00[America/Los_Angeles]'`
|
||||
* - `'2020-01'01'`
|
||||
* - `'2020-01-01T00:00-08:00[America/Los_Angeles]'`
|
||||
* - `'2020-01-01'`
|
||||
* - `Temporal.PlainDate.from('2020-01-01')`
|
||||
*
|
||||
* `Temporal.ZonedDateTime` will be tried first because it's more
|
||||
|
|
@ -3007,8 +3007,8 @@ declare namespace Temporal {
|
|||
* This value must be either a `Temporal.PlainDateTime`, a
|
||||
* `Temporal.ZonedDateTime`, or a string or object value that can be passed
|
||||
* to `from()` of those types. Examples:
|
||||
* - `'2020-01'01T00:00-08:00[America/Los_Angeles]'`
|
||||
* - `'2020-01'01'`
|
||||
* - `'2020-01-01T00:00-08:00[America/Los_Angeles]'`
|
||||
* - `'2020-01-01'`
|
||||
* - `Temporal.PlainDate.from('2020-01-01')`
|
||||
*
|
||||
* `Temporal.ZonedDateTime` will be tried first because it's more
|
||||
|
|
@ -3027,6 +3027,16 @@ declare namespace Temporal {
|
|||
| string;
|
||||
}
|
||||
|
||||
/**
|
||||
* Options to control behaviour of `ZonedDateTime.prototype.getTimeZoneTransition()`
|
||||
*
|
||||
* @category Temporal
|
||||
* @experimental
|
||||
*/
|
||||
export type TransitionDirection = "next" | "previous" | {
|
||||
direction: "next" | "previous";
|
||||
};
|
||||
|
||||
/**
|
||||
* @category Temporal
|
||||
* @experimental
|
||||
|
|
@ -3127,9 +3137,7 @@ declare namespace Temporal {
|
|||
* @experimental
|
||||
*/
|
||||
export class Instant {
|
||||
static fromEpochSeconds(epochSeconds: number): Temporal.Instant;
|
||||
static fromEpochMilliseconds(epochMilliseconds: number): Temporal.Instant;
|
||||
static fromEpochMicroseconds(epochMicroseconds: bigint): Temporal.Instant;
|
||||
static fromEpochNanoseconds(epochNanoseconds: bigint): Temporal.Instant;
|
||||
static from(item: Temporal.Instant | string): Temporal.Instant;
|
||||
static compare(
|
||||
|
|
@ -3137,9 +3145,7 @@ declare namespace Temporal {
|
|||
two: Temporal.Instant | string,
|
||||
): ComparisonResult;
|
||||
constructor(epochNanoseconds: bigint);
|
||||
readonly epochSeconds: number;
|
||||
readonly epochMilliseconds: number;
|
||||
readonly epochMicroseconds: bigint;
|
||||
readonly epochNanoseconds: bigint;
|
||||
equals(other: Temporal.Instant | string): boolean;
|
||||
add(
|
||||
|
|
@ -3300,14 +3306,14 @@ declare namespace Temporal {
|
|||
| Temporal.PlainDateTime
|
||||
| PlainDateLike
|
||||
| string,
|
||||
): number;
|
||||
): number | undefined;
|
||||
yearOfWeek(
|
||||
date:
|
||||
| Temporal.PlainDate
|
||||
| Temporal.PlainDateTime
|
||||
| PlainDateLike
|
||||
| string,
|
||||
): number;
|
||||
): number | undefined;
|
||||
daysInWeek(
|
||||
date:
|
||||
| Temporal.PlainDate
|
||||
|
|
@ -3476,14 +3482,14 @@ declare namespace Temporal {
|
|||
| Temporal.PlainDateTime
|
||||
| PlainDateLike
|
||||
| string,
|
||||
): number;
|
||||
): number | undefined;
|
||||
yearOfWeek(
|
||||
date:
|
||||
| Temporal.PlainDate
|
||||
| Temporal.PlainDateTime
|
||||
| PlainDateLike
|
||||
| string,
|
||||
): number;
|
||||
): number | undefined;
|
||||
daysInWeek(
|
||||
date:
|
||||
| Temporal.PlainDate
|
||||
|
|
@ -3614,11 +3620,10 @@ declare namespace Temporal {
|
|||
readonly monthCode: string;
|
||||
readonly day: number;
|
||||
readonly calendarId: string;
|
||||
getCalendar(): CalendarProtocol;
|
||||
readonly dayOfWeek: number;
|
||||
readonly dayOfYear: number;
|
||||
readonly weekOfYear: number;
|
||||
readonly yearOfWeek: number;
|
||||
readonly weekOfYear: number | undefined;
|
||||
readonly yearOfWeek: number | undefined;
|
||||
readonly daysInWeek: number;
|
||||
readonly daysInYear: number;
|
||||
readonly daysInMonth: number;
|
||||
|
|
@ -3755,11 +3760,10 @@ declare namespace Temporal {
|
|||
readonly microsecond: number;
|
||||
readonly nanosecond: number;
|
||||
readonly calendarId: string;
|
||||
getCalendar(): CalendarProtocol;
|
||||
readonly dayOfWeek: number;
|
||||
readonly dayOfYear: number;
|
||||
readonly weekOfYear: number;
|
||||
readonly yearOfWeek: number;
|
||||
readonly weekOfYear: number | undefined;
|
||||
readonly yearOfWeek: number | undefined;
|
||||
readonly daysInWeek: number;
|
||||
readonly daysInYear: number;
|
||||
readonly daysInMonth: number;
|
||||
|
|
@ -3773,9 +3777,6 @@ declare namespace Temporal {
|
|||
withPlainTime(
|
||||
timeLike?: Temporal.PlainTime | PlainTimeLike | string,
|
||||
): Temporal.PlainDateTime;
|
||||
withPlainDate(
|
||||
dateLike: Temporal.PlainDate | PlainDateLike | string,
|
||||
): Temporal.PlainDateTime;
|
||||
withCalendar(calendar: CalendarLike): Temporal.PlainDateTime;
|
||||
add(
|
||||
durationLike: Temporal.Duration | DurationLike | string,
|
||||
|
|
@ -3831,8 +3832,6 @@ declare namespace Temporal {
|
|||
options?: ToInstantOptions,
|
||||
): Temporal.ZonedDateTime;
|
||||
toPlainDate(): Temporal.PlainDate;
|
||||
toPlainYearMonth(): Temporal.PlainYearMonth;
|
||||
toPlainMonthDay(): Temporal.PlainMonthDay;
|
||||
toPlainTime(): Temporal.PlainTime;
|
||||
getISOFields(): PlainDateTimeISOFields;
|
||||
toLocaleString(
|
||||
|
|
@ -3883,7 +3882,6 @@ declare namespace Temporal {
|
|||
readonly monthCode: string;
|
||||
readonly day: number;
|
||||
readonly calendarId: string;
|
||||
getCalendar(): CalendarProtocol;
|
||||
equals(other: Temporal.PlainMonthDay | PlainMonthDayLike | string): boolean;
|
||||
with(
|
||||
monthDayLike: PlainMonthDayLike,
|
||||
|
|
@ -4013,13 +4011,6 @@ declare namespace Temporal {
|
|||
| "nanosecond"
|
||||
>,
|
||||
): Temporal.PlainTime;
|
||||
toPlainDateTime(
|
||||
temporalDate: Temporal.PlainDate | PlainDateLike | string,
|
||||
): Temporal.PlainDateTime;
|
||||
toZonedDateTime(timeZoneAndDate: {
|
||||
timeZone: TimeZoneLike;
|
||||
plainDate: Temporal.PlainDate | PlainDateLike | string;
|
||||
}): Temporal.ZonedDateTime;
|
||||
getISOFields(): PlainTimeISOFields;
|
||||
toLocaleString(
|
||||
locales?: string | string[],
|
||||
|
|
@ -4049,12 +4040,6 @@ declare namespace Temporal {
|
|||
dateTime: Temporal.PlainDateTime | PlainDateTimeLike | string,
|
||||
options?: ToInstantOptions,
|
||||
): Temporal.Instant;
|
||||
getNextTransition?(
|
||||
startingPoint: Temporal.Instant | string,
|
||||
): Temporal.Instant | null;
|
||||
getPreviousTransition?(
|
||||
startingPoint: Temporal.Instant | string,
|
||||
): Temporal.Instant | null;
|
||||
getPossibleInstantsFor(
|
||||
dateTime: Temporal.PlainDateTime | PlainDateTimeLike | string,
|
||||
): Temporal.Instant[];
|
||||
|
|
@ -4091,7 +4076,6 @@ declare namespace Temporal {
|
|||
static from(timeZone: TimeZoneLike): Temporal.TimeZone | TimeZoneProtocol;
|
||||
constructor(timeZoneIdentifier: string);
|
||||
readonly id: string;
|
||||
equals(timeZone: TimeZoneLike): boolean;
|
||||
getOffsetNanosecondsFor(instant: Temporal.Instant | string): number;
|
||||
getOffsetStringFor(instant: Temporal.Instant | string): string;
|
||||
getPlainDateTimeFor(
|
||||
|
|
@ -4102,12 +4086,6 @@ declare namespace Temporal {
|
|||
dateTime: Temporal.PlainDateTime | PlainDateTimeLike | string,
|
||||
options?: ToInstantOptions,
|
||||
): Temporal.Instant;
|
||||
getNextTransition(
|
||||
startingPoint: Temporal.Instant | string,
|
||||
): Temporal.Instant | null;
|
||||
getPreviousTransition(
|
||||
startingPoint: Temporal.Instant | string,
|
||||
): Temporal.Instant | null;
|
||||
getPossibleInstantsFor(
|
||||
dateTime: Temporal.PlainDateTime | PlainDateTimeLike | string,
|
||||
): Temporal.Instant[];
|
||||
|
|
@ -4160,7 +4138,6 @@ declare namespace Temporal {
|
|||
readonly month: number;
|
||||
readonly monthCode: string;
|
||||
readonly calendarId: string;
|
||||
getCalendar(): CalendarProtocol;
|
||||
readonly daysInMonth: number;
|
||||
readonly daysInYear: number;
|
||||
readonly monthsInYear: number;
|
||||
|
|
@ -4272,13 +4249,11 @@ declare namespace Temporal {
|
|||
readonly microsecond: number;
|
||||
readonly nanosecond: number;
|
||||
readonly timeZoneId: string;
|
||||
getTimeZone(): TimeZoneProtocol;
|
||||
readonly calendarId: string;
|
||||
getCalendar(): CalendarProtocol;
|
||||
readonly dayOfWeek: number;
|
||||
readonly dayOfYear: number;
|
||||
readonly weekOfYear: number;
|
||||
readonly yearOfWeek: number;
|
||||
readonly weekOfYear: number | undefined;
|
||||
readonly yearOfWeek: number | undefined;
|
||||
readonly hoursInDay: number;
|
||||
readonly daysInWeek: number;
|
||||
readonly daysInMonth: number;
|
||||
|
|
@ -4299,9 +4274,6 @@ declare namespace Temporal {
|
|||
withPlainTime(
|
||||
timeLike?: Temporal.PlainTime | PlainTimeLike | string,
|
||||
): Temporal.ZonedDateTime;
|
||||
withPlainDate(
|
||||
dateLike: Temporal.PlainDate | PlainDateLike | string,
|
||||
): Temporal.ZonedDateTime;
|
||||
withCalendar(calendar: CalendarLike): Temporal.ZonedDateTime;
|
||||
withTimeZone(timeZone: TimeZoneLike): Temporal.ZonedDateTime;
|
||||
add(
|
||||
|
|
@ -4354,11 +4326,12 @@ declare namespace Temporal {
|
|||
>,
|
||||
): Temporal.ZonedDateTime;
|
||||
startOfDay(): Temporal.ZonedDateTime;
|
||||
getTimeZoneTransition(
|
||||
direction: TransitionDirection,
|
||||
): Temporal.ZonedDateTime | null;
|
||||
toInstant(): Temporal.Instant;
|
||||
toPlainDateTime(): Temporal.PlainDateTime;
|
||||
toPlainDate(): Temporal.PlainDate;
|
||||
toPlainYearMonth(): Temporal.PlainYearMonth;
|
||||
toPlainMonthDay(): Temporal.PlainMonthDay;
|
||||
toPlainTime(): Temporal.PlainTime;
|
||||
getISOFields(): ZonedDateTimeISOFields;
|
||||
toLocaleString(
|
||||
|
|
@ -4395,29 +4368,6 @@ declare namespace Temporal {
|
|||
*/
|
||||
instant: () => Temporal.Instant;
|
||||
|
||||
/**
|
||||
* Get the current calendar date and clock time in a specific calendar and
|
||||
* time zone.
|
||||
*
|
||||
* The `calendar` parameter is required. When using the ISO 8601 calendar or
|
||||
* if you don't understand the need for or implications of a calendar, then
|
||||
* a more ergonomic alternative to this method is
|
||||
* `Temporal.Now.zonedDateTimeISO()`.
|
||||
*
|
||||
* @param {CalendarLike} [calendar] - calendar identifier, or
|
||||
* a `Temporal.Calendar` instance, or an object implementing the calendar
|
||||
* protocol.
|
||||
* @param {TimeZoneLike} [tzLike] -
|
||||
* {@link https://en.wikipedia.org/wiki/List_of_tz_database_time_zones|IANA time zone identifier}
|
||||
* string (e.g. `'Europe/London'`), `Temporal.TimeZone` instance, or an
|
||||
* object implementing the time zone protocol. If omitted, the environment's
|
||||
* current time zone will be used.
|
||||
*/
|
||||
zonedDateTime: (
|
||||
calendar: CalendarLike,
|
||||
tzLike?: TimeZoneLike,
|
||||
) => Temporal.ZonedDateTime;
|
||||
|
||||
/**
|
||||
* Get the current calendar date and clock time in a specific time zone,
|
||||
* using the ISO 8601 calendar.
|
||||
|
|
@ -4430,34 +4380,6 @@ declare namespace Temporal {
|
|||
*/
|
||||
zonedDateTimeISO: (tzLike?: TimeZoneLike) => Temporal.ZonedDateTime;
|
||||
|
||||
/**
|
||||
* Get the current calendar date and clock time in a specific calendar and
|
||||
* time zone.
|
||||
*
|
||||
* The calendar is required. When using the ISO 8601 calendar or if you
|
||||
* don't understand the need for or implications of a calendar, then a more
|
||||
* ergonomic alternative to this method is `Temporal.Now.plainDateTimeISO`.
|
||||
*
|
||||
* Note that the `Temporal.PlainDateTime` type does not persist the time zone,
|
||||
* but retaining the time zone is required for most time-zone-related use
|
||||
* cases. Therefore, it's usually recommended to use
|
||||
* `Temporal.Now.zonedDateTimeISO` or `Temporal.Now.zonedDateTime` instead
|
||||
* of this function.
|
||||
*
|
||||
* @param {CalendarLike} [calendar] - calendar identifier, or
|
||||
* a `Temporal.Calendar` instance, or an object implementing the calendar
|
||||
* protocol.
|
||||
* @param {TimeZoneLike} [tzLike] -
|
||||
* {@link https://en.wikipedia.org/wiki/List_of_tz_database_time_zones|IANA time zone identifier}
|
||||
* string (e.g. `'Europe/London'`), `Temporal.TimeZone` instance, or an
|
||||
* object implementing the time zone protocol. If omitted,
|
||||
* the environment's current time zone will be used.
|
||||
*/
|
||||
plainDateTime: (
|
||||
calendar: CalendarLike,
|
||||
tzLike?: TimeZoneLike,
|
||||
) => Temporal.PlainDateTime;
|
||||
|
||||
/**
|
||||
* Get the current date and clock time in a specific time zone, using the
|
||||
* ISO 8601 calendar.
|
||||
|
|
@ -4475,27 +4397,6 @@ declare namespace Temporal {
|
|||
*/
|
||||
plainDateTimeISO: (tzLike?: TimeZoneLike) => Temporal.PlainDateTime;
|
||||
|
||||
/**
|
||||
* Get the current calendar date in a specific calendar and time zone.
|
||||
*
|
||||
* The calendar is required. When using the ISO 8601 calendar or if you
|
||||
* don't understand the need for or implications of a calendar, then a more
|
||||
* ergonomic alternative to this method is `Temporal.Now.plainDateISO`.
|
||||
*
|
||||
* @param {CalendarLike} [calendar] - calendar identifier, or
|
||||
* a `Temporal.Calendar` instance, or an object implementing the calendar
|
||||
* protocol.
|
||||
* @param {TimeZoneLike} [tzLike] -
|
||||
* {@link https://en.wikipedia.org/wiki/List_of_tz_database_time_zones|IANA time zone identifier}
|
||||
* string (e.g. `'Europe/London'`), `Temporal.TimeZone` instance, or an
|
||||
* object implementing the time zone protocol. If omitted,
|
||||
* the environment's current time zone will be used.
|
||||
*/
|
||||
plainDate: (
|
||||
calendar: CalendarLike,
|
||||
tzLike?: TimeZoneLike,
|
||||
) => Temporal.PlainDate;
|
||||
|
||||
/**
|
||||
* Get the current date in a specific time zone, using the ISO 8601
|
||||
* calendar.
|
||||
|
|
|
|||
|
|
@ -849,6 +849,30 @@ function bootstrapMainRuntime(runtimeOptions, warmup = false) {
|
|||
// Removes the `Temporal` API.
|
||||
delete globalThis.Temporal;
|
||||
delete globalThis.Date.prototype.toTemporalInstant;
|
||||
} else {
|
||||
// Removes the obsoleted `Temporal` API.
|
||||
// https://github.com/tc39/proposal-temporal/pull/2895
|
||||
// https://github.com/tc39/proposal-temporal/pull/2914
|
||||
if (typeof Temporal.Instant.fromEpochSeconds === "undefined") {
|
||||
throw "V8 removes obsoleted Temporal API now, no need to delete them!";
|
||||
}
|
||||
delete Temporal.Instant.fromEpochSeconds;
|
||||
delete Temporal.Instant.fromEpochMicroseconds;
|
||||
delete Temporal.Instant.prototype.epochSeconds;
|
||||
delete Temporal.Instant.prototype.epochMicroseconds;
|
||||
delete Temporal.PlainDateTime.prototype.withPlainDate;
|
||||
delete Temporal.PlainDateTime.prototype.toPlainYearMonth;
|
||||
delete Temporal.PlainDateTime.prototype.toPlainMonthDay;
|
||||
delete Temporal.PlainTime.prototype.toPlainDateTime;
|
||||
delete Temporal.PlainTime.prototype.toZonedDateTime;
|
||||
delete Temporal.TimeZone.prototype.getNextTransition;
|
||||
delete Temporal.TimeZone.prototype.getPreviousTransition;
|
||||
delete Temporal.ZonedDateTime.prototype.withPlainDate;
|
||||
delete Temporal.ZonedDateTime.prototype.toPlainYearMonth;
|
||||
delete Temporal.ZonedDateTime.prototype.toPlainMonthDay;
|
||||
delete Temporal.Now.zonedDateTime;
|
||||
delete Temporal.Now.plainDateTime;
|
||||
delete Temporal.Now.plainDate;
|
||||
}
|
||||
|
||||
// Setup `Deno` global - we're actually overriding already existing global
|
||||
|
|
@ -1008,6 +1032,30 @@ function bootstrapWorkerRuntime(
|
|||
// Removes the `Temporal` API.
|
||||
delete globalThis.Temporal;
|
||||
delete globalThis.Date.prototype.toTemporalInstant;
|
||||
} else {
|
||||
// Removes the obsoleted `Temporal` API.
|
||||
// https://github.com/tc39/proposal-temporal/pull/2895
|
||||
// https://github.com/tc39/proposal-temporal/pull/2914
|
||||
if (typeof Temporal.Instant.fromEpochSeconds === "undefined") {
|
||||
throw "V8 removes obsoleted Temporal API now, no need to delete them!";
|
||||
}
|
||||
delete Temporal.Instant.fromEpochSeconds;
|
||||
delete Temporal.Instant.fromEpochMicroseconds;
|
||||
delete Temporal.Instant.prototype.epochSeconds;
|
||||
delete Temporal.Instant.prototype.epochMicroseconds;
|
||||
delete Temporal.PlainDateTime.prototype.withPlainDate;
|
||||
delete Temporal.PlainDateTime.prototype.toPlainYearMonth;
|
||||
delete Temporal.PlainDateTime.prototype.toPlainMonthDay;
|
||||
delete Temporal.PlainTime.prototype.toPlainDateTime;
|
||||
delete Temporal.PlainTime.prototype.toZonedDateTime;
|
||||
delete Temporal.TimeZone.prototype.getNextTransition;
|
||||
delete Temporal.TimeZone.prototype.getPreviousTransition;
|
||||
delete Temporal.ZonedDateTime.prototype.withPlainDate;
|
||||
delete Temporal.ZonedDateTime.prototype.toPlainYearMonth;
|
||||
delete Temporal.ZonedDateTime.prototype.toPlainMonthDay;
|
||||
delete Temporal.Now.zonedDateTime;
|
||||
delete Temporal.Now.plainDateTime;
|
||||
delete Temporal.Now.plainDate;
|
||||
}
|
||||
|
||||
// Setup `Deno` global - we're actually overriding already existing global
|
||||
|
|
|
|||
Loading…
Reference in a new issue