:日付関数

datetime dateadd(datetime date, bigint delta, string datepart)

 if trans_date = 2005-02-28 00:00:00
dateadd(trans_date, 1, 'dd') = 2005-03-01 00:00:00
-- 1 日追加します。 結果は 2 月の最終日より大きくなります。 実際の値は、翌月の初日です。
dateadd(trans_date, -1, 'dd') = 2005-02-27 00:00:00
-- 1 日引きます。
dateadd(trans_date, 20, 'mm') = 2006-10-28 00:00:00
-- 20 か月追加します。 月が溢れ、年に  ‘1’ が追加されます。
If trans_date = 2005-02-28 00:00:00, dateadd(transdate, 1, 'mm') = 2005-03-28 00:00:00
If trans_date = 2005-01-29 00:00:00, dateadd(transdate, 1, 'mm') = 2005-02-28 00:00:00
-- 2005 年 2 月 29 日 この日付が、現在の月の最終日に割り込まれます。
 If trans_date = 2005-03-30 00:00:00, dateadd(transdate, -1, 'mm') = 2005-02-28 00:00:00

select dateadd(2005-03-30 00:00:00, -1, 'mm') from tbl1;

select dateadd(cast("2005-03-30 00:00:00" as datetime), -1, 'mm') from tbl1;
-- String 型の定数は、暗黙の変換によって datatime 型に変換されます。

bigint datediff(datetime date1, datetime date2, string datepart)

• datet1、date2: Datetime 型､被減数､減数分裂｡ 入力値が「String」型の場合、暗黙の変換によって「Datetime」型に変換されます。 それ以外のデータ型の場合は、例外が報告されます。
• datepart: String 型の定数です。拡張日付形式に対応しています。 「datepart」が指定した形式になっていない場合、または他のデータ型の場合、例外が報告されます。

If start = 2005-12-31 23:59:59, end = 2006-01-01 00:00:00:
    datediff(end, start, 'dd') = 1
    datediff(end, start, 'mm') = 1
    datediff(end, start, 'yyyy') = 1
    datediff(end, start, 'hh') = 1
    datediff(end, start, 'mi') = 1
    datediff(end, start, 'ss') = 1
    datediff('2013-05-31 13:00:00', '2013-05-31 12:30:00', 'ss') = 1800
    datediff('2013-05-31 13:00:00', '2013-05-31 12:30:00', 'mi') = 30
If start = 19:33:23. 234, end = 19:33:23. 250 .Dates with milliseconds do not belong to the standard datetime style, and cannot be converted implicitly directly.Explicit conversion is required here:
  
datediff(to_date('2018-06-04 19:33:23.250', 'yyyy-MM-dd hh:mi:ss.ff3'),to_date('2018-06-04 19:33:23.234', 'yyyy-MM-dd hh:mi:ss.ff3') , 'ff3') = 16

bigint datepart(datetime date, string datepart)

• date: Datetime 型。 入力値が「String」型の場合、「Datetime」型に変換されます。 それ以外のデータ型の場合は、例外が報告されます。
• datepart: String 型の定数です。 拡張日付形式を使用できます。 「datepart」が指定された形式を満たさないか、または他のデータ型である場合、例外が報告されます。

datepart('2013-06-08 01:10:00', 'yyyy') = 2013
datepart('2013-06-08 01:10:00', 'mm') = 6

datetime datetrunc (datetime date, string datepart)

• date: Datetime 型。 入力値が「String」型の場合、「Datetime」型に変換されます。 それ以外のデータ型の場合は、例外が報告されます。
• datepart: String 型の定数です。 拡張日付形式を使用できます。「datepart」が指定された形式を満たさないか、または他のデータ型である場合、例外が報告されます。

datetrunc('2011-12-07 16:28:46', 'yyyy') = 2011-01-01 00:00:00
datetrunc('2011-12-07 16:28:46', 'month') = 2011-12-01 00:00:00
datetrunc('2011-12-07 16:28:46', 'DD') = 2011-12-07 00:00:00

