前言
ECMAScript 2021 中新增了一个 Temporal 对象，用于处理日期和时间相关的操作。该对象提供了一系列的 API，使得日期和时间的操作更加方便和易于理解。本文将详细介绍 Temporal 对象，并提供使用示例。
Temporal 对象简介
Temporal 对象是一个全新的对象，它提供了一系列的 API，用于处理日期和时间相关的操作。它的设计初衷是为了解决 JavaScript 中日期和时间相关 API 的不足和不一致性。Temporal 对象的 API 设计更加直观和易于理解，同时也提供了更多的功能。
Temporal 对象不仅可以处理日期和时间，还包括时区、日历等相关的操作。它的设计是基于现代化的日期和时间标准，可以处理包括闰年、夏令时等在内的复杂情况，同时也支持多种语言环境。
Temporal 对象的使用
创建 Temporal 对象
Temporal 对象的创建非常简单，只需要使用 Temporal 对象即可。例如：
const temporal = new Temporal();
Temporal.Date
Temporal.Date 对象用于处理日期相关的操作，包括年、月、日等。它的 API 设计更加直观和易于理解，同时也提供了更多的功能。
创建 Temporal.Date 对象
创建 Temporal.Date 对象有两种方式，一种是使用 Temporal.Date.from() 方法，另一种是使用 Temporal.Now.date() 方法。
// 使用 from() 方法创建 Temporal.Date 对象
const date1 = Temporal.Date.from('2022-01-01');
// 使用 Now.date() 方法创建 Temporal.Date 对象
const date2 = Temporal.Now.date();获取 Temporal.Date 对象的属性值
Temporal.Date 对象有多个属性，包括年、月、日等。可以使用 get() 方法获取属性值。
const date = Temporal.Now.date();
console.log(date.get('year')); // 获取年份
console.log(date.get('month')); // 获取月份
console.log(date.get('day')); // 获取日期修改 Temporal.Date 对象的属性值
Temporal.Date 对象的属性值可以使用 with() 方法进行修改。
const date = Temporal.Now.date();
const newDate = date.with({ year: 2022, month: 2, day: 1 });
console.log(newDate.toString()); // 输出：2022-02-01Temporal.Time
Temporal.Time 对象用于处理时间相关的操作，包括时、分、秒、毫秒等。它的 API 设计更加直观和易于理解，同时也提供了更多的功能。
创建 Temporal.Time 对象
创建 Temporal.Time 对象有两种方式，一种是使用 Temporal.Time.from() 方法，另一种是使用 Temporal.Now.time() 方法。
// 使用 from() 方法创建 Temporal.Time 对象
const time1 = Temporal.Time.from('10:30:00');
// 使用 Now.time() 方法创建 Temporal.Time 对象
const time2 = Temporal.Now.time();获取 Temporal.Time 对象的属性值
Temporal.Time 对象有多个属性，包括时、分、秒、毫秒等。可以使用 get() 方法获取属性值。
const time = Temporal.Now.time();
console.log(time.get('hour')); // 获取小时
console.log(time.get('minute')); // 获取分钟
console.log(time.get('second')); // 获取秒
console.log(time.get('millisecond')); // 获取毫秒修改 Temporal.Time 对象的属性值
Temporal.Time 对象的属性值可以使用 with() 方法进行修改。
const time = Temporal.Now.time();
const newTime = time.with({ hour: 11, minute: 30, second: 0, millisecond: 0 });
console.log(newTime.toString()); // 输出：11:30:00Temporal.DateTime
Temporal.DateTime 对象用于处理日期和时间相关的操作，包括年、月、日、时、分、秒、毫秒等。它的 API 设计更加直观和易于理解，同时也提供了更多的功能。
创建 Temporal.DateTime 对象
创建 Temporal.DateTime 对象有两种方式，一种是使用 Temporal.DateTime.from() 方法，另一种是使用 Temporal.Now.dateTime() 方法。
// 使用 from() 方法创建 Temporal.DateTime 对象
const dateTime1 = Temporal.DateTime.from('2022-01-01T10:30:00');
// 使用 Now.dateTime() 方法创建 Temporal.DateTime 对象
const dateTime2 = Temporal.Now.dateTime();获取 Temporal.DateTime 对象的属性值
Temporal.DateTime 对象有多个属性，包括年、月、日、时、分、秒、毫秒等。可以使用 get() 方法获取属性值。
const dateTime = Temporal.Now.dateTime();
console.log(dateTime.get('year')); // 获取年份
console.log(dateTime.get('month')); // 获取月份
console.log(dateTime.get('day')); // 获取日期
console.log(dateTime.get('hour')); // 获取小时
console.log(dateTime.get('minute')); // 获取分钟
console.log(dateTime.get('second')); // 获取秒
console.log(dateTime.get('millisecond')); // 获取毫秒修改 Temporal.DateTime 对象的属性值
Temporal.DateTime 对象的属性值可以使用 with() 方法进行修改。
const dateTime = Temporal.Now.dateTime();
const newDateTime = dateTime.with({ year: 2022, month: 2, day: 1, hour: 11, minute: 30, second: 0, millisecond: 0 });
console.log(newDateTime.toString()); // 输出：2022-02-01T11:30:00Temporal.Duration
Temporal.Duration 对象用于表示时间间隔，例如两个日期之间的间隔。它的 API 设计更加直观和易于理解，同时也提供了更多的功能。
创建 Temporal.Duration 对象
创建 Temporal.Duration 对象有两种方式，一种是使用 Temporal.Duration.from() 方法，另一种是使用 Temporal.Now.duration() 方法。
// 使用 from() 方法创建 Temporal.Duration 对象
const duration1 = Temporal.Duration.from('PT1H30M');
// 使用 Now.duration() 方法创建 Temporal.Duration 对象
const duration2 = Temporal.Now.duration();获取 Temporal.Duration 对象的属性值
Temporal.Duration 对象有多个属性，包括小时、分钟、秒、毫秒等。可以使用 get() 方法获取属性值。
const duration = Temporal.Duration.from('PT1H30M');
console.log(duration.get('hours')); // 获取小时
console.log(duration.get('minutes')); // 获取分钟
console.log(duration.get('seconds')); // 获取秒
console.log(duration.get('milliseconds')); // 获取毫秒修改 Temporal.Duration 对象的属性值
Temporal.Duration 对象的属性值可以使用 with() 方法进行修改。
const duration = Temporal.Duration.from('PT1H30M');
const newDuration = duration.with({ hours: 2, minutes: 0, seconds: 0, milliseconds: 0 });
console.log(newDuration.toString()); // 输出：PT2HTemporal.PlainDate
Temporal.PlainDate 对象用于表示日期，不包括时间和时区信息。它的 API 设计更加直观和易于理解，同时也提供了更多的功能。
创建 Temporal.PlainDate 对象
创建 Temporal.PlainDate 对象有两种方式，一种是使用 Temporal.PlainDate.from() 方法，另一种是使用 Temporal.Now.plainDate() 方法。
// 使用 from() 方法创建 Temporal.PlainDate 对象
const plainDate1 = Temporal.PlainDate.from('2022-01-01');
// 使用 Now.plainDate() 方法创建 Temporal.PlainDate 对象
const plainDate2 = Temporal.Now.plainDate();获取 Temporal.PlainDate 对象的属性值
Temporal.PlainDate 对象有多个属性，包括年、月、日等。可以使用 get() 方法获取属性值。
const plainDate = Temporal.Now.plainDate();
console.log(plainDate.get('year')); // 获取年份
console.log(plainDate.get('month')); // 获取月份
console.log(plainDate.get('day')); // 获取日期修改 Temporal.PlainDate 对象的属性值
Temporal.PlainDate 对象的属性值可以使用 with() 方法进行修改。
const plainDate = Temporal.Now.plainDate();
const newPlainDate = plainDate.with({ year: 2022, month: 2, day: 1 });
console.log(newPlainDate.toString()); // 输出：2022-02-01Temporal.PlainTime
Temporal.PlainTime 对象用于表示时间，不包括日期和时区信息。它的 API 设计更加直观和易于理解，同时也提供了更多的功能。
创建 Temporal.PlainTime 对象
创建 Temporal.PlainTime 对象有两种方式，一种是使用 Temporal.PlainTime.from() 方法，另一种是使用 Temporal.Now.plainTime() 方法。
// 使用 from() 方法创建 Temporal.PlainTime 对象
const plainTime1 = Temporal.PlainTime.from('10:30:00');
// 使用 Now.plainTime() 方法创建 Temporal.PlainTime 对象
const plainTime2 = Temporal.Now.plainTime();获取 Temporal.PlainTime 对象的属性值
Temporal.PlainTime 对象有多个属性，包括时、分、秒、毫秒等。可以使用 get() 方法获取属性值。
const plainTime = Temporal.Now.plainTime();
console.log(plainTime.get('hour')); // 获取小时
console.log(plainTime.get('minute')); // 获取分钟
console.log(plainTime.get('second')); // 获取秒
console.log(plainTime.get('millisecond')); // 获取毫秒修改 Temporal.PlainTime 对象的属性值
Temporal.PlainTime 对象的属性值可以使用 with() 方法进行修改。
const plainTime = Temporal.Now.plainTime();
const newPlainTime = plainTime.with({ hour: 11, minute: 30, second: 0, millisecond: 0 });
console.log(newPlainTime.toString()); // 输出：11:30:00Temporal.PlainDateTime
Temporal.PlainDateTime 对象用于表示日期和时间，不包括时区信息。它的 API 设计更加直观和易于理解，同时也提供了更多的功能。
创建 Temporal.PlainDateTime 对象
创建 Temporal.PlainDateTime 对象有两种方式，一种是使用 Temporal.PlainDateTime.from() 方法，另一种是使用 Temporal.Now.plainDateTime() 方法。
// 使用 from() 方法创建 Temporal.PlainDateTime 对象
const plainDateTime1 = Temporal.PlainDateTime.from('2022-01-01T10:30:00');
// 使用 Now.plainDateTime() 方法创建 Temporal.PlainDateTime 对象
const plainDateTime2 = Temporal.Now.plainDateTime();获取 Temporal.PlainDateTime 对象的属性值
Temporal.PlainDateTime 对象有多个属性，包括年、月、日、时、分、秒、毫秒等。可以使用 get() 方法获取属性值。
const plainDateTime = Temporal.Now.plainDateTime();
console.log(plainDateTime.get('year')); // 获取年份
console.log(plainDateTime.get('month')); // 获取月份
console.log(plainDateTime.get('day')); // 获取日期
console.log(plainDateTime.get('hour')); // 获取小时
console.log(plainDateTime.get('minute')); // 获取分钟
console.log(plainDateTime.get('second')); // 获取秒
console.log(plainDateTime.get('millisecond')); // 获取毫秒修改 Temporal.PlainDateTime 对象的属性值
Temporal.PlainDateTime 对象的属性值可以使用 with() 方法进行修改。
const plainDateTime = Temporal.Now.plainDateTime();
const newPlainDateTime = plainDateTime.with({ year: 2022, month: 2, day: 1, hour: 11, minute: 30, second: 0, millisecond: 0 });
console.log(newPlainDateTime.toString()); // 输出：2022-02-01T11:30:00Temporal.TimeZone
Temporal.TimeZone 对象用于表示时区信息。它的 API 设计更加直观和易于理解，同时也提供了更多的功能。
创建 Temporal.TimeZone 对象
创建 Temporal.TimeZone 对象有两种方式，一种是使用 Temporal.TimeZone.from() 方法，另一种是使用 Temporal.Now.timeZone() 方法。
// 使用 from() 方法创建 Temporal.TimeZone 对象
const timeZone1 = Temporal.TimeZone.from('Asia/Shanghai');
// 使用 Now.timeZone() 方法创建 Temporal.TimeZone 对象
const timeZone2 = Temporal.Now.timeZone();获取 Temporal.TimeZone 对象的属性值
Temporal.TimeZone 对象有多个属性，包括时区名称、时差等。可以使用 get() 方法获取属性值。
const timeZone = Temporal.Now.timeZone();
console.log(timeZone.get('id')); // 获取时区名称
console.log(timeZone.getOffsetNanosecondsFor(Temporal.Now.instant())); // 获取当前时间的时差，单位为纳秒修改 Temporal.TimeZone 对象的属性值
Temporal.TimeZone 对象的属性值不支持修改。
Temporal.Calendar
Temporal.Calendar 对象用于表示日历信息。它的 API 设计更加直观和易于理解，同时也提供了更多的功能。
创建 Temporal.Calendar 对象
创建 Temporal.Calendar 对象有两种方式，一种是使用 Temporal.Calendar.from() 方法，另一种是使用 Temporal.Now.calendar() 方法。
// 使用 from() 方法创建 Temporal.Calendar 对象
const calendar1 = Temporal.Calendar.from('iso8601');
// 使用 Now.calendar() 方法创建 Temporal.Calendar 对象
const calendar2 = Temporal.Now.calendar();获取 Temporal.Calendar 对象的属性值
Temporal.Calendar 对象有多个属性，包括日历名称等。可以使用 get() 方法获取属性值。
const calendar = Temporal.Now.calendar();
console.log(calendar.get('id')); // 获取日历名称修改 Temporal.Calendar 对象的属性值
Temporal.Calendar 对象的属性值不支持修改。
总结
Temporal 对象是 ECMAScript 2021 中新增的一个对象，用于处理日期和时间相关的操作。它的 API 设计更加直观和易于理解，同时也提供了更多的功能。本文详细介绍了 Temporal 对象及其相关 API 的使用，提供了多个使用示例。通过学习本文，你可以更加方便地处理日期和时间相关的操作，同时也可以了解到 JavaScript 中日期和时间相关 API 的不足和不一致性。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6613aef0d10417a22242930a