【知识点31】常用日期函数

以当前日期2022年4月14日星期四为例。

01 常用日期函数

（1）Now

根据计算机系统设定的日期和时间返回当前的日期和时间值。

GMT(Greenwich Mean Time)代表格林尼治标准时间。

China Standard Time UT+8:00中国

在“插入变量或函数…”中，设置Now函数“[[Now]]”，返回“Thu Apr 14 2022 13:46:29 GMT+0800 (中国标准时间)”。

（2）GenDate

根据计算机系统设定的日期和时间返回当前原型生成时的日期和时间值。

在“插入变量或函数…”中，设置GenDate函数“[[GenDate]]”，返回“Thu Apr 14 2022 13:48:16 GMT+0800 (中国标准时间)”。

（3）getFullYear()函数

获取日期对象“年份”部分四位数字。

在“插入变量或函数…”中，设置getFullYear函数“[[Now.getFullYear()]]”，返回“2022”。

（4）getMonth()函数

获取日期对象“月份”部分的数值(1~12)。

在“插入变量或函数…”中，设置getMonth函数“[[Now.getMonth()]]”，返回“4”。

（5）getDate()函数

获取日期对象返回一个月中的日期的数字(1~31)。

在“插入变量或函数…”中，设置getDate函数“[[Now.getDate()]]”，返回“14”。

（6）getDay()函数

获取日期对象返回表示星期的某一天的数字(0~6)。

返回值是0（周日）到6（周六）之间的一个整数。

在“插入变量或函数…”中，设置getDay函数“[[Now.getDay()]]”，返回“4”。

（7）getHours()函数

获取日期对象“小时”部分数字(0~23)。

在“插入变量或函数…”中，设置getHours函数“[[Now.getHours()]]”，返回“14”。

（8）getMinutes()函数

获取日期对象“分钟”部分数值(0~59)。

在“插入变量或函数…”中，设置getMinutes函数“[[Now.getMinutes()]]”，返回“9”。

（9）getSeconds()函数

获取日期对象“秒数”部分数值(0~59)。

在“插入变量或函数…”中，设置getSeconds函数“[[Now.getSeconds()]]”，返回“31”。

（10）getTime()函数

获取当前日期对象中的时间值。该时间值表示从1970年1月1日00:00:00开始，到当前日期对象时，所经过的毫秒数，以格林威治时间为准。

在“插入变量或函数…”中，设置getTime函数“[[Now.getTime()]]”，返回“1649917024944”。

getTime()函数与valueOf()函数类似。

（11）toDateString()函数

可把Date对象的日期部分转换为字符串，并返回结果。

在“插入变量或函数…”中，设置toDateString函数“[[Now.toDateString()]]”，返回“Thu Apr 14 2022”。

（12）toTimeString()函数

把Date对象的时间部分转换为字符串，并返回结果。

在“插入变量或函数…”中，设置toTimeString函数“[[Now.toTimeString()]]”，返回“15:05:32 GMT+0800 (中国标准时间)”。

（13）toLocaleDateString()函数

以字符串的形式获取本地化当前日期对象，并且只包含“年月日”部分的短日期信息。

在“插入变量或函数…”中，设置toLocaleDateString函数“[[Now.toLocaleDateString()]]”，返回“2022/4/14”。

（14）toLocaleTimeString()函数

以字符串的形式获取本地化当前日期对象，并且只包含“时分秒”部分的短日期信息。

在“插入变量或函数…”中，设置toLocaleTimeString函数“[[Now.toLocaleTimeString()]]”，返回“15:00:48”。

（15）toLocaleString()函数

根据本地时间把Date对象转换为字符串，并返回结果，包含“年月日时分秒”。

在“插入变量或函数…”中，设置toLocaleString函数“[[Now.toLocaleString()]]”，返回“2022/4/14 15:03:24”。

（16）valueOf()函数

获取当前日期对象的原始值。从1970年1月1日至date对象的毫秒数。

