From 40eac90ac23cff5015f6fbf94a622de82feea7f9 Mon Sep 17 00:00:00 2001 From: Yury-Fridlyand Date: Mon, 3 Oct 2022 21:27:38 -0700 Subject: [PATCH 1/2] Update docs. Signed-off-by: Yury-Fridlyand --- docs/user/dql/functions.rst | 83 ++++++++++++++-------------- docs/user/ppl/functions/datetime.rst | 83 ++++++++++++++-------------- 2 files changed, 86 insertions(+), 80 deletions(-) diff --git a/docs/user/dql/functions.rst b/docs/user/dql/functions.rst index eb49195ff18..23bf1869b40 100644 --- a/docs/user/dql/functions.rst +++ b/docs/user/dql/functions.rst @@ -1612,7 +1612,7 @@ NOW Description >>>>>>>>>>> -Returns the current date and time as a value in 'YYYY-MM-DD hh:mm:ss.nnnnnn' format. The value is expressed in the cluster time zone. +Returns the current date and time as a value in 'YYYY-MM-DD hh:mm:ss' format. The value is expressed in the cluster time zone. `NOW()` returns a constant time that indicates the time at which the statement began to execute. This differs from the behavior for `SYSDATE() <#sysdate>`_, which returns the exact time at which it executes. Return type: DATETIME @@ -1623,11 +1623,11 @@ Example:: > SELECT NOW() as value_1, NOW() as value_2; fetched rows / total rows = 1/1 - +----------------------------+----------------------------+ - | value_1 | value_2 | - |----------------------------+----------------------------| - | 2022-08-02 15:39:05.173069 | 2022-08-02 15:39:05.173069 | - +----------------------------+----------------------------+ + +---------------------+---------------------+ + | value_1 | value_2 | + |---------------------+---------------------| + | 2022-08-02 15:39:05 | 2022-08-02 15:39:05 | + +---------------------+---------------------+ CURRENT_TIMESTAMP @@ -1642,11 +1642,11 @@ Example:: > SELECT CURRENT_TIMESTAMP(), CURRENT_TIMESTAMP; fetched rows / total rows = 1/1 - +----------------------------+----------------------------+ - | CURRENT_TIMESTAMP() | CURRENT_TIMESTAMP | - |----------------------------+----------------------------| - | 2022-08-02 15:54:19.209361 | 2022-08-02 15:54:19.209361 | - +----------------------------+----------------------------+ + +-----------------------+---------------------+ + | CURRENT_TIMESTAMP() | CURRENT_TIMESTAMP | + |-----------------------+---------------------| + | 2022-08-02 15:54:19 | 2022-08-02 15:54:19 | + +-----------------------+---------------------+ LOCALTIMESTAMP @@ -1661,11 +1661,11 @@ Example:: > SELECT LOCALTIMESTAMP(), LOCALTIMESTAMP; fetched rows / total rows = 1/1 - +----------------------------+----------------------------+ - | LOCALTIMESTAMP() | LOCALTIMESTAMP | - |----------------------------+----------------------------| - | 2022-08-02 15:54:19.209361 | 2022-08-02 15:54:19.209361 | - +----------------------------+----------------------------+ + +---------------------+---------------------+ + | LOCALTIMESTAMP() | LOCALTIMESTAMP | + |---------------------+---------------------| + | 2022-08-02 15:54:19 | 2022-08-02 15:54:19 | + +---------------------+---------------------+ LOCALTIME @@ -1680,11 +1680,11 @@ Example:: > SELECT LOCALTIME(), LOCALTIME; fetched rows / total rows = 1/1 - +----------------------------+----------------------------+ - | LOCALTIME() | LOCALTIME | - |----------------------------+----------------------------| - | 2022-08-02 15:54:19.209361 | 2022-08-02 15:54:19.209361 | - +----------------------------+----------------------------+ + +---------------------+---------------------+ + | LOCALTIME() | LOCALTIME | + |---------------------+---------------------| + | 2022-08-02 15:54:19 | 2022-08-02 15:54:19 | + +---------------------+---------------------+ SYSDATE @@ -1693,22 +1693,25 @@ SYSDATE Description >>>>>>>>>>> -Returns the current date and time as a value in 'YYYY-MM-DD hh:mm:ss.nnnnnn'. +Returns the current date and time as a value in 'YYYY-MM-DD hh:mm:ss[.nnnnnn]'. SYSDATE() returns the time at which it executes. This differs from the behavior for `NOW() <#now>`_, which returns a constant time that indicates the time at which the statement began to execute. +If the argument is given, it specifies a fractional seconds precision from 0 to 6, the return value includes a fractional seconds part of that many digits. + +Optional argument type: INTEGER Return type: DATETIME -Specification: SYSDATE() -> DATETIME +Specification: SYSDATE([INTEGER]) -> DATETIME Example:: - > SELECT SYSDATE() as value_1, SYSDATE() as value_2; + > SELECT SYSDATE() as value_1, SYSDATE(6) as value_2; fetched rows / total rows = 1/1 - +----------------------------+----------------------------+ - | value_1 | value_2 | - |----------------------------+----------------------------| - | 2022-08-02 15:39:05.173069 | 2022-08-02 15:39:05.173142 | - +----------------------------+----------------------------+ + +---------------------+----------------------------+ + | value_1 | value_2 | + |---------------------+----------------------------| + | 2022-08-02 15:39:05 | 2022-08-02 15:39:05.123456 | + +---------------------+----------------------------+ CURTIME @@ -1717,7 +1720,7 @@ CURTIME Description >>>>>>>>>>> -Returns the current time as a value in 'hh:mm:ss.nnnnnn'. +Returns the current time as a value in 'hh:mm:ss'. CURTIME() returns the time at which the statement began to execute as `NOW() <#now>`_ does. Return type: TIME @@ -1728,11 +1731,11 @@ Example:: > SELECT CURTIME() as value_1, CURTIME() as value_2; fetched rows / total rows = 1/1 - +-----------------+-----------------+ - | value_1 | value_2 | - |-----------------+-----------------| - | 15:39:05.173069 | 15:39:05.173069 | - +-----------------+-----------------+ + +-----------+-----------+ + | value_1 | value_2 | + |-----------+-----------| + | 15:39:05 | 15:39:05 | + +-----------+-----------+ CURRENT_TIME @@ -1747,11 +1750,11 @@ Example:: > SELECT CURRENT_TIME(), CURRENT_TIME; fetched rows / total rows = 1/1 - +-----------------+-----------------+ - | CURRENT_TIME() | CURRENT_TIME | - |-----------------+-----------------| - | 15:39:05.173069 | 15:39:05.173069 | - +-----------------+-----------------+ + +-----------------+----------------+ + | CURRENT_TIME() | CURRENT_TIME | + |-----------------+----------------| + | 15:39:05 | 15:39:05 | + +-----------------+----------------+ CURDATE diff --git a/docs/user/ppl/functions/datetime.rst b/docs/user/ppl/functions/datetime.rst index a9b61097bec..7e310879220 100644 --- a/docs/user/ppl/functions/datetime.rst +++ b/docs/user/ppl/functions/datetime.rst @@ -772,7 +772,7 @@ NOW Description >>>>>>>>>>> -Returns the current date and time as a value in 'YYYY-MM-DD hh:mm:ss.nnnnnn' format. The value is expressed in the cluster time zone. +Returns the current date and time as a value in 'YYYY-MM-DD hh:mm:ss' format. The value is expressed in the cluster time zone. `NOW()` returns a constant time that indicates the time at which the statement began to execute. This differs from the behavior for `SYSDATE() <#sysdate>`_, which returns the exact time at which it executes. Return type: DATETIME @@ -783,11 +783,11 @@ Example:: > source=people | eval `value_1` = NOW(), `value_2` = NOW() | fields `value_1`, `value_2` fetched rows / total rows = 1/1 - +----------------------------+----------------------------+ - | value_1 | value_2 | - |----------------------------+----------------------------| - | 2022-08-02 15:39:05.173069 | 2022-08-02 15:39:05.173069 | - +----------------------------+----------------------------+ + +---------------------+---------------------+ + | value_1 | value_2 | + |---------------------+---------------------| + | 2022-08-02 15:39:05 | 2022-08-02 15:39:05 | + +---------------------+---------------------+ CURRENT_TIMESTAMP @@ -802,11 +802,11 @@ Example:: > source=people | eval `CURRENT_TIMESTAMP()` = CURRENT_TIMESTAMP(), `CURRENT_TIMESTAMP` = CURRENT_TIMESTAMP | fields `CURRENT_TIMESTAMP()`, `CURRENT_TIMESTAMP` fetched rows / total rows = 1/1 - +----------------------------+----------------------------+ - | CURRENT_TIMESTAMP() | CURRENT_TIMESTAMP | - |----------------------------+----------------------------| - | 2022-08-02 15:54:19.209361 | 2022-08-02 15:54:19.209361 | - +----------------------------+----------------------------+ + +-----------------------+---------------------+ + | CURRENT_TIMESTAMP() | CURRENT_TIMESTAMP | + |-----------------------+---------------------| + | 2022-08-02 15:54:19 | 2022-08-02 15:54:19 | + +-----------------------+---------------------+ LOCALTIMESTAMP @@ -821,11 +821,11 @@ Example:: > source=people | eval `LOCALTIMESTAMP()` = LOCALTIMESTAMP(), `LOCALTIMESTAMP` = LOCALTIMESTAMP | fields `LOCALTIMESTAMP()`, `LOCALTIMESTAMP` fetched rows / total rows = 1/1 - +----------------------------+----------------------------+ - | LOCALTIMESTAMP() | LOCALTIMESTAMP | - |----------------------------+----------------------------| - | 2022-08-02 15:54:19.209361 | 2022-08-02 15:54:19.209361 | - +----------------------------+----------------------------+ + +---------------------+---------------------+ + | LOCALTIMESTAMP() | LOCALTIMESTAMP | + |---------------------+---------------------| + | 2022-08-02 15:54:19 | 2022-08-02 15:54:19 | + +---------------------+---------------------+ LOCALTIME @@ -840,11 +840,11 @@ Example:: > source=people | eval `LOCALTIME()` = LOCALTIME(), `LOCALTIME` = LOCALTIME | fields `LOCALTIME()`, `LOCALTIME` fetched rows / total rows = 1/1 - +----------------------------+----------------------------+ - | LOCALTIME() | LOCALTIME | - |----------------------------+----------------------------| - | 2022-08-02 15:54:19.209361 | 2022-08-02 15:54:19.209361 | - +----------------------------+----------------------------+ + +---------------------+---------------------+ + | LOCALTIME() | LOCALTIME | + |---------------------+---------------------| + | 2022-08-02 15:54:19 | 2022-08-02 15:54:19 | + +---------------------+---------------------+ SYSDATE @@ -853,22 +853,25 @@ SYSDATE Description >>>>>>>>>>> -Returns the current date and time as a value in 'YYYY-MM-DD hh:mm:ss.nnnnnn'. +Returns the current date and time as a value in 'YYYY-MM-DD hh:mm:ss[.nnnnnn]'. SYSDATE() returns the time at which it executes. This differs from the behavior for `NOW() <#now>`_, which returns a constant time that indicates the time at which the statement began to execute. +If the argument is given, it specifies a fractional seconds precision from 0 to 6, the return value includes a fractional seconds part of that many digits. + +Optional argument type: INTEGER Return type: DATETIME -Specification: SYSDATE() -> DATETIME +Specification: SYSDATE([INTEGER]) -> DATETIME Example:: - > source=people | eval `value_1` = SYSDATE(), `value_2` = SYSDATE() | fields `value_1`, `value_2` + > source=people | eval `value_1` = SYSDATE(), `value_2` = SYSDATE(6) | fields `value_1`, `value_2` fetched rows / total rows = 1/1 - +----------------------------+----------------------------+ - | value_1 | value_2 | - |----------------------------+----------------------------| - | 2022-08-02 15:39:05.173069 | 2022-08-02 15:39:05.173142 | - +----------------------------+----------------------------+ + +---------------------+----------------------------+ + | value_1 | value_2 | + |---------------------+----------------------------| + | 2022-08-02 15:39:05 | 2022-08-02 15:39:05.123456 | + +---------------------+----------------------------+ CURTIME @@ -877,7 +880,7 @@ CURTIME Description >>>>>>>>>>> -Returns the current time as a value in 'hh:mm:ss.nnnnnn'. +Returns the current time as a value in 'hh:mm:ss'. CURTIME() returns the time at which the statement began to execute as `NOW() <#now>`_ does. Return type: TIME @@ -888,11 +891,11 @@ Example:: > source=people | eval `value_1` = CURTIME(), `value_2` = CURTIME() | fields `value_1`, `value_2` fetched rows / total rows = 1/1 - +-----------------+-----------------+ - | value_1 | value_2 | - |-----------------+-----------------| - | 15:39:05.173069 | 15:39:05.173069 | - +-----------------+-----------------+ + +-----------+-----------+ + | value_1 | value_2 | + |-----------+-----------| + | 15:39:05 | 15:39:05 | + +-----------+-----------+ CURRENT_TIME @@ -907,11 +910,11 @@ Example:: > source=people | eval `CURRENT_TIME()` = CURRENT_TIME(), `CURRENT_TIME` = CURRENT_TIME | fields `CURRENT_TIME()`, `CURRENT_TIME` fetched rows / total rows = 1/1 - +------------------+-----------------+ - | CURRENT_TIME() | CURRENT_TIME | - |------------------+-----------------| - | 15:39:05.173069 | 15:39:05.173069 | - +------------------+-----------------+ + +------------------+----------------+ + | CURRENT_TIME() | CURRENT_TIME | + |------------------+----------------| + | 15:39:05 | 15:39:05 | + +------------------+----------------+ CURDATE From 3e45ebbe1d207c565fca03402b5144f67b2f8a6c Mon Sep 17 00:00:00 2001 From: Yury-Fridlyand Date: Tue, 4 Oct 2022 11:24:43 -0700 Subject: [PATCH 2/2] Reorder functions in docs aplhabetically. Signed-off-by: Yury-Fridlyand --- docs/user/dql/functions.rst | 333 +++++++++++++------------- docs/user/ppl/functions/datetime.rst | 341 ++++++++++++++------------- 2 files changed, 332 insertions(+), 342 deletions(-) diff --git a/docs/user/dql/functions.rst b/docs/user/dql/functions.rst index 23bf1869b40..7f02e947a44 100644 --- a/docs/user/dql/functions.rst +++ b/docs/user/dql/functions.rst @@ -963,9 +963,103 @@ CURDATE Description >>>>>>>>>>> -Specifications: +Returns the current time as a value in 'YYYY-MM-DD'. +CURDATE() returns the time at which it executes as `SYSDATE() <#sysdate>`_ does. + +Return type: DATE + +Specification: CURDATE() -> DATE + +Example:: + + > SELECT CURDATE(); + fetched rows / total rows = 1/1 + +-------------+ + | CURDATE() | + |-------------| + | 2022-08-02 | + +-------------+ + + +CURRENT_DATE +------------ + +Description +>>>>>>>>>>> + +`CURRENT_DATE` and `CURRENT_DATE()` are synonyms for `CURDATE() <#curdate>`_. + +Example:: + + > SELECT CURRENT_DATE(), CURRENT_DATE; + fetched rows / total rows = 1/1 + +------------------+----------------+ + | CURRENT_DATE() | CURRENT_DATE | + |------------------+----------------| + | 2022-08-02 | 2022-08-02 | + +------------------+----------------+ + + +CURRENT_TIME +------------ + +Description +>>>>>>>>>>> + +`CURRENT_TIME` and `CURRENT_TIME()` are synonyms for `CURTIME() <#curtime>`_. + +Example:: + + > SELECT CURRENT_TIME(), CURRENT_TIME; + fetched rows / total rows = 1/1 + +-----------------+----------------+ + | CURRENT_TIME() | CURRENT_TIME | + |-----------------+----------------| + | 15:39:05 | 15:39:05 | + +-----------------+----------------+ + + +CURRENT_TIMESTAMP +----------------- + +Description +>>>>>>>>>>> + +`CURRENT_TIMESTAMP` and `CURRENT_TIMESTAMP()` are synonyms for `NOW() <#now>`_. + +Example:: + + > SELECT CURRENT_TIMESTAMP(), CURRENT_TIMESTAMP; + fetched rows / total rows = 1/1 + +-----------------------+---------------------+ + | CURRENT_TIMESTAMP() | CURRENT_TIMESTAMP | + |-----------------------+---------------------| + | 2022-08-02 15:54:19 | 2022-08-02 15:54:19 | + +-----------------------+---------------------+ + + +CURTIME +------- + +Description +>>>>>>>>>>> + +Returns the current time as a value in 'hh:mm:ss'. +CURTIME() returns the time at which the statement began to execute as `NOW() <#now>`_ does. + +Return type: TIME -1. CURDATE() -> DATE +Specification: CURTIME() -> TIME + +Example:: + + > SELECT CURTIME() as value_1, CURTIME() as value_2; + fetched rows / total rows = 1/1 + +-----------+-----------+ + | value_1 | value_2 | + |-----------+-----------| + | 15:39:05 | 15:39:05 | + +-----------+-----------+ DATE @@ -1448,6 +1542,44 @@ Example:: +---------------------------+ +LOCALTIMESTAMP +-------------- + +Description +>>>>>>>>>>> + +`LOCALTIMESTAMP` and `LOCALTIMESTAMP()` are synonyms for `NOW() <#now>`_. + +Example:: + + > SELECT LOCALTIMESTAMP(), LOCALTIMESTAMP; + fetched rows / total rows = 1/1 + +---------------------+---------------------+ + | LOCALTIMESTAMP() | LOCALTIMESTAMP | + |---------------------+---------------------| + | 2022-08-02 15:54:19 | 2022-08-02 15:54:19 | + +---------------------+---------------------+ + + +LOCALTIME +--------- + +Description +>>>>>>>>>>> + +`LOCALTIME` and `LOCALTIME()` are synonyms for `NOW() <#now>`_. + +Example:: + + > SELECT LOCALTIME(), LOCALTIME; + fetched rows / total rows = 1/1 + +---------------------+---------------------+ + | LOCALTIME() | LOCALTIME | + |---------------------+---------------------| + | 2022-08-02 15:54:19 | 2022-08-02 15:54:19 | + +---------------------+---------------------+ + + MAKEDATE -------- @@ -1630,176 +1762,6 @@ Example:: +---------------------+---------------------+ -CURRENT_TIMESTAMP ------------------ - -Description ->>>>>>>>>>> - -`CURRENT_TIMESTAMP` and `CURRENT_TIMESTAMP()` are synonyms for `NOW() <#now>`_. - -Example:: - - > SELECT CURRENT_TIMESTAMP(), CURRENT_TIMESTAMP; - fetched rows / total rows = 1/1 - +-----------------------+---------------------+ - | CURRENT_TIMESTAMP() | CURRENT_TIMESTAMP | - |-----------------------+---------------------| - | 2022-08-02 15:54:19 | 2022-08-02 15:54:19 | - +-----------------------+---------------------+ - - -LOCALTIMESTAMP --------------- - -Description ->>>>>>>>>>> - -`LOCALTIMESTAMP` and `LOCALTIMESTAMP()` are synonyms for `NOW() <#now>`_. - -Example:: - - > SELECT LOCALTIMESTAMP(), LOCALTIMESTAMP; - fetched rows / total rows = 1/1 - +---------------------+---------------------+ - | LOCALTIMESTAMP() | LOCALTIMESTAMP | - |---------------------+---------------------| - | 2022-08-02 15:54:19 | 2022-08-02 15:54:19 | - +---------------------+---------------------+ - - -LOCALTIME ---------- - -Description ->>>>>>>>>>> - -`LOCALTIME` and `LOCALTIME()` are synonyms for `NOW() <#now>`_. - -Example:: - - > SELECT LOCALTIME(), LOCALTIME; - fetched rows / total rows = 1/1 - +---------------------+---------------------+ - | LOCALTIME() | LOCALTIME | - |---------------------+---------------------| - | 2022-08-02 15:54:19 | 2022-08-02 15:54:19 | - +---------------------+---------------------+ - - -SYSDATE -------- - -Description ->>>>>>>>>>> - -Returns the current date and time as a value in 'YYYY-MM-DD hh:mm:ss[.nnnnnn]'. -SYSDATE() returns the time at which it executes. This differs from the behavior for `NOW() <#now>`_, which returns a constant time that indicates the time at which the statement began to execute. -If the argument is given, it specifies a fractional seconds precision from 0 to 6, the return value includes a fractional seconds part of that many digits. - -Optional argument type: INTEGER - -Return type: DATETIME - -Specification: SYSDATE([INTEGER]) -> DATETIME - -Example:: - - > SELECT SYSDATE() as value_1, SYSDATE(6) as value_2; - fetched rows / total rows = 1/1 - +---------------------+----------------------------+ - | value_1 | value_2 | - |---------------------+----------------------------| - | 2022-08-02 15:39:05 | 2022-08-02 15:39:05.123456 | - +---------------------+----------------------------+ - - -CURTIME -------- - -Description ->>>>>>>>>>> - -Returns the current time as a value in 'hh:mm:ss'. -CURTIME() returns the time at which the statement began to execute as `NOW() <#now>`_ does. - -Return type: TIME - -Specification: CURTIME() -> TIME - -Example:: - - > SELECT CURTIME() as value_1, CURTIME() as value_2; - fetched rows / total rows = 1/1 - +-----------+-----------+ - | value_1 | value_2 | - |-----------+-----------| - | 15:39:05 | 15:39:05 | - +-----------+-----------+ - - -CURRENT_TIME ------------- - -Description ->>>>>>>>>>> - -`CURRENT_TIME` and `CURRENT_TIME()` are synonyms for `CURTIME() <#curtime>`_. - -Example:: - - > SELECT CURRENT_TIME(), CURRENT_TIME; - fetched rows / total rows = 1/1 - +-----------------+----------------+ - | CURRENT_TIME() | CURRENT_TIME | - |-----------------+----------------| - | 15:39:05 | 15:39:05 | - +-----------------+----------------+ - - -CURDATE -------- - -Description ->>>>>>>>>>> - -Returns the current time as a value in 'YYYY-MM-DD'. -CURDATE() returns the time at which it executes as `SYSDATE() <#sysdate>`_ does. - -Return type: DATE - -Specification: CURDATE() -> DATE - -Example:: - - > SELECT CURDATE(); - fetched rows / total rows = 1/1 - +-------------+ - | CURDATE() | - |-------------| - | 2022-08-02 | - +-------------+ - - -CURRENT_DATE ------------- - -Description ->>>>>>>>>>> - -`CURRENT_DATE` and `CURRENT_DATE()` are synonyms for `CURDATE() <#curdate>`_. - -Example:: - - > SELECT CURRENT_DATE(), CURRENT_DATE; - fetched rows / total rows = 1/1 - +------------------+----------------+ - | CURRENT_DATE() | CURRENT_DATE | - |------------------+----------------| - | 2022-08-02 | 2022-08-02 | - +------------------+----------------+ - - QUARTER ------- @@ -1877,6 +1839,33 @@ Example:: +------------------------------------------------+----------------------------------+------------------------------------------------+ +SYSDATE +------- + +Description +>>>>>>>>>>> + +Returns the current date and time as a value in 'YYYY-MM-DD hh:mm:ss[.nnnnnn]'. +SYSDATE() returns the time at which it executes. This differs from the behavior for `NOW() <#now>`_, which returns a constant time that indicates the time at which the statement began to execute. +If the argument is given, it specifies a fractional seconds precision from 0 to 6, the return value includes a fractional seconds part of that many digits. + +Optional argument type: INTEGER + +Return type: DATETIME + +Specification: SYSDATE([INTEGER]) -> DATETIME + +Example:: + + > SELECT SYSDATE() as value_1, SYSDATE(6) as value_2; + fetched rows / total rows = 1/1 + +---------------------+----------------------------+ + | value_1 | value_2 | + |---------------------+----------------------------| + | 2022-08-02 15:39:05 | 2022-08-02 15:39:05.123456 | + +---------------------+----------------------------+ + + TIME ---- diff --git a/docs/user/ppl/functions/datetime.rst b/docs/user/ppl/functions/datetime.rst index 7e310879220..e6ff88d2a8c 100644 --- a/docs/user/ppl/functions/datetime.rst +++ b/docs/user/ppl/functions/datetime.rst @@ -171,6 +171,112 @@ Example:: | 2008-02-02 01:59:00 | +-------------------------------------------------------+ + +CURDATE +------- + +Description +>>>>>>>>>>> + +Returns the current time as a value in 'YYYY-MM-DD'. +CURDATE() returns the time at which it executes as `SYSDATE() <#sysdate>`_ does. + +Return type: DATE + +Specification: CURDATE() -> DATE + +Example:: + + > source=people | eval `CURDATE()` = CURDATE() | fields `CURDATE()` + fetched rows / total rows = 1/1 + +-------------+ + | CURDATE() | + |-------------| + | 2022-08-02 | + +-------------+ + + +CURRENT_DATE +------------ + +Description +>>>>>>>>>>> + +`CURRENT_DATE` and `CURRENT_DATE()` are synonyms for `CURDATE() <#curdate>`_. + +Example:: + + > source=people | eval `CURRENT_DATE()` = CURRENT_DATE(), `CURRENT_DATE` = CURRENT_DATE | fields `CURRENT_DATE()`, `CURRENT_DATE` + fetched rows / total rows = 1/1 + +------------------+----------------+ + | CURRENT_DATE() | CURRENT_DATE | + |------------------+----------------| + | 2022-08-02 | 2022-08-02 | + +------------------+----------------+ + + +CURRENT_TIME +------------ + +Description +>>>>>>>>>>> + +`CURRENT_TIME` and `CURRENT_TIME()` are synonyms for `CURTIME() <#curtime>`_. + +Example:: + + > source=people | eval `CURRENT_TIME()` = CURRENT_TIME(), `CURRENT_TIME` = CURRENT_TIME | fields `CURRENT_TIME()`, `CURRENT_TIME` + fetched rows / total rows = 1/1 + +------------------+----------------+ + | CURRENT_TIME() | CURRENT_TIME | + |------------------+----------------| + | 15:39:05 | 15:39:05 | + +------------------+----------------+ + + +CURRENT_TIMESTAMP +----------------- + +Description +>>>>>>>>>>> + +`CURRENT_TIMESTAMP` and `CURRENT_TIMESTAMP()` are synonyms for `NOW() <#now>`_. + +Example:: + + > source=people | eval `CURRENT_TIMESTAMP()` = CURRENT_TIMESTAMP(), `CURRENT_TIMESTAMP` = CURRENT_TIMESTAMP | fields `CURRENT_TIMESTAMP()`, `CURRENT_TIMESTAMP` + fetched rows / total rows = 1/1 + +-----------------------+---------------------+ + | CURRENT_TIMESTAMP() | CURRENT_TIMESTAMP | + |-----------------------+---------------------| + | 2022-08-02 15:54:19 | 2022-08-02 15:54:19 | + +-----------------------+---------------------+ + + +CURTIME +------- + +Description +>>>>>>>>>>> + +Returns the current time as a value in 'hh:mm:ss'. +CURTIME() returns the time at which the statement began to execute as `NOW() <#now>`_ does. + +Return type: TIME + +Specification: CURTIME() -> TIME + +Example:: + + > source=people | eval `value_1` = CURTIME(), `value_2` = CURTIME() | fields `value_1`, `value_2` + fetched rows / total rows = 1/1 + +-----------+-----------+ + | value_1 | value_2 | + |-----------+-----------| + | 15:39:05 | 15:39:05 | + +-----------+-----------+ + + DATE ---- @@ -608,6 +714,44 @@ Example:: +--------------------------+ +LOCALTIMESTAMP +-------------- + +Description +>>>>>>>>>>> + +`LOCALTIMESTAMP` and `LOCALTIMESTAMP()` are synonyms for `NOW() <#now>`_. + +Example:: + + > source=people | eval `LOCALTIMESTAMP()` = LOCALTIMESTAMP(), `LOCALTIMESTAMP` = LOCALTIMESTAMP | fields `LOCALTIMESTAMP()`, `LOCALTIMESTAMP` + fetched rows / total rows = 1/1 + +---------------------+---------------------+ + | LOCALTIMESTAMP() | LOCALTIMESTAMP | + |---------------------+---------------------| + | 2022-08-02 15:54:19 | 2022-08-02 15:54:19 | + +---------------------+---------------------+ + + +LOCALTIME +--------- + +Description +>>>>>>>>>>> + +`LOCALTIME` and `LOCALTIME()` are synonyms for `NOW() <#now>`_. + +Example:: + + > source=people | eval `LOCALTIME()` = LOCALTIME(), `LOCALTIME` = LOCALTIME | fields `LOCALTIME()`, `LOCALTIME` + fetched rows / total rows = 1/1 + +---------------------+---------------------+ + | LOCALTIME() | LOCALTIME | + |---------------------+---------------------| + | 2022-08-02 15:54:19 | 2022-08-02 15:54:19 | + +---------------------+---------------------+ + + MAKEDATE -------- @@ -790,176 +934,6 @@ Example:: +---------------------+---------------------+ -CURRENT_TIMESTAMP ------------------ - -Description ->>>>>>>>>>> - -`CURRENT_TIMESTAMP` and `CURRENT_TIMESTAMP()` are synonyms for `NOW() <#now>`_. - -Example:: - - > source=people | eval `CURRENT_TIMESTAMP()` = CURRENT_TIMESTAMP(), `CURRENT_TIMESTAMP` = CURRENT_TIMESTAMP | fields `CURRENT_TIMESTAMP()`, `CURRENT_TIMESTAMP` - fetched rows / total rows = 1/1 - +-----------------------+---------------------+ - | CURRENT_TIMESTAMP() | CURRENT_TIMESTAMP | - |-----------------------+---------------------| - | 2022-08-02 15:54:19 | 2022-08-02 15:54:19 | - +-----------------------+---------------------+ - - -LOCALTIMESTAMP --------------- - -Description ->>>>>>>>>>> - -`LOCALTIMESTAMP` and `LOCALTIMESTAMP()` are synonyms for `NOW() <#now>`_. - -Example:: - - > source=people | eval `LOCALTIMESTAMP()` = LOCALTIMESTAMP(), `LOCALTIMESTAMP` = LOCALTIMESTAMP | fields `LOCALTIMESTAMP()`, `LOCALTIMESTAMP` - fetched rows / total rows = 1/1 - +---------------------+---------------------+ - | LOCALTIMESTAMP() | LOCALTIMESTAMP | - |---------------------+---------------------| - | 2022-08-02 15:54:19 | 2022-08-02 15:54:19 | - +---------------------+---------------------+ - - -LOCALTIME ---------- - -Description ->>>>>>>>>>> - -`LOCALTIME` and `LOCALTIME()` are synonyms for `NOW() <#now>`_. - -Example:: - - > source=people | eval `LOCALTIME()` = LOCALTIME(), `LOCALTIME` = LOCALTIME | fields `LOCALTIME()`, `LOCALTIME` - fetched rows / total rows = 1/1 - +---------------------+---------------------+ - | LOCALTIME() | LOCALTIME | - |---------------------+---------------------| - | 2022-08-02 15:54:19 | 2022-08-02 15:54:19 | - +---------------------+---------------------+ - - -SYSDATE -------- - -Description ->>>>>>>>>>> - -Returns the current date and time as a value in 'YYYY-MM-DD hh:mm:ss[.nnnnnn]'. -SYSDATE() returns the time at which it executes. This differs from the behavior for `NOW() <#now>`_, which returns a constant time that indicates the time at which the statement began to execute. -If the argument is given, it specifies a fractional seconds precision from 0 to 6, the return value includes a fractional seconds part of that many digits. - -Optional argument type: INTEGER - -Return type: DATETIME - -Specification: SYSDATE([INTEGER]) -> DATETIME - -Example:: - - > source=people | eval `value_1` = SYSDATE(), `value_2` = SYSDATE(6) | fields `value_1`, `value_2` - fetched rows / total rows = 1/1 - +---------------------+----------------------------+ - | value_1 | value_2 | - |---------------------+----------------------------| - | 2022-08-02 15:39:05 | 2022-08-02 15:39:05.123456 | - +---------------------+----------------------------+ - - -CURTIME -------- - -Description ->>>>>>>>>>> - -Returns the current time as a value in 'hh:mm:ss'. -CURTIME() returns the time at which the statement began to execute as `NOW() <#now>`_ does. - -Return type: TIME - -Specification: CURTIME() -> TIME - -Example:: - - > source=people | eval `value_1` = CURTIME(), `value_2` = CURTIME() | fields `value_1`, `value_2` - fetched rows / total rows = 1/1 - +-----------+-----------+ - | value_1 | value_2 | - |-----------+-----------| - | 15:39:05 | 15:39:05 | - +-----------+-----------+ - - -CURRENT_TIME ------------- - -Description ->>>>>>>>>>> - -`CURRENT_TIME` and `CURRENT_TIME()` are synonyms for `CURTIME() <#curtime>`_. - -Example:: - - > source=people | eval `CURRENT_TIME()` = CURRENT_TIME(), `CURRENT_TIME` = CURRENT_TIME | fields `CURRENT_TIME()`, `CURRENT_TIME` - fetched rows / total rows = 1/1 - +------------------+----------------+ - | CURRENT_TIME() | CURRENT_TIME | - |------------------+----------------| - | 15:39:05 | 15:39:05 | - +------------------+----------------+ - - -CURDATE -------- - -Description ->>>>>>>>>>> - -Returns the current time as a value in 'YYYY-MM-DD'. -CURDATE() returns the time at which it executes as `SYSDATE() <#sysdate>`_ does. - -Return type: DATE - -Specification: CURDATE() -> DATE - -Example:: - - > source=people | eval `CURDATE()` = CURDATE() | fields `CURDATE()` - fetched rows / total rows = 1/1 - +-------------+ - | CURDATE() | - |-------------| - | 2022-08-02 | - +-------------+ - - -CURRENT_DATE ------------- - -Description ->>>>>>>>>>> - -`CURRENT_DATE` and `CURRENT_DATE()` are synonyms for `CURDATE() <#curdate>`_. - -Example:: - - > source=people | eval `CURRENT_DATE()` = CURRENT_DATE(), `CURRENT_DATE` = CURRENT_DATE | fields `CURRENT_DATE()`, `CURRENT_DATE` - fetched rows / total rows = 1/1 - +------------------+----------------+ - | CURRENT_DATE() | CURRENT_DATE | - |------------------+----------------| - | 2022-08-02 | 2022-08-02 | - +------------------+----------------+ - - QUARTER ------- @@ -1037,6 +1011,33 @@ Example:: +------------------------------------------------+----------------------------------+------------------------------------------------+ +SYSDATE +------- + +Description +>>>>>>>>>>> + +Returns the current date and time as a value in 'YYYY-MM-DD hh:mm:ss[.nnnnnn]'. +SYSDATE() returns the time at which it executes. This differs from the behavior for `NOW() <#now>`_, which returns a constant time that indicates the time at which the statement began to execute. +If the argument is given, it specifies a fractional seconds precision from 0 to 6, the return value includes a fractional seconds part of that many digits. + +Optional argument type: INTEGER + +Return type: DATETIME + +Specification: SYSDATE([INTEGER]) -> DATETIME + +Example:: + + > source=people | eval `value_1` = SYSDATE(), `value_2` = SYSDATE(6) | fields `value_1`, `value_2` + fetched rows / total rows = 1/1 + +---------------------+----------------------------+ + | value_1 | value_2 | + |---------------------+----------------------------| + | 2022-08-02 15:39:05 | 2022-08-02 15:39:05.123456 | + +---------------------+----------------------------+ + + TIME ----