全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件
流计算

日期函数

更新时间:2017-06-07 13:26:11

DATE_ADD

函数定义:

  1. string date_add(string startdate, int days)

功能说明:

从起始日期加上指定天数,返回新的日期

参数说明:

startdate:string类型日期,日期格式:yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss

函数定义:

  1. string date_add(string startdate, int days)

功能说明:

从起始日期加上指定天数,返回新的日期

参数说明:

startdate:string类型日期,日期格式:yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss。days:int类型,指定偏移的天数,可为负数

返回值:

string类型日期。任一输入参数是NULL,返回NULL。

示例:

  1. date_add('2008-12-31', 1) = '2009-01-01'
  2. date_add('2008-12-31', -1) = '2008-12-30'

DATE_SUB

函数定义:

  1. string date_sub(string startdate, int days)

功能说明:

从起始日期减去指定天数,返回新的日期

参数说明:

startdate:string类型日期,日期格式:yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss。days:int类型,指定偏移的天数,可为负数

返回值:

string类型日期。任一输入参数是NULL,返回NULL。

示例:

  1. date_sub('2008-12-31', 1) = '2008-12-30'
  2. date_sub('2008-12-31', -1) = '2009-01-01'

DATEDIFF

函数定义:

  1. int datediff(string enddate, string startdate)

功能说明:

计算从enddate到startdate两个时间的天数差值。

参数说明:

startdate, startdate: string类型日期,日期格式:yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss。

返回值:

int类型。任一输入参数是NULL,返回NULL。

示例:

  1. datediff('2009-03-01', '2009-02-27') = 2

FROM_UNIXTIME

函数定义:

  1. string from_unixtime(bigint unixtime[, string format])

功能说明:

将数字型的unix时间日期值unixtime转为日期值。

参数说明:

unixtime: bigint类型,秒数,unix格式的日期时间值,其它类型抛出异常。format: 指定输出日期格式

返回值:

string类型的日期值, 默认日期格式:yyyy-MM-dd HH:mm:ss,若指定日期格式按指定格式输出任一输入参数是NULL,返回NULL。

示例:

  1. from_unixtime(1394502696) = '2014-03-11 09:51:36'
  2. from_unixtime(1394502696, 'yyyyMMddHH') = '2014031109'

UNIX_TIMESTAMP

函数定义:

  1. bigint unix_timestamp()
  2. bigint unix_timestamp(string date)
  3. bigint unix_timestamp(string date, string format)

功能说明:

获取指定日期对应的秒数(从1970-01-01 00:00:00起至今),未指定参数时为当前系统时间的秒数

参数说明:

date: string类型日期,默认日期格式:yyyy-MM-dd HH:mm:ss。format: string类型, 指定输入参数日期格式

返回值:

bigint类型输入参数是NULL,返回NULL。

示例:

  1. unix_timestamp() = 1394502696
  2. unix_timestamp('2009-03-20 11:30:01') = 1237573801
  3. unix_timestamp('2009-03-20', 'yyyy-MM-dd') = 1237532400

TO_DATE

函数定义:

  1. string to_date(string timestamp)

功能说明:

返回时间戳字符串中的日期字符串。

参数说明:

timestamp: string类型日期,日期格式:yyyy-MM-dd HH:mm:ss。

返回值:

string类型。若任一输入为NULL,返回NULL值。

示例:

  1. to_date('1970-01-01 00:00:00') = '1970-01-01'

DATE_FORMAT

函数定义:

  1. string date_format(string date, string, to_format)
  2. string date_format(string date, string from_format, string, to_format)

功能说明:

对日期字符串进行格式转换

参数说明:

date: string类型日期,默认日期格式:yyyy-MM-dd HH:mm:ss。from_format: 指定输入日期格式to_format:指定输出日期格式

返回值:

string类型日期。若任一输入为NULL,返回NULL值。

示例:

  1. date_format('1970-01-01 00:00:00', 'yyyyMMdd') = '19700101'
  2. date_format('1970-01-01', 'yyyy-MM-dd', 'yyyyMMdd') = '19700101'

YEAR

函数定义:

  1. int year(string date)

功能说明:

获取日期中的年份

参数说明:

date: string类型日期,日期格式:yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss。

返回值:

int类型若输入为NULL,返回NULL值。

示例:

  1. year('1970-01-01 00:00:00') = 1970

MONTH

函数定义:

  1. int month(string date)

功能说明:

获取日期中的月份

参数说明:

date: string类型日期,日期格式:yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss。

返回值:

int类型若输入为NULL,返回NULL值。

示例:

  1. month('1970-11-01 00:00:00') = 11

DAY

函数定义:

  1. int day(string date)

功能说明:

获取日期中在一个月中的天数

参数说明:

date: string类型日期,日期格式:yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss。

返回值:

int类型若输入为NULL,返回NULL值。

示例:

  1. day('1970-11-01 00:00:00') = 1

WEEKOFYEAR

函数定义:

  1. int weekofyear(string date)

功能说明:

计算指定日期在一年中的第几周,周数取值区间 1~53,周一为一周起始.

参数说明:

date: string类型日期,日期格式:yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss。

返回值:

int类型,若输入为NULL,返回NULL值,日期格式不对返回NULL。

示例:

  1. weekofyear("1970-11-01 00:00:00") = 44
  2. weekofyear("1970-11-01") = 44

HOUR

函数定义:

  1. int hour(string date)

功能说明:

获取时间戳中小时数

参数说明:

date: string类型时间戳,时间戳格式: yyyy-MM-dd HH:mm:ss 或 HH:mm:ss。

返回值:

int类型若输入为NULL,返回NULL值。

示例:

  1. hour('2009-07-30 12:58:59') = 12
  2. hour('12:58:59') = 12

MINUTE

函数定义:

  1. int minute(string date)

功能说明:

获取时间戳中分钟数

参数说明:

date: string类型时间戳,时间戳格式: yyyy-MM-dd HH:mm:ss 或 HH:mm:ss。

返回值:

int类型若输入为NULL,返回NULL值。

示例:

  1. minute('2009-07-30 12:58:59') = 58
  2. minute('12:58:59') = 58

SECOND

函数定义:

  1. int second(string date)

功能说明:

获取时间戳中秒数

参数说明:

date: string类型时间戳,时间戳格式: yyyy-MM-dd HH:mm:ss 或 HH:mm:ss。

返回值:

int类型若输入为NULL,返回NULL值。

示例:

  1. second('2009-07-30 12:58:59') = 59
  2. second('12:58:59') = 59
本文导读目录