日期和时间函数_日志服务(SLS)-阿里云帮助中心

日志服务提供时间函数、日期函数、日期和时间提取函数、时间间隔函数和时序补全函数，支持对日志中的日期和时间进行格式转换，分组聚合等处理。本文介绍日期和时间函数的基本语法及示例。

日志服务支持如下日期和时间函数。

函数类型	函数名称	语法	说明	支持SQL	支持SPL
日期和时间函数	current_date函数	current_date	返回当前日期。	√	×
	current_time函数	current_time	返回当前时间和时区。	√	×
	current_timestamp函数	current_timestamp	返回当前日期、时间和时区。	√	×
	current_timezone函数	current_timezone()	返回当前时区。	√	×
	date函数	date( x )	返回日期和时间表达式中的日期部分。	√	×
	date_format函数	date_format( x , format )	将timestamp类型的日期和时间表达式转化为指定格式的日期和时间表达式。	√	√
	date_parse函数	date_parse( x , format )	将日期和时间字符串转换为指定格式的timestamp类型的日期和时间表达式。	√	√
	from_iso8601_date函数	from_iso8601_date( x )	将ISO8601格式的日期表达式转化为date类型的日期表达式。	√	×
	from_iso8601_timestamp函数	from_iso8601_timestamp( x )	将ISO8601格式的日期和时间表达式转化为timestamp类型的日期和时间表达式。	√	×
	from_unixtime函数	from_unixtime( x )	将UNIX时间戳转化为无时区的timestamp类型的日期和时间表达式。	√	√
		from_unixtime( x , time zone )	将UNIX时间戳转化为带时区的timestamp类型的日期和时间表达式。	√	×
		from_unixtime( x , hours , minutes )	将UNIX时间戳转化为带时区的timestamp类型的日期和时间表达式，其中 hours 和 minutes 为时区偏移量。	√	×
	localtime函数	localtime	返回本地时间。	√	×
	localtimestamp函数	localtimestamp	返回本地日期和时间。	√	×
	now函数	now()	返回当前日期和时间。 now函数等同于current_timestamp函数。	√	×
	to_iso8601函数	to_iso8601( x )	将date类型或timestamp类型的日期和时间表达式转换为ISO8601格式的日期和时间表达式。	√	×
	to_unixtime函数	to_unixtime( x )	将timestamp类型的日期和时间表达式转化成UNIX时间戳。	√	√
日期和时间提取函数	day函数	day( x )	提取日期和时间表达式中的天数，按月计算。 day函数等同于day_of_month函数。	√	×
	day_of_month函数	day_of_month( x )	提取日期和时间表达式中的天数，按月计算。 day_of_month函数等同于day函数。	√	×
	day_of_week函数	day_of_week( x )	提取日期和时间表达式中的天数，按周计算。 day_of_week函数等同于dow函数。	√	√
	day_of_year函数	day_of_year( x )	提取日期和时间表达式中的天数，按年计算。 day_of_year函数等同于doy函数。	√	√
	dow函数	dow( x )	提取日期和时间表达式中的天数，按周计算。 dow函数等同于day_of_week函数。	√	√
	doy函数	doy( x )	提取日期和时间表达式中的天数，按年计算。 doy函数等同于day_of_year函数。	√	√
	extract函数	extract( field from x )	通过指定的 field ，提取日期和时间表达式中的日期或时间部分。	√	×
	hour函数	hour( x )	提取日期和时间表达式中的小时数，按24小时制计算。	√	√
	minute函数	minute( x )	提取日期和时间表达式中的分钟数。	√	√
	month函数	month( x )	提取日期和时间表达式中的月份。	√	√
	quarter函数	quarter( x )	计算目标日期所属的季度。	√	√
	second函数	second( x )	提取日期和时间表达式中的秒数。	√	√
	timezone_hour函数	timezone_hour( x )	计算时区的小时偏移量。	√	×
	timezone_minute函数	timezone_minute( x )	计算时区的分钟偏移量。	√	×
	week函数	week( x )	计算目标日期是在一年中的第几周。 week函数等同于week_of_year函数。	√	×
	week_of_year函数	week_of_year( x )	计算目标日期是在一年中的第几周。 week_of_year函数等同于week函数。	√	×
	year函数	year( x )	提取目标日期中的年份。	√	√
	year_of_week函数	year_of_week( x )	提取目标日期在ISO周日历中的年份。 year_of_week函数等同于yow函数。	√	√
	yow函数	yow( x )	提取目标日期在ISO周日历中的年份。 yow函数等同于year_of_week函数。	√	√
时间间隔函数	date_trunc函数	date_trunc(unit, x )	根据您指定的时间单位截断日期和时间表达式，并按照毫秒、秒、分钟，小时、日、月或年对齐。	√	×
	date_add函数	date_add( unit , N , x )	在 x 上加上N个时间单位（unit）。	√	√
	date_diff函数	date_diff( unit , x , y )	返回两个时间表达式之间的时间差值，例如计算 x 和 y 之间相差几个时间单位（unit）。	√	√
