简介

日期（Date）提供关于日期的算子，包括但不限于获取当前时间、日期格式转换、时间差等。

Date

函数	返回值
Date(args)	Date

参数	类型	说明
args	String|Int	日期对象

示例

date = pie.Date('2020-01-01')
print(date.getInfo())

advance

获取与指定日期间隔某个时间段的日期。

函数	返回值
advance(delta,unit)	Date

参数	类型	说明
delta	Number	间隔日期
unit	String	单位值: - year - month（returns 1-12） - week（1-53） - day（1-31） - hour（0-23） - minute（0-59） - second（0-59)

示例

date = pie.Date.now()
date1 = date.advance(5,"year")
date2 = date.advance(10,"week")
print(date1.getInfo())
print(date2.getInfo())

difference

距离指定日期的时间数，单位参考unit。

函数	返回值
difference(start,unit)	Number

参数	类型	说明
start	Date	指定开始时间
unit	String	时间单位: - year - month - week - day - hour - minute - second

示例

date1 = pie.Date('2021-03-18')
date2 = pie.Date('2021-02-18')
print(date1.difference(date2, 'day').getInfo())

format

格式化日期。

函数	返回值
format(format)	String

参数	类型	说明
format	String	格式化样式

示例

date = pie.Date.now()
dateStr = date.format("yyyyMMdd")
print(dateStr.getInfo())

fromYMD

通过年月日构造日期。

函数	返回值
fromYMD(year,month,day)	Date

参数	类型	说明
year	Number	输入年份
month	Number	输入月份
day	Number	输入日

示例

date= pie.Date.fromYMD(2020,12,12)
print(date.getInfo())

get

获取日期。

函数	返回值
get(unit)	Number

参数	类型	说明
unit	String	单位值: - year - month（returns 1-12） - week（1-53） - day（1-31） - hour（0-23） - minute（0-59） - second（0-59)

示例

date1 = pie.Date('2021-05-01')
print(date1.get('year').getInfo())

millis

获取指定时间的毫秒数，起始时间是1970-01-01T00:00:00Z。

函数	返回值
millis()	Number

示例

date = pie.Date.now()
millis = date.millis()
print(millis.getInfo())

name

返回date名称。

函数	返回值
name()	String

示例

name = pie.Date.name()
print(name)

now

获取当前时间。

函数	返回值
now()	Date

示例

date= pie.Date.now()
print(date.getInfo())

parse

解析指定格式的字符串转为日期。

函数	返回值
parse(format,date)	Date

参数	类型	说明
format	String	字符串的格式
date	String	日期的字符串

示例

date = pie.Date.parse("yyyyMMdd","20200101")
print(date.getInfo())

toString

默认格式化日期。

函数	返回值
toString()	String

示例

date = pie.Date.now()
dateStr = date.toString()
print(dateStr.getInfo())