在“插入变量或函数…”中，设置valueOf函数“[[Now.valueOf()]]”，返回“1649920322872”。

valueOf()函数与getTime()函数类似。

（17）addYears(years)函数

将指定的年份数加到当前日期对象上，获取一个新的日期对象。参数：years为整数数值，正负均可。

在“插入变量或函数…”中，设置addYears函数“[[Now.addYears(years)]]”（“[[Now.addYears(2)]]”），返回“Sun Apr 14 2024 15:27:07 GMT+0800 (中国标准时间)”。

（18）addMonths(months)函数

将指定的月份数加到当前日期对象上，获取一个新的日期对象。参数：months为整数数值，正负均可。

在“插入变量或函数…”中，设置addMonths函数“[[Now.addMonths(months)]]”（“[[Now.addMonths(2)]]”），返回“Tue Jun 14 2022 15:29:16 GMT+0800 (中国标准时间)”。

（19）addDays(days)函数

将指定的天数加到当前日期对象上，获取一个新的日期对象。参数：days为整数数值，正负均可。

在“插入变量或函数…”中，设置addDays函数“[[Now.addDays(days)]]”（“[[Now.addDays(2)]]”），返回“Sat Apr 16 2022 15:31:14 GMT+0800 (中国标准时间)”。

（20）addHours(hours)函数

将指定的小时数加到当前日期对象上，获取一个新的日期对象。参数：hours为整数数值，正负均可。

在“插入变量或函数…”中，设置addHours函数“[[Now.addHours(hours)]]”（“[[Now.addHours(2)]]”），返回“Thu Apr 14 2022 17:35:03 GMT+0800 (中国标准时间)”。

（21）addMinutes(minutes)函数

将指定的分钟数加到当前日期对象上，获取一个新的日期对象。参数：minutes为整数数值，正负均可。

在“插入变量或函数…”中，设置addMinutes函数“[[Now.addMinutes(minutes)]]”（“[[Now.addMinutes(2)]]”），返回“Thu Apr 14 2022 15:38:03 GMT+0800 (中国标准时间)”。

（22）addSeconds(seconds)函数

将指定的秒数加到当前日期对象上，获取一个新的日期对象。参数：seconds为整数数值，正负均可。

在“插入变量或函数…”中，设置addSeconds函数“[[Now.addSeconds(seconds)]]”（“[[Now.addSeconds(2)]]”），返回“Thu Apr 14 2022 15:37:15 GMT+0800 (中国标准时间)”。

02 其他日期函数

（1）getMonthName()函数

获取日期对象“月份”部分的英文名称。

“[[Now.getMonthName()]]”返回“April”。

（2）getDayOfWeek()函数

获取日期对象返回表示星期的某一天的名称（英文）。

“[[Now.getDayOfWeek()]]”返回“Thursday”。

（3）getMilliseconds()函数

获取日期对象的毫秒数(0~999)。

“[[Now.getMilliseconds()]]”返回“950”。

（4）getTimezoneOffset()函数

获取世界标准时间(UTC)与当前主机时间（本地时间）之间的分钟差值。

“[[Now.getTimezoneOffset()]]”返回“-480”。

（5）getUTCFullYear()函数

使用世界标准时间获取当前日期对象“年份”部分四位数值。

“[[Now.getUTCFullYear()]]”返回“2022”

（6）getUTCMonth()函数

使用世界标准时间获取当前日期对象“月份”部分的数值(1~12)。

“[[Now.getUTCMonth()]]”返回“3”

（7）getUTCDate()函数

使用世界标准时间获取当前日期对象返回一个月中的某一天(1~31)。

“[[Now.getUTCDate()]]”返回“14”。

（8）getUTCDay()函数

使用世界标准时间获取当前日期对象返回表示星期的一天的一个数字。(0~6)。

“[[Now.getUTCDay()]]”返回“4”

（9）getUTCHours()函数