时序补全函数	time_series函数	time_series( x , window , format , padding_data )	补全您查询时间窗口内缺失的数据。	√	×

current_date

* |
SELECT
FROM  log
WHERE
  __time__ < to_unixtime(current_date)
  AND __time__ > to_unixtime(date_add('day', -1, current_date))

current_time

```
* | select current_time
```

current_timestamp

* |
SELECT
FROM  log
WHERE
  __time__ < to_unixtime(current_timestamp)
  AND __time__ > to_unixtime(date_add('day', -1, current_timestamp))

current_timezone()

```
* | select current_timezone()
```

date(x)

参数	说明
x	参数值为date、timestamp类型。

* | SELECT current_timestamp, date(current_timestamp)

date_format(x, format)

参数	说明
x	参数值为timestamp类型的日期和时间表达式。
format	日期和时间表达式的转换格式。更多信息，请参见 format说明。

* |
SELECT
  date_format(date_trunc('minute', __time__), '%H:%i') AS time,
  COUNT(1) AS count,
  status
GROUP BY
  time,
  status
ORDER BY
  time

date_parse(x, format)

参数	说明
x	参数值为日期和时间字符串。
format	日期和时间表达式的转换格式。更多信息，请参见 format说明。

*|
SELECT
    date_parse(StartTime, '%Y-%m-%d %H:%i') AS "StartTime",
    date_parse(EndTime, '%Y-%m-%d %H:%i') AS "EndTime",
    date_diff('hour', StartTime, EndTime) AS "时间差(小时)"

from_iso8601_date(x)

参数	说明
x	参数值为ISO8601格式的日期表达式。

```
time:2020-05-03
```
```
* | select from_iso8601_date(time)
```

from_iso8601_timestamp(x)

参数	说明
x	参数值为ISO8601格式的日期和时间表达式。

```
time:2020-05-03T17:30:08
```
```
* | select from_iso8601_timestamp(time)
```

```
from_unixtime(x)
```
```
from_unixtime(x,time zone)
```
```
from_unixtime(x, hours, minutes)
```

参数	说明
x	参数值为UNIX时间戳。
time zone	时区，例如Asia/shanghai。
hours	时区的小时偏移量，例如+07、-09
minutes	时区的分钟偏移量，例如+30、-45。

```
time:1626774758
```

* | select from_unixtime(time,'Asia/shanghai')

localtime

```
* | select localtime
```

localtimestamp

* |
SELECT
FROM  log
WHERE
  __time__ < to_unixtime(localtimestamp)
  AND __time__ > to_unixtime(date_add('day', -1, localtimestamp))

now()

* |
SELECT
FROM  log
WHERE
  __time__ < to_unixtime(now())
  AND __time__ > to_unixtime(date_add('day', -1, now()))

to_iso8601(x)

参数	说明
x	参数值为date、timestamp类型。

* | select to_iso8601(current_timestamp) AS ISO8601

to_unixtime(x)

参数	说明
x	参数值为timestamp类型的日期和时间表达式。

* |
SELECT
FROM  log
WHERE
  __time__ < to_unixtime(now())
  AND __time__ > to_unixtime(date_add('day', -1, now()))

day(x)

参数	说明
x	参数值为timestamp、date类型。

* | SELECT current_date, day(current_date)

day_of_month(x)

参数	说明
x	参数值为timestamp、date类型。

* | SELECT current_date, day_of_month(current_date)

day_of_week(x)

参数	说明
x	参数值为timestamp、date类型。

* | SELECT current_date, day_of_week(current_date)

day_of_year(x)

参数	说明
x	参数值为timestamp、date类型。

* | SELECT current_date, day_of_year(current_date)

dow(x)

参数	说明
x	参数值为timestamp、date类型。

* | SELECT current_date, dow(current_date)

doy(x)

参数	说明
x	参数值为timestamp、date类型。

* | SELECT current_date, doy(current_date)

extract(field from x)

参数	说明
field	取值为year、quarter、month、week、day、day_of_month、day_of_week、dow、day_of_year、doy、year_of_week、yow、hour、minute、second、timezone_hour、timezone_minute。
x	参数值为date、time、timestamp、interval (actual varchar(9)) 类型。

* | SELECT extract(year from current_date)

hour(x)

参数	说明
x	参数值为timestamp类型。

* | SELECT current_timestamp, hour(current_timestamp)

minute(x)

参数	说明
x	参数值为timestamp类型。

* | SELECT current_timestamp, minute(current_timestamp)

month(x)

参数	说明
x	参数值为date、timestamp类型。

* | SELECT current_timestamp, month(current_timestamp)

quarter(x)

参数	说明
x	参数值为date、timestamp类型。

* | SELECT current_timestamp,quarter(current_timestamp)

second(x)

参数	说明
x	参数值为timestamp类型。

* | SELECT current_timestamp,second(current_timestamp)

timezone_hour(x)

参数	说明
x	参数值为timestamp类型。

* | SELECT current_timestamp, timezone_hour(current_timestamp)

timezone_minute(x)

参数	说明
x	参数值为timestamp类型。

* | SELECT current_timestamp,timezone_minute(current_timestamp)

week(x)