datetime getdate()

boolean isdate(string date, string format)

• date: String 型の日付値です。 入力値が「Bigint 型」、「Double 型」または「Datetime 型」の場合、「String」型に変換されます。 それ以外のデータ型の場合は、例外が報告されます。
• format: String 型の定数です。 日付の拡張形式は使用できません。 冗長な形式の文字列が「format」で指定されると、形式の最初の文字列に対応する Datatime 値ガ取得されます。他の文字列は区切り文字として扱われます。 たとえば、isdate (「1234-yyyy」、「yyyy-yyyy」) の場合は「TRUE」が返されます。

datetime lastday(datetime date)

datetime to_date(string date, string format)

• date: String 型で、変換対象の日付値です。 入力値が「Bigint」型、「Double」型、「Datetime」型の場合、暗黙の変換によって「String」型に変換されます。 それ以外のデータ型または NULL の場合は、例外が報告されます。
• format: String 型の定数で日付形式です。定数でないか、他のデータ型である場合は、例外が発生します。 フィールド "format" は拡張形式に対応しておらず、他の文字は分析プロセスで 無効な文字として無視されます。

  パラメーター format には少なくとも「yyyy」が含まれている必要があります。そうでなければ、例外が報告されます。 冗長な形式の文字列が format で指定されると、形式の最初の文字列に対応する Datatime 型の値が取得されます。他の文字列は区切り文字として扱われます。 たとえば、to_date (‘1234-2234’, ‘yyyy-yyyy’) は、「1234-01-01 00:00:00」と返されます。

  format 形式：yyyy は 4 桁の年、mm は 2 桁の月、DD は 2 桁の日、HH は 24 時間制、MI は 2 桁の分、SS は 2 桁の秒、FF3 は 3 桁の精度のミリ秒です。

to_date('Alibaba2010-12*03', 'Alibabayyyy-mm*dd') = 2010-12-03 00:00:00
to_date('20080718', 'yyyymmdd') = 2008-07-18 00:00:00
to_date('200807182030','yyyymmddhhmi')=2008-07-18 20:30:00
to_date('2008718', 'yyyymmdd') = null
-- 形式が要件を満たしていません。 例外が発生します。
to_date('Alibaba2010-12*3', 'Alibabayyyy-mm*dd') = null
-- 形式が非互換のため、例外が発生します。
to_date('2010-24-01', 'yyyy') = null
-- 形式が非互換のため、例外が発生します。
to_date('20181030 15-13-12.345','yyyymmdd hh-mi-ss.ff3')=2018-10-30 15:13:12

string to_char(datetime date, string format)

• date: Datetime 型で、変換対象の日付値です。 入力値が「String」型の場合、暗黙の変換によって「Datetime」型に変換されます。 それ以外のデータ型の場合は、例外が報告されます。
• format: String 型の定数です。 定数でない場合、または他のデータ型の場合は、例外が報告されます。 「format」の日付形式の部分が対応するデータに置き換えられ、他の文字は直接出力されます。

to_char('2010-12-03 00:00:00', 'Alibabayyyy-mm*dd') = 'Alibaba2010-12*03'
to_char('2008-07-18 00:00:00', 'yyyymmdd') = '20080718' 
to_char('Alibaba2010-12*3', 'Alibabayyyy-mm*dd') -- -- 形式が非互換のため、例外が発生します。
to_char('2010-24-01', 'yyyy') -- -- 形式が非互換のため、例外が発生します。
to_char('2008718', 'yyyymmdd') -- -- 形式が非互換のため、例外が発生します。

bigint unix_timestamp(datetime date)

datetime from_unixtime(bigint unixtime)

from_unixtime(123456789) = 1973-11-30 05:33:09

bigint weekday(datetime date)

bigint weekofyear(datetime date)

select weekofyear(to_date("20141229", "yyyymmdd")) from dual;  
結果：  
+------------+
| _c0 |
+------------+
| 1 |
+------------+
 -20141229 は 2014 に属しますが、この週の日付の大部分は 2015 です。したがって、戻される結果は 1 で、2015 の第 1 週であることを示します。    
 select weekofyear(to_date("20141231", "yyyymmdd")) from dual；
-- 1 を戻します。  
 select weekofyear(to_date("20141229", "yyyymmdd")) from dual；
-- 53 を戻します。

set odps.sql.type.system.odps2=true;--Enable the new type.

set odps.sql.type.system.odps2=true;
select year('1970-01-01 12:30:00')=1970 from dual;

INT year(string date)

year('1970-01-01 12:30:00') = 1970
year('1970-01-01') = 1970
year('70-01-01') = 70
year(1970-01-01) = null
year('1970/03/09') = null
year(null) Returns an exception

INT quarter(datetime/timestamp/string date )

quarter('1970-11-12 10:00:00') = 4
quarter('1970-11-12') = 4

INT month(string date)

month('2014-09-01') = 9
month('20140901') = null

INT day(string date)

day('2014-09-01') = 1
day('20140901') = null

INT dayofmonth(date)

dayofmonth('2014-09-01') = 1
dayofmonth('20140901') = null

INT hour(string date)

hour('2014-09-01 12:00:00')=12
hour('12:00:00')=12
hour('20140901120000')=null

INT minute(string date)

minute('2014-09-01 12:30:00') = 30
minute('12:30:00') = 30
minute('20140901120000') = null

INT second(string date)

second('2014-09-01 12:30:45') = 45
second('12:30:45') = 45
second('20140901123045') = null

timestamp current_timestamp()

select current_timestamp() from dual;--Returns '2017-08-03 11:50:30.661'

string add_months(string startdate, int nummonths)

• startdate: String 型の値です。 形式には少なくとも「yyyy-mm-dd」を含める必要があり それ以外の場合は、NULL が返されます。
• num_months: Int 型の値です。

Add_months ('2017-02-14', 3) = '2017-05-14'
add_months('17-2-14',3) = '0017-05-14'
add_months('2017-02-14 21:30:00',3) = '2017-05-14'
add_months('20170214',3) = null

string last_day(string date)

last_day('2017-03-04') = '2017-03-31'
last_day('2017-07-04 11:40:00') = '2017-07-31'
last_day('20170304') = null

string next_day(string startdate, string week)

• startdate: String 型で、形式は「yyyy-MM-dd HH:mi:ss」または「yyyy-MM-dd」です。
• week: String 型で、曜日の最初の 2 文字または 3 文字、または曜日のフルネームです。 たとえば、Mo、TUE、FRIDAY です。

next_day('2017-08-01','TU') = '2017-08-08'
next_day('2017-08-01 23:34:00','TU') = '2017-08-08'
Next_day ('20170801 ', 'tu') = NULL

double months_between(datetime/timestamp/string date1, datetime/timestamp/string date2)

• date1: Datetime 型、Timestamp 型、String 型のいずれかで、形式は「yyyy-MM-dd HH:mi:ss」または「yyyy-MM-dd」です。
• date2: Datetime 型、Timestamp 型、String 型のいずれかで、形式は「yyyy-MM-dd HH:mi:ss」または「yyyy-MM-dd」です。

• date1 が date2 より後の場合、戻り値は正の数になります。 date2 が date1 より後の場合、戻り値は負の数になります。
• date1 と date2 が 、2 か月の最後の日の場合、戻り値は月数を表す整数です。 それ以外の場合の式は、(date1 - date2)/31 です。

months_between('1997-02-28 10:30:00', '1996-10-30') = 3.9495967741935485
months_between('1996-10-30','1997-02-28 10:30:00' ) = -3.9495967741935485
months_between('1996-09-30','1996-12-31') = -3.0