Add support for Date, filled documentation

dbms/src/Functions/FunctionsDateTime.h

@@ -1618,6 +1618,7 @@ private:
 
     public:
 
+        // format DateTime
         void action(char *& target, UInt32 source, const DateLUTImpl & timezone)
         {
             if(operation)
@@ -1626,6 +1627,13 @@ private:
                 copy(target, source, timezone);
         }
 
+        // format Date (convert to DateTime implicitly)
+        void action(char *& target, UInt16 date, const DateLUTImpl & timezone)
+        {
+            const UInt32 datetime = timezone.fromDayNum(DayNum(date));
+            action(target, datetime, timezone);
+        }
+
         void copy(char *& target, UInt32 , const DateLUTImpl & )
         {
             auto tmp = source + source_position_to_copy;
@@ -1696,9 +1704,7 @@ private:
 
         static void format_j(char *& target, UInt32 source, const DateLUTImpl & timezone)
         {
-            auto today = timezone.toDayNum(source);
-            auto first_year_day = ToStartOfYearImpl::execute(source, timezone);
-            writeNumberWidth(target, today - first_year_day + 1, 3);
+            writeNumberWidth(target, ToDayOfYearImpl::execute(source, timezone), 3);
         }
 
         static void format_m(char *& target, UInt32 source, const DateLUTImpl & timezone)
@@ -1832,7 +1838,7 @@ public:
                             + toString(arguments.size()) + ", should be 2 or 3",
                             ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH);
 
-        if (!WhichDataType(arguments[0].type).isDateTime())
+        if (!WhichDataType(arguments[0].type).isDateOrDateTime())
             throw Exception("Illegal type " + arguments[0].type->getName() + " of 1 argument of function " + getName() +
                             ". Should be a date or a date with time", ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT);
 
@@ -1852,12 +1858,17 @@ public:
 
     void executeImpl(Block & block, const ColumnNumbers & arguments, size_t result, size_t /*input_rows_count*/) override
     {
-        auto times = checkAndGetColumn<ColumnUInt32>(block.getByPosition(arguments[0]).column.get());
-        auto const_times = checkAndGetColumnConst<ColumnUInt32>(block.getByPosition(arguments[0]).column.get());
-
-        if (const_times)
-            throw Exception("Constant times are not supported yet");
+        if (!executeType<UInt32>(block, arguments, result) && !executeType<UInt16>(block, arguments, result))
+            throw Exception("Illegal column " + block.getByPosition(arguments[0]).column->getName()
+                            + "  of function " + getName() + ", must be Date or DateTime",
+                            ErrorCodes::ILLEGAL_COLUMN);
+    }
 
+    template <typename T>
+    bool executeType(Block & block, const ColumnNumbers & arguments, size_t result)
+    {
+        if (auto * times = checkAndGetColumn<ColumnVector<T>>(block.getByPosition(arguments[0]).column.get()))
+        {
             const ColumnConst * pattern_column = checkAndGetColumnConst<ColumnString>(block.getByPosition(arguments[1]).column.get());
 
             if (!pattern_column)
@@ -1879,7 +1890,7 @@ public:
 
             const DateLUTImpl & time_zone = *time_zone_tmp;
 
-        const ColumnUInt32::Container & vec = times->getData();
+            const typename ColumnVector<T>::Container & vec = times->getData();
 
             auto col_res = ColumnString::create();
             auto & dst_data = col_res->getChars();
@@ -1898,9 +1909,14 @@ public:
                 *pos++ = '\0';
                 dst_offsets[i] = pos - begin;
             }
+            dst_data.resize(pos - begin);
 
             block.getByPosition(result).column = std::move(col_res);
 
+            return true;
+        }
+
+        return false;
     }
 
     size_t parsePattern(String & pattern, std::vector<FormattingOperation> & instructions)

dbms/tests/queries/0_stateless/00718_format_datetime.reference

@@ -27,3 +27,5 @@ PM
 2018
 %
 no formatting pattern
+2018-01-01 00:00:00
+2018-01-01 01:00:00	2018-01-01 04:00:00

dbms/tests/queries/0_stateless/00718_format_datetime.sql

@@ -3,7 +3,8 @@ SELECT formatDateTime('not a datetime', 'IGNORED'); -- { serverError 43 }
 SELECT formatDateTime(now(), now()); -- { serverError 43 }
 SELECT formatDateTime(now(), 'good format pattern', now()); -- { serverError 43 }
 SELECT formatDateTime(now(), 'unescaped %'); -- { serverError 36 }
-
+SELECT formatDateTime(toDateTime('2018-01-02 22:33:44'), '%U'); -- { serverError 43 }
+SELECT formatDateTime(toDateTime('2018-01-02 22:33:44'), '%W'); -- { serverError 43 }
 
 SELECT formatDateTime(toDateTime('2018-01-02 22:33:44'), '%C');
 SELECT formatDateTime(toDateTime('2018-01-02 22:33:44'), '%d');