参数	说明
x	参数值为date、timestamp类型。

* | SELECT current_timestamp, week(current_timestamp)

week_of_year(x)

参数	说明
x	参数值为date、timestamp类型。

* | SELECT current_timestamp, week_of_year(current_timestamp)

year(x)

参数	说明
x	参数值为date、timestamp类型。

* | SELECT current_timestamp,year(current_timestamp)

year_of_week(x)

参数	说明
x	参数值为date、timestamp类型。

* | SELECT current_timestamp,year_of_week(current_timestamp)

yow(x)

参数	说明
x	参数值为date、timestamp类型。

* | SELECT current_timestamp, yow(current_timestamp)

date_trunc(unit, x)

参数	说明
unit	时间单位，取值为millisecond、second、minute、hour、day、week、month、quarter、year。更多信息，请参见 unit说明。
x	参数值为日期和时间表达式。

* |
SELECT
  date_trunc('minute', __time__) AS time,
  truncate (avg(request_time)) AS avg_time,
  current_date AS date
GROUP BY
ORDER BY
  time DESC
LIMIT
  100

date_add(unit, n, x)

参数	说明
unit	时间单位，取值为millisecond、second、minute、hour、day、week、month、quarter、year。更多信息，请参见 unit说明。
n	时间间隔。
x	参数值为timestamp类型日期和时间表达式。

* |
SELECT
FROM  log
WHERE
  __time__ < to_unixtime(current_timestamp)
  AND __time__ > to_unixtime(date_add('day', -1, current_timestamp))

date_diff(unit, x, y)

参数	说明
unit	时间单位，取值为millisecond、second、minute、hour、day、week、month、quarter、year。更多信息，请参见 unit说明。
x	参数值为timestamp类型日期和时间表达式。
y	参数值为timestamp类型日期和时间表达式。

* | SELECT  date_diff('hour', UsageStartTime, UsageEndTime) AS "时间差(小时)"

time_series(x, window_time, format, padding_data)

参数	说明
x	时间列，例如 `__time__` 。时间列的值为long类型或timestamp类型。
window_time	窗口大小，单位为s（秒）、m（分）、h（小时）、d（天）。例如2h、5m、3d。
format	返回结果的时间格式。更多信息，请参见 format说明。
padding_data	补全的内容。包括： 0：将缺失的值设置为0。 null：将缺失的值设置为null。 last：将缺失的值设置了上一个时间点对应的值。 next：将缺失的值设置了下一个时间点对应的值。 avg：将缺失的值设置为前后两个时间点的平均值。

* | select time_series(__time__, '2h', '%Y-%m-%d %H:%i:%s', '0')  as time, count(*) as num from log group by time order by time

format	说明
%a	星期的缩写。例如Sun、Sat。
%b	月份的缩写。例如Jan、Dec。
%c	月份。数值类型，取值范围为1~12。
%D	每月的第几天。需加上后缀，例如0th、1st、2nd、3rd。
%d	每月的第几天。十进制格式，取值范围为01~31。
%e	每月的第几天。十进制格式，取值范围为1~31。
%H	小时，24小时制。
%h	小时，12小时制。
%i	分钟。数值类型，取值范围为00~59。
%j	每年的第几天。取值范围为001~366。
%k	小时。取值范围为0~23。
%l	小时。取值范围为1~12。
%M	月份的英文表达，例如January、December。
%m	月份。数值格式，取值范围为01~12。
%p	AM、PM。
%r	时间。12小时制，格式为 `hh:mm:ss AM/PM` 。
%S	秒。取值范围为00~59。
%s	秒。取值范围为00~59。
%f	毫秒。取值范围为000~999。
%T	时间。24小时制，格式为 `hh:mm:ss` 。
%v	每年的第几周，星期一是一周的第一天。取值范围为01~53。
%W	星期几的名称。例如Sunday、Saturday。
%Y	4位数的年份。例如2020。
%y	2位数的年份。例如20。
%%	%的转义字符。

unit	说明
millisecond	毫秒
second	秒
minute	分钟
hour	小时
day	天
week	周
month	月
quarter	季度
year	年

日期和时间函数

current_date函数

语法

返回值类型

示例

current_time函数

语法

返回值类型

示例

current_timestamp函数

语法

返回值类型

示例

current_timezone函数

语法

返回值类型

示例

date函数

语法

参数说明

返回值类型

示例

date_format函数

语法

参数说明

返回值类型

示例

date_parse函数

语法

参数说明

返回值类型

示例

from_iso8601_date函数

语法

参数说明

返回值类型

示例

from_iso8601_timestamp函数

语法

参数说明

返回值类型

示例

from_unixtime函数

语法

参数说明

返回值类型

示例

localtime函数

语法

返回值类型

示例

localtimestamp函数

语法

返回值类型

示例

now函数

语法

返回值类型

示例

to_iso8601函数

语法

参数说明

返回值类型

示例

to_unixtime函数

语法

参数说明

返回值类型

示例

day函数

语法

参数说明

返回值类型

示例

day_of_month函数

语法

参数说明

返回值类型

示例

day_of_week函数