使用世界标准时间获取当前日期对象“小时”部分数值(0~23)。

“[[Now.getUTCHours()]]”返回“6”。

（10）getUTCMinutes()函数

使用世界标准时间获取当前日期对象“分钟”部分数值(0~59)。

“[[Now.getUTCMinutes()]]”返回“37”

（11）getUTCSeconds()函数

使用世界标准时间获取当前日期对象“秒数”部分数值(0~59)。

“[[Now.getUTCSeconds()]]”返回“19”。

（12）getUTCMilliseconds()函数

使用世界标准时间获取当前日期对象的毫秒数(0~999)。

“[[Now.getUTCMilliseconds()]]”返回“310”。

（13）parse(datestring)函数

用于分析一个包含日期的字符串，并返回该日期与1970年1月1日00:00:00之间相差的毫秒数。

参数：datestring为日期格式的字符串，格式为：yyyy/mm/dd hh:mm:ss。

（14）toISOString()函数

以字符串值的形式返回采用ISO格式的日期，格式：YYYY-MM-DDTHH:mm:ss.sssZ。

“[[Now.toISOString()]]”返回“2022-04-14T06:55:26.229Z”。

（15）toJSON()函数

获取当前日期对象的JSON格式的日期字串，格式：YYYY-MM-DDTHH:mm:ss.sssZ。

“[[Now.toJSON()]]”返回“2022-04-14T06:56:59.831Z”。

（16）toUTCString()函数

根据世界时间(UTC)把Date对象转换为字符串，并返回结果。

“[[Now.toUTCString()]]”返回“Thu, 14 Apr 2022 07:07:02 GMT”。

（17）UTC(year,month,day,hour,min,sec,millisec) 函数

获取相对于1970年1月1日00:00:00的世界标准时间，与指定日期对象之间相差的毫秒数。参数：组成指定日期对象的年、月、日、时、分、秒以及毫秒的数值。

“[[Date.UTC(year,month,day,hour,min,sec,millisec)]]”

（18）addMilliseconds(ms)函数

将指定的毫秒数加到当前日期对象上，获取一个新的日期对象。参数：ms为整数数值，正负均可。

“[[Now.addMilliseconds(ms)]]”（“[[Now.addMilliseconds(2)]]”）返回“Thu Apr 14 2022 15:38:36 GMT+0800 (中国标准时间)”。

03 日期函数应用

（1）日期函数组合

在“插入变量或函数…”中，设置日期时间函数“[[Now.getFullYear()]]年[[Now.getMonth()]]月[[Now.getDate()]]日 [[Now.getHours()]]：[[Now.getMinutes()]]：[[Now.getSeconds()]]”，点击按钮后返回“2022年4月14日 20：37：23”。

返回结果

（2）时钟效果

在页面画布中放入动态面板（名称：jishi），在动态面板中添加2个状态（名称：xunhuan1~xunhuan2）。放入矩形元件（名称：shizhong）。

点击jishi动态面板，在“交互”功能面板中，打开“交互编辑器”。添加“载入时”事件。点击“设置面板状态”-选择jishi动态面板-在“state”中选择“下一项”，勾选“向后循环”,设置“循环间隔1000毫秒”。

添加“状态改变时”事件。点击“设置文本”-选择shizhong矩形元件，在“值”处点击“fx”,添加函数。在“插入变量或函数…”中，设置时间函数“[[Now.getHours()]]：[[Now.getMinutes()]]：[[Now.getSeconds()]]”。单击确定完成。

（3）倒计时效果

在页面画布中放入动态面板（名称：jishi），在动态面板中添加2个状态（名称：xunhuan1~xunhuan2）。放入矩形元件（名称：daojishi）。

点击jishi动态面板，在“交互”功能面板中，打开“交互编辑器”。添加“状态改变时”事件。点击“设置文本”-选择daojishi矩形元件，在“值”处点击“fx”, 取基准时间局部变量，添加函数。

倒计时效果

待续~