共计 4312 个字符,预计需要花费 11 分钟才能阅读完成。
日期
日期 对象提供了一组用于管理日期和时间的条件和表达式。
例如,要查看日期对象的示例,可以打开 日期和时间示例。
脚本编写
这个对象没有脚本接口,因为在使用 JavaScript 或 TypeScript 编程时,你可以使用浏览器内置的 Date 对象。
时间戳
日期对象主要与时间戳一起工作。时间戳是自 1970 年 1 月 1 日(也称为 Unix 纪元)以来的毫秒数,不受时区或闰秒的影响。这是在软件开发中可靠地引用特定时间点的标准方式,有时也被称为 Unix 时间。
时间戳只是一个数字,这使得它们易于存储在现有变量中或像其他任何数字一样进行比较。然而,由于它只是一个单一的巨大数字,人类很难理解时间戳。日期对象提供了在时间戳和人类可读的日期和时间之间转换的表达式以及其他相关工具。
日期和时间部分
时间戳由以下部分组成,所有部分也都是数字,具有以下范围和起始点:
- 年份:四位完整年份,例如 2020
- 月份 : 基于零的 日历月份,例如 0 代表一月,5 代表六月
- 日期:日历日期,即月份中的日,从 1 到 31
- 星期:基于零的星期日,从 0 到 6,例如 2 代表星期二
- 小时:时间的小时数,0 到 23
- 分钟:时间的分钟数,0 到 59
- 秒钟:时间的秒数,0 到 59
- 毫秒:时间的毫秒数,0 到 999
日期条件
比较时间戳:
比较两个时间戳。相等的时间戳指的是相同的时间,小于另一个时间戳的时间戳在时间上先于它。
比较日期字符串:
比较两个日期字符串。日期字符串在比较之前转换为它们对应的数字时间戳。
比较时间戳部分:
比较两个时间戳部分。可能的部分有年份(四位)、月份(0-11)、日期(1-31)、星期(0-6)、小时(0-23)、分钟(0-59)、秒(0-59)和毫秒(0-999)。
比较日期字符串部分:
比较两个日期字符串部分,它们在比较之前转换为它们对应的数字时间戳。可能的部分有年份(四位)、月份(0-11)、日期(1-31)、星期(0-6)、小时(0-23)、分钟(0-59)、秒(0-59)和毫秒(0-999)。
日期表达式
ToString(timeStamp):
将时间戳转换为包括日期和时间的字符串表示。
ToDateString(timeStamp):
将时间戳转换为显示相应日期的字符串。
ToTimeString(timeStamp):
将时间戳转换为显示相应时间的字符串。
ToLocaleString(timeStamp):
将时间戳转换为包括日期和时间的本地化字符串表示。
ToLocaleDateString(timeStamp):
将时间戳转换为显示相应日期的本地化字符串。
ToLocaleTimeString(timeStamp):
将时间戳转换为显示相应时间的本地化字符串。
ToUTCString(timeStamp):
将时间戳转换为包括日期和时间的通用时间字符串表示。
Parse(dateString):
将日期字符串解析为相应的数字时间戳。支持的字符串格式,请参考MDN 文档中 Date.parse(),这是此表达式使用的基础方法。
ToTimerHours(milliseconds):
将毫秒转换为在计时器中显示的小时数。
ToTimerMinutes(milliseconds):
将毫秒转换为在计时器中显示的分钟数(0-59)。
ToTimerSeconds(milliseconds):
将毫秒转换为在计时器中显示的秒数(0-59)。
ToTimerMilliseconds(milliseconds):
将毫秒转换为在计时器中显示的毫秒数(0-999)。
ToTotalHours(milliseconds):
将毫秒转换为等价的小时数,可能是分数值。
ToTotalMinutes(milliseconds):
将毫秒转换为等价的分钟数,可能是分数值。
ToTotalSeconds(milliseconds):
将毫秒转换为等价的秒数,可能是分数值。
Now:
获取当前时间戳(自 1970 年 1 月 1 日以来的毫秒数)。
Get(year, month, day, hours, minutes, seconds, milliseconds):
通过提供日期和时间的各个部分来返回一个时间戳。
TimezoneOffset:
获取本地系统的时区偏移。
GetYear(timeStamp):
从提供的时间戳中提取四位年份(本地时间)。
GetUTCYear(timeStamp):
从提供的时间戳中提取四位年份(通用时间)。
GetMonth(timeStamp):
从提供的时间戳中提取月份(0-11,本地时间)。
GetUTCMonth(timeStamp):
从提供的时间戳中提取月份(0-11,通用时间)。
GetDate(timeStamp):
从提供的时间戳中提取日期(1-31,本地时间)。
GetUTCDate(timeStamp):
从提供的时间戳中提取日期(1-31,通用时间)。
GetDay(timeStamp):
从提供的时间戳中提取星期(0-6,本地时间)。
GetUTCDay(timeStamp):
从提供的时间戳中提取星期(0-6,通用时间)。
GetHours(timeStamp):
从提供的时间戳中提取小时数(0-23,本地时间)。
GetUTCHours(timeStamp):
从提供的时间戳中提取小时数(0-23,通用时间)。
GetMinutes(timeStamp):
从提供的时间戳中提取分钟数(0-59,本地时间)。
GetUTCMinutes(timeStamp):
从提供的时间戳中提取分钟数(0-59,通用时间)。
GetSeconds(timeStamp):
从提供的时间戳中提取秒数(0-59,本地时间)。
GetUTCSeconds(timeStamp):
从提供的时间戳中提取秒数(0-59,通用时间)。
GetUTCMilliseconds(timeStamp):
从提供的时间戳中提取毫秒数(0-999,本地时间)。
GetMilliseconds(timeStamp):
从提供的时间戳中提取毫秒数(0-999,通用时间)。
Difference(first, second):
计算两个时间戳之间的差异。
ChangeYear(timeStamp, year):
更改提供的时间戳中的年份(四位)为本地时间,并返回新的时间戳。
ChangeUTCYear(timeStamp, year):
更改提供的时间戳中的年份(四位)为通用时间,并返回新的时间戳。
ChangeMonth(timeStamp, month):
更改提供的时间戳中的月份(0-11)为本地时间,并返回新的时间戳。
ChangeUTCMonth(timeStamp, month):
更改提供的时间戳中的月份(0-11)为通用时间,并返回新的时间戳。
ChangeDate(timeStamp, date):
更改提供的时间戳中的日期(1-31)为本地时间,并返回新的时间戳。
ChangeUTCDate(timeStamp, date):
更改提供的时间戳中的日期(1-31)为通用时间,并返回新的时间戳。
ChangeDay(timeStamp, day):
更改提供的时间戳中的星期(0-6)为本地时间,并返回新的时间戳。
ChangeUTCDay(timeStamp, day):
更改提供的时间戳中的星期(0-6)为通用时间,并返回新的时间戳。
ChangeHours(timeStamp, hours):
更改提供的时间戳中的小时数(0-23)为本地时间,并返回新的时间戳。
ChangeUTCHours(timeStamp, hours):
更改提供的时间戳中的小时数(0-23)为通用时间,并返回新的时间戳。
ChangeMinutes(timeStamp, minutes):
更改提供的时间戳中的分钟数(0-59)为本地时间,并返回新的时间戳。
ChangeUTCMinutes(timeStamp, minutes):
更改提供的时间戳中的分钟数(0-59)为通用时间,并返回新的时间戳。
ChangeSeconds(timeStamp, seconds):
更改提供的时间戳中的秒数(0-59)为本地时间,并返回新的时间戳。
ChangeUTCSeconds(timeStamp, seconds):
更改提供的时间戳中的秒数(0-59)为通用时间,并返回新的时间戳。
ChangeMilliseconds(timeStamp, milliseconds):
更改提供的时间戳中的毫秒数(0-999)为本地时间,并返回新的时间戳。
ChangeUTCMilliseconds(timeStamp, milliseconds):
更改提供的时间戳中的毫秒数(0-999)为通用时间,并返回新的时间戳。
FormatDateWithStyles(locale, timeStamp, dateStyle, timeStyle, hourFormat):
使用区域设置和可选样式格式化提供的时戳。"dateStyle" 可以是 "full"、"long"、"medium" 或 "short",并影响最终结果中的日期部分,如果使用不受支持的值,则最终输出的表达式中将省略日期部分。"timeStyle" 可以是 "full"、"long"、"medium" 或 "short",并影响最终结果中的时间部分,如果使用不受支持的值,则最终输出的表达式中将省略时间部分。"hourFormat" 可以是 "12" 或 "24",并影响最终结果中时间部分的格式,如果使用不受支持的值,则最终结果将依赖于区域设置。
FormatDateWithComponents(locale, timeStamp, weekday, year, month, day, hour, minute, second, hourFormat):
使用区域设置和可选组件格式化提供的时间戳。"weekday" 可以是 "long"、"short" 或 "narrow"。"year" 可以是 "numeric" 或 "2-digit"。"month" 可以是 "numeric"、"2-digit"、"long"、"short" 或 "narrow"。"day" 可以是 "numeric" 或 "2-digit"。"hour" 可以是 "numeric" 或 "2-digit"。"minute" 可以是 "numeric" 或 "2-digit"。"second" 可以是 "numeric" 或 "2-digit"。"hourFormat" 可以是 "12" 或 "24",并影响最终结果中时间部分的格式,如果使用不受支持的值,则最终结果将依赖于区域设置。任何组件都可以通过提供不受支持的值从最终结果中省略。