@@ -30,10 +31,13 @@ SELECT formatDateTime(toDateTime('2018-01-02 22:33:44'), '%T');
 SELECT formatDateTime(toDateTime('2018-01-01 22:33:44'), '%u'), formatDateTime(toDateTime('2018-01-07 22:33:44'), '%u');
 SELECT formatDateTime(toDateTime('1996-01-01 22:33:44'), '%V'), formatDateTime(toDateTime('1996-12-31 22:33:44'), '%V'),
        formatDateTime(toDateTime('1999-01-01 22:33:44'), '%V'), formatDateTime(toDateTime('1999-12-31 22:33:44'), '%V');
-SELECT formatDateTime(toDateTime('2018-01-02 22:33:44'), '%U'); -- { serverError 43 }
-SELECT formatDateTime(toDateTime('2018-01-02 22:33:44'), '%W'); -- { serverError 43 }
 SELECT formatDateTime(toDateTime('2018-01-01 22:33:44'), '%w'), formatDateTime(toDateTime('2018-01-07 22:33:44'), '%w');
 SELECT formatDateTime(toDateTime('2018-01-02 22:33:44'), '%y');
 SELECT formatDateTime(toDateTime('2018-01-02 22:33:44'), '%Y');
 SELECT formatDateTime(toDateTime('2018-01-02 22:33:44'), '%%');
 SELECT formatDateTime(toDateTime('2018-01-02 22:33:44'), 'no formatting pattern');
+
+SELECT formatDateTime(toDate('2018-01-01'), '%F %T');
+SELECT
+    formatDateTime(toDateTime('2018-01-01 01:00:00', 'UTC'), '%F %T', 'UTC'),
+    formatDateTime(toDateTime('2018-01-01 01:00:00', 'UTC'), '%F %T', 'Europe/Moscow')

docs/en/query_language/functions/date_time_functions.md

@@ -151,3 +151,34 @@ For a time interval starting at 'StartTime' and continuing for 'Duration' second
 For example, `timeSlots(toDateTime('2012-01-01 12:20:00'), 600) = [toDateTime('2012-01-01 12:00:00'), toDateTime('2012-01-01 12:30:00')]`.
 This is necessary for searching for pageviews in the corresponding session.
 
+## formatDateTime(Time, Format\[, Timezone\])
+
+Function formats a Time according given Format string. N.B.: Format is a constant expression, e.g. you can not have multiple formats for single result column.
+
+Supported modifiers for Format:
+("Example" column shows formatting result for time `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|%|

docs/ru/query_language/functions/date_time_functions.md

@@ -122,3 +122,34 @@ SELECT
 Для интервала времени, начинающегося в StartTime и продолжающегося Duration секунд, возвращает массив моментов времени, состоящий из округлений вниз до получаса точек из этого интервала.
 Например, `timeSlots(toDateTime('2012-01-01 12:20:00'), toUInt32(600)) = [toDateTime('2012-01-01 12:00:00'), toDateTime('2012-01-01 12:30:00')]`.
 Это нужно для поиска хитов, входящих в соответствующий визит.
+
+## formatDateTime(Time, Format\[, Timezone\])
+Функция преобразования даты-с-временем в String согласно заданному шаблону. Важно - шаблон является константным выражением, т.е. невозможно использование разных шаблонов в одной колонке.
+
+Поддерживаемые модификаторы в шаблоне Format:
+(колонка "Пример" показана для времени `2018-01-02 22:33:44`)
+
+| Модификатор | Описание | Пример |
+| ----------- | -------- | --------------- |
+|%C|номер года, поделённый на 100 (00-99)|20
+|%d|день месяца, с ведущим нулём (01-31)|02
+|%D|короткая запись %m/%d/%y|01/02/2018|
+|%e|день месяца, с ведущим пробелом ( 1-31)|  2|
+|%F|короткая запись %Y-%m-%d|2018-01-02
+|%H|час в 24-часовом формате (00-23)|22|
+|%I|час в 12-часовом формате (01-12)|10|
+|%j|номер дня в году, с ведущими нулями (001-366)|002|
+|%m|месяц, с ведущим нулём (01-12)|01|
+|%M|минуты, с ведущим нулём (00-59)|33|
+|%n|символ переноса строки ('\n')||
+|%p|обозначения AM или PM|PM|
+|%R|короткая запись %H:%M|22:33|
+|%S|секунды, с ведущими нулями (00-59)|44|
+|%t|символ табуляции ('\t')||
+|%T|формат времени ISO 8601, одинаковый с %H:%M:%S|22:33:44|
+|%u|номер дня недели согласно ISO 8601, понедельник - 1, воскресенье - 7|2|
+|%V|номер недели согласно ISO 8601 (01-53)|01|
+|%w|номер дня недели, начиная с воскресенья (0-6)|2|
+|%y|год, последние 2 цифры (00-99)|18|
+|%Y|год, 4 цифры|2018|
+|%%|символ %|%|