ClickHouse/docs/zh/query_language/functions/date_time_functions.md
2019-06-05 16:54:36 +08:00

9.8 KiB
Raw Blame History

时间日期函数

支持时区。

所有的时间日期函数都可以在第二个可选参数中接受时区参数。示例Asia / Yekaterinburg。在这种情况下它们使用指定的时区而不是本地默认时区。

SELECT
    toDateTime('2016-06-15 23:00:00') AS time,
    toDate(time) AS date_local,
    toDate(time, 'Asia/Yekaterinburg') AS date_yekat,
    toString(time, 'US/Samoa') AS time_samoa
┌────────────────time─┬─date_local─┬─date_yekat─┬─time_samoa──────────┐
│ 2016-06-15 23:00:00 │ 2016-06-15 │ 2016-06-16 │ 2016-06-15 09:00:00 │
└─────────────────────┴────────────┴────────────┴─────────────────────┘

仅支持与UTC相差一整小时的时区。

toTimeZone

将Date或DateTime转换为指定的时区。

toYear

将Date或DateTime转换为包含年份编号AD的UInt16类型的数字。

toQuarter

将Date或DateTime转换为包含季度编号的UInt8类型的数字。

toMonth

将Date或DateTime转换为包含月份编号1-12的UInt8类型的数字。

toDayOfYear

将Date或DateTime转换为包含一年中的某一天的编号的UInt161-366类型的数字。

toDayOfMonth

将Date或DateTime转换为包含一月中的某一天的编号的UInt81-31类型的数字。

toDayOfWeek

将Date或DateTime转换为包含一周中的某一天的编号的UInt8周一是1, 周日是7类型的数字。

toHour

将DateTime转换为包含24小时制0-23小时数的UInt8数字。 这个函数假设如果时钟向前移动它是一个小时发生在凌晨2点如果时钟被移回它是一个小时发生在凌晨3点这并非总是如此 - 即使在莫斯科时钟在不同的时间两次改变)。

toMinute

将DateTime转换为包含一小时中分钟数0-59的UInt8数字。

toSecond

将DateTime转换为包含一分钟中秒数0-59的UInt8数字。 闰秒不计算在内。

toUnixTimestamp

将DateTime转换为unix时间戳。

toStartOfYear

将Date或DateTime向前取整到本年的第一天。 返回Date类型。

toStartOfISOYear

将Date或DateTime向前取整到ISO本年的第一天。 返回Date类型。

toStartOfQuarter

将Date或DateTime向前取整到本季度的第一天。 返回Date类型。

toStartOfMonth

将Date或DateTime向前取整到本月的第一天。 返回Date类型。

!!! 注意     解析不正确日期的行为是特定于实现的。 ClickHouse可能会返回零日期抛出异常或执行“natural”溢出。

toMonday

将Date或DateTime向前取整到本周的星期一。 返回Date类型。

toStartOfDay

将DateTime向前取整到当日的开始。

toStartOfHour

将DateTime向前取整到当前小时的开始。

toStartOfMinute

将DateTime向前取整到当前分钟的开始。

toStartOfFiveMinute

将DateTime以五分钟为单位向前取整到最接近的时间点。

toStartOfTenMinutes

将DateTime以十分钟为单位向前取整到最接近的时间点。

toStartOfFifteenMinutes

将DateTime以十五分钟为单位向前取整到最接近的时间点。

toStartOfInterval(time_or_data, INTERVAL x unit [, time_zone])

这是名为toStartOf*的所有函数的通用函数。例如, toStartOfIntervaltINTERVAL 1 year返回与toStartOfYeart相同的结果, toStartOfIntervaltINTERVAL 1 month返回与toStartOfMontht相同的结果, toStartOfIntervaltINTERVAL 1 day返回与toStartOfDayt相同的结果, toStartOfIntervaltINTERVAL 15 minute返回与toStartOfFifteenMinutest相同的结果。

toTime

将DateTime中的日期转换为一个固定的日期同时保留时间部分。

toRelativeYearNum

将Date或DateTime转换为年份的编号从过去的某个固定时间点开始。

toRelativeQuarterNum

将Date或DateTime转换为季度的数字从过去的某个固定时间点开始。

toRelativeMonthNum

将Date或DateTime转换为月份的编号从过去的某个固定时间点开始。

toRelativeWeekNum

将Date或DateTime转换为星期数从过去的某个固定时间点开始。

toRelativeDayNum

将Date或DateTime转换为当天的编号从过去的某个固定时间点开始。

toRelativeHourNum

将DateTime转换为小时数从过去的某个固定时间点开始。

toRelativeMinuteNum

将DateTime转换为分钟数从过去的某个固定时间点开始。

toRelativeSecondNum

将DateTime转换为秒数从过去的某个固定时间点开始。

toISOYear

将Date或DateTime转换为包含ISO年份的UInt16类型的编号。

toISOWeek

将Date或DateTime转换为包含ISO周数的UInt8类型的编号。

