系统时间日期函数

客户端函数 - 系统时间日期函数API汇总。

增加时间间隔-DateAdd()

将时间加上一定的时间间隔，返回计算后的时间字符串。
参数与返回值:
名称
类型
描述
参数1
DateTime/String
时间(时间类型或满足时间格式的字符串类型)，格式为yyyy-MM-dd HH:mm:ss；
参数2
Number
增加的时间数；
参数3
String
时间数的单位，s-秒,m-分,H-时,d-日,M-月,y-年；
返回值
String
计算后的时间字符串；
示例及效果：
名称
描述
示例
DateAdd("2021-08-04 13:30:33",10,"m")
返回值
"2021-08-04 13:40:33"
效果

时间单位的相互转换-DateConvert()

将一时间的单位转换成另一种单位后的时间数。
参数与返回值:
名称
类型
描述
参数1
Number
时间数；
参数2
String
原时间的单位，s-秒,m-分,H-时,d-日；
参数3
String
目标时间的单位，s-秒,m-分,H-时,d-日；
返回值
Number
转换后的数值型时间数；
示例及效果：
名称
描述
示例
DateConvert(10,"s","m")
返回值
0.17
效果

求两个日期的时间间隔-Datediff()

返回两个日期之间的时间间隔。
参数与返回值:
名称
类型
描述
参数1
DateTime/String
原日期(时间类型或满足时间格式的字符串类型)；
参数2
DateTime/String
目标日期(时间类型或满足时间格式的字符串类型)；
参数3
String
差值的单位，s-秒,m-分,H-时,d-日；
返回值
Number
数值类型的时间间隔；注：时间间隔=目标日期-原日期。
示例及效果：
名称
描述
示例
Datediff("2021-08-04 13:30:33","2021-08-10 13:30:33","d")
返回值
6
效果

减去时间间隔-DateSub()

将时间减去一定的时间间隔，返回计算后的时间字符串。
参数与返回值:
名称
类型
描述
参数1
String
转换的日期(时间类型或满足时间格式的字符串类型)，格式为yyyy-MM-dd HH:mm:ss；
参数2
Number
减少的时间数；
参数3
String
时间数的单位，s-秒,m-分,H-时,d-日；
返回值
String
计算后的时间字符串；
示例及效果：
名称
描述
示例
DateSub("2021-08-04 13:30:33",10,"m")
返回值
"2021-08-04 13:20:33"
效果

当前日期时间-DateTimeNow()

返回服务器当前的日期和时间，格式为yyyy-MM-dd HH:mm:ss。
参数与返回值:
名称
类型
描述
参数
无参数；
返回值
String
返回服务器当前的日期和时间(时间字符串)。
示例及效果：
名称
描述
示例
DateTimeNow()
返回值
"2021-08-04 13:20:33"
效果

根据日期时间转成时间戳-DateTimeToUnixtimestamp()

根据日期时间转成时间戳。
参数与返回值:
名称
类型
描述
参数1
String
日期时间值；必填
返回值
String
时间戳；
示例及效果：
名称
描述
示例
DateTimeToUnixtimestamp("2019-08-05 13:30:33")
返回值
"1626933677"
效果

将时间格式化为字符串-DateToString()

根据指定格式，将时间格式化为字符串返回。
参数与返回值:
名称
类型
描述
参数1
String
格式串；
参数2
DateTime/String
时间(时间类型或满足时间格式的字符串类型)；
返回值
String
时间字符串；
示例及效果：
名称
描述
示例
DateToString("yyyy-MM-dd",DateTimeNow())
返回值
"2021-08-04"
效果

获取日期的某一部分-GetDateSection()

获取日期的某一部分返回。
参数与返回值:
名称
类型
描述
参数1
String/DateTime
给定的日期(时间类型或满足时间格式的字符串类型)，格式yyyy-MM-dd或者yyyy-MM-dd HH:mm:ss；
参数2
Integer
指定要返回的日期部分：0:全部，1:年，2：月，3：日，4：小时，6：分，7：秒；9：星期；
返回值
String
日期的某一部分(字符串)；
示例及效果：
名称
描述
示例
GetDateSection("2021-08-04 13:39:21",2)
返回值
"08"
效果

取客户端当前日期-LocateDateTimeNow()

获取客户端当前的日期时间，并格式化为字符串返回，格式为 yyyy-MM-dd HH:mm:ss。
参数与返回值:
名称
类型
描述
参数
无参数；
返回值
String
当前客户端的时间字符串；
示例及效果：
名称
描述
示例
LocateDateTimeNow()
返回值
"2021-08-04 13:47:32"
效果

短日期-ShortDateNow()

返回服务器当前时间的短日期格式，格式为yyyy-MM-dd。
参数与返回值:
名称
类型
描述
参数
无参数；
返回值
String
服务器当前时间的短日期格式；
示例及效果：
名称
描述
示例
ShortDateNow()
返回值
"2021-08-04"
效果

短时间-ShortTimeNow()

返回服务器当前时间的短时间格式，格式为HH:mm。
参数与返回值:
名称
类型
描述
参数1
无
无参数；
返回值
String
服务器当前时间的短时间格式；
示例及效果：
名称
描述
示例
ShortTimeNow()
返回值
"13:39"
效果

根据时间戳转成日期时间-UnixtimestampToDateTime()

根据时间戳转成日期时间。
参数与返回值:
名称
类型
描述
参数1
String
时间戳,单位是秒；必填
参数2
String
日期时间格式;
格式例如:yyyy-MM-dd HH:mm:ss、yyyy/MM/dd HH:mm:ss、yyyy年MM月dd日 HH时mm分ss秒;
默认格式:yyyy-MM-dd HH:mm:ss；
返回值
String
时间字符串；
示例及效果：
名称
描述
示例
UnixtimestampToDateTime("1535444053","yyyy-MM-dd")
返回值
"2018-08-28"
效果