now

不接受任何参数并在请求执行时的某一刻返回当前时间DateTime。 此函数返回一个常量,即时请求需要很长时间能够完成。

today

不接受任何参数并在请求执行时的某一刻返回当前日期(Date)。 其功能与'toDatenow'相同。

yesterday

不接受任何参数并在请求执行时的某一刻返回昨天的日期(Date)。 其功能与'today - 1'相同。

timeSlot

将时间向前取整半小时。 此功能用于Yandex.Metrica因为如果跟踪标记显示单个用户的连续综合浏览量在时间上严格超过此数量则半小时是将会话分成两个会话的最短时间。这意味着tag iduser idtime slot可用于搜索相应会话中包含的综合浏览量。

toYYYYMM

将Date或DateTime转换为包含年份和月份编号的UInt32类型的数字YYYY * 100 + MM

toYYYYMMDD

将Date或DateTime转换为包含年份和月份编号的UInt32类型的数字YYYY * 10000 + MM * 100 + DD

toYYYYMMDDhhmmss

将Date或DateTime转换为包含年份和月份编号的UInt64类型的数字YYYY * 10000000000 + MM * 100000000 + DD * 1000000 + hh * 10000 + mm * 100 + ss

addYears, addMonths, addWeeks, addDays, addHours, addMinutes, addSeconds, addQuarters

函数将一段时间间隔添加到Date/DateTime然后返回Date/DateTime。例如

WITH
    toDate('2018-01-01') AS date,
    toDateTime('2018-01-01 00:00:00') AS date_time
SELECT
    addYears(date, 1) AS add_years_with_date,
    addYears(date_time, 1) AS add_years_with_date_time
┌─add_years_with_date─┬─add_years_with_date_time─┐
│          2019-01-01 │      2019-01-01 00:00:00 │
└─────────────────────┴──────────────────────────┘

subtractYears, subtractMonths, subtractWeeks, subtractDays, subtractHours, subtractMinutes, subtractSeconds, subtractQuarters

函数将Date/DateTime减去一段时间间隔然后返回Date/DateTime。例如

WITH
    toDate('2019-01-01') AS date,
    toDateTime('2019-01-01 00:00:00') AS date_time
SELECT
    subtractYears(date, 1) AS subtract_years_with_date,
    subtractYears(date_time, 1) AS subtract_years_with_date_time
┌─subtract_years_with_date─┬─subtract_years_with_date_time─┐
│               2018-01-01 │           2018-01-01 00:00:00 │
└──────────────────────────┴───────────────────────────────┘

dateDiff('unit', t1, t2, [timezone])

返回以'unit'为单位表示的两个时间之间的差异,例如'hours'。 't1'和't2'可以是Date或DateTime如果指定'timezone',它将应用于两个参数。如果不是,则使用来自数据类型't1'和't2'的时区。如果时区不相同,则结果将是未定义的。

Supported unit values:

unit
second
minute
hour
day
week
month
quarter
year

timeSlots(StartTime, Duration,[, Size])

它返回一个时间数组其中包括从从“StartTime”开始到“StartTime + Duration 秒”内的所有符合“size”以秒为单位步长的时间点。其中“size”是一个可选参数默认为1800。 例如,timeSlots(toDateTime('2012-01-01 12:20:00')600) = [toDateTime'2012-01-01 12:00:00'toDateTime'2012-01-01 12:30:00' ]。 这对于搜索在相应会话中综合浏览量是非常有用的。

formatDateTime(Time, Format[, Timezone])

函数根据给定的格式字符串来格式化时间。请注意:格式字符串必须是常量表达式,例如:单个结果列不能有多种格式字符串。

支持的格式修饰符: ("Example" 列是对2018-01-02 22:33:44的格式化结果)

Modifier Description Example
%C year divided by 100 and truncated to integer (00-99) 20
%d day of the month, zero-padded (01-31) 02
%D Short MM/DD/YY date, equivalent to %m/%d/%y 01/02/2018
%e day of the month, space-padded ( 1-31) 2
%F short YYYY-MM-DD date, equivalent to %Y-%m-%d 2018-01-02
%H hour in 24h format (00-23) 22
%I hour in 12h format (01-12) 10
%j day of the year (001-366) 002
%m month as a decimal number (01-12) 01
%M minute (00-59) 33
%n new-line character ('\n')
%p AM or PM designation PM
%R 24-hour HH:MM time, equivalent to %H:%M 22:33
%S second (00-59) 44
%t horizontal-tab character ('\t')
%T ISO 8601 time format (HH:MM:SS), equivalent to %H:%M:%S 22:33:44
%u ISO 8601 weekday as number with Monday as 1 (1-7) 2
%V ISO 8601 week number (01-53) 01
%w weekday as a decimal number with Sunday as 0 (0-6) 2
%y Year, last two digits (00-99) 18
%Y Year 2018
%% a % sign %

来源文章