# Функции даты

Если данные не распознаются как дата, необходимо применить к столбцу с данными функцию Преобразовать в дату. Только после этого можно применять другие функции, связанные с датами. Информация о формате нужна только для настройки формата отображаемой даты, а не для разбора текста, который не был распознан как дата.

## Добавить длительность

Добавляет период в указанной единице времени к дате, времени или метке времени

### Свойства

| Свойство | Конфигурация |
| --- | --- |
| Columns to process (Столбцы для обработки) | Выберите один или несколько столбцов, к которым будет применена функция.<br><br>Чтобы применить функцию к нескольким столбцам, выберите столбцы в раскрывающемся списке и нажмите Применить. |
| Единица времени | Выберите, к какой части даты, времени или метки времени требуется добавить значение времени:<br><br><ul> <li> <p>Год</p> </li> <li> <p>Месяц</p> </li> <li> <p>Неделя</p> </li> <li> <p>День</p> </li> <li> <p>Час</p> </li> <li> <p>Минута</p> </li> <li> <p>Секунда</p> </li> <li> <p>Миллисекунда</p> </li> <li> <p>Микросекунда</p> </li> </ul> |
| Использовать с | <ul> <li> <p><span>Значение</span>: выберите эту опцию, чтобы добавить фиксированное значение (задается в поле <span>Значение</span>).</p> </li> <li> <p><span>Другой столбец</span>: выберите эту опцию, чтобы добавить значение из другого столбца, выбранного в раскрывающемся списке <span>Столбец</span>.</p> </li> </ul> |
| Create new column (Создать новый столбец) | Установите этот флажок, если вы хотите вывести результат этой функции в новый столбец и сохранить исходный без изменений. |

### Пример

| Входные данные | Конфигурация | Выходные данные |
| --- | --- | --- |
| 03/03/2023 | <ul> <li> <p>Единица измерения времени: «Год»</p> </li> <li> <p>Использовать с: Значение</p> </li> <li> <p>Значение: 10</p> </li> </ul> | 03/03/2033 |
| 3/7/2019 2:00:00 PM | <ul> <li> <p>Единица измерения времени: «Секунды»</p> </li> <li> <p>Использовать с: Значение</p> </li> <li> <p>Значение: 30</p> </li> </ul> | 3/7/2019 2:00:30 PM |

## Вычислить разницу дат

Вычисляет время между датами в столбце и указанной датой с учетом выбранной единицы измерения времени.

Для вычисления сначала выполняется усечение дат до указанной части даты или времени, а затем возвращается разница между ними в виде целого числа.

### Свойства

| Свойство | Конфигурация |
| --- | --- |
| Columns to process (Столбцы для обработки) | Выберите один или несколько столбцов, к которым будет применена функция.<br><br>Чтобы применить функцию к нескольким столбцам, выберите столбцы в раскрывающемся списке и нажмите Применить. |
| Единица времени | Выберите часть времени, которая будет использована в расчетах:<br><br><ul> <li> <p>Год</p> </li> <li> <p>Месяц</p> </li> <li> <p>День</p> </li> <li> <p>Час</p> </li> <li> <p>Минута</p> </li> <li> <p>Секунда</p> </li> <li> <p>Миллисекунда</p> </li> <li> <p>Микросекунда</p> </li> </ul> |
| До | Выберите, как будет задана целевая дата:<br><br><ul> <li> <p><span>Теперь</span> можно вычислить разницу с текущей датой и временем.</p> </li> <li> <p><span>Конкретная дата</span>: введите нужную дату или задайте ее в поле <span>Эта дата</span>, используя календарь.</p> </li> <li> <p><span>Другой столбец</span>: используйте даты из другого столбца, выбранного в раскрывающемся списке <span>Столбец</span>.</p> </li> </ul> |
| Create new column (Создать новый столбец) | Установите этот флажок, если вы хотите вывести результат этой функции в новый столбец и сохранить исходный без изменений. |

### Пример

| Входные данные | Конфигурация | Выходные данные |
| --- | --- | --- |
| 06/12/1989 | <ul> <li> <p>Единица измерения времени: «День»</p> </li> <li> <p>До: «Конкретная дата»</p> </li> <li> <p>Эта дата: 31/12/2000</p> </li> </ul> | 4044 |
| <ul> <li> <p>Столбец A: 8/4/2016</p> </li> <li> <p>Столбец B: 8/4/2025</p> </li> </ul> | <ul> <li> <p>Время до: «Неделя»</p> </li> <li> <p>До: «Другой столбец»</p> </li> <li> <p>Столбец: B</p> </li> </ul> | 468 |

## Сравнить даты

Сравнивает даты из столбца с заданным значением или значениями из другого столбца. Функция возвращает TRUE, если выполняется условие, заданное оператором; в противном случае она возвращает FALSE.

Время можно сравнивать только со значениями времени, но можно также сравнивать даты и метки времени. В этом случае дата будет интерпретироваться как метка времени со временем, установленным на 00:00.

### Свойства

| Свойство | Конфигурация |
| --- | --- |
| Columns to process (Столбцы для обработки) | Выберите один или несколько столбцов, к которым будет применена функция.<br><br>Чтобы применить функцию к нескольким столбцам, выберите столбцы в раскрывающемся списке и нажмите Применить. |
| Режим сравнения | Выберите оператор, который будет использоваться для сравнения дат.<br><br><ul> <li> <p>Равно</p> </li> <li> <p>Не равно</p> </li> <li> <p>После</p> </li> <li> <p>После или равно</p> </li> <li> <p>До</p> </li> <li> <p>До или равно</p> </li> </ul> |
| Использовать с | <ul> <li> <p><span>Значение</span>: выберите эту опцию, чтобы проверить столбец относительно фиксированного значения, заданного в календаре <span>Значение</span>. Выберите даты в формате мм/дд/гггг.</p> <div><span>Примечание к информации</span>Если вы ранее настроили эту функцию с фиксированной датой в другом формате, будут предприняты попытки проанализировать ввод, чтобы отобразить ее правильно в новом поле ввода даты. Однако, если вы видите пустое поле ввода, возможно, вам потребуется перенастроить <span>Значение</span>.</div> </li> <li> <p><span>Другой столбец</span>: выберите эту опцию, чтобы проверить столбец относительно значений в другом столбце, выбранном в раскрывающемся списке <span>Столбец</span> .</p> </li> </ul> |
| Create new column (Создать новый столбец) | Установите этот флажок, если вы хотите вывести результат этой функции в новый столбец и сохранить исходный без изменений. |

### Пример

| Входные данные | Конфигурация | Выходные данные |
| --- | --- | --- |
| <ul> <li> <p>1969-02-27</p> </li> <li> <p>1989-11-09</p> </li> </ul> | <ul> <li> <p>Режим сравнения: «После»</p> </li> <li> <p>Использовать с: Значение</p> </li> <li> <p>Значение: 01/01/1989</p> </li> </ul> | <ul> <li> <p>FALSE</p> </li> <li> <p>TRUE</p> </li> </ul> |

## Преобразовать в дату

Преобразует тип данных, содержащихся в столбце, так, чтобы они интерпретировались в системе как даты.

### Свойства

| Свойство | Конфигурация |
| --- | --- |
| Columns to process (Столбцы для обработки) | Выберите один или несколько столбцов, к которым будет применена функция.<br><br>Чтобы применить функцию к нескольким столбцам, выберите столбцы в раскрывающемся списке и нажмите Применить. |
| Формат даты | Выберите ожидаемый формат даты для столбца.<br><br><ul> <li> <p>«Автоматически»: текущий формат будет определяться автоматически.</p> </li> <li> <p>«Пользовательский»: введите свой формат даты (задается в поле <span>Образец даты</span>).</p> </li> <li> <p>ГГГГ-ММ-ДД</p> </li> <li> <p>ГГГГММДД</p> </li> <li> <p>М/Д/ГГГГ</p> </li> <li> <p>М/Д/ГГ</p> </li> <li> <p>ММ/ДД/ГГ</p> </li> <li> <p>МММ Д, ГГГГ</p> </li> <li> <p>ММММ Д,&nbsp;ГГГГ</p> </li> </ul> |
| Create new column (Создать новый столбец) | Установите этот флажок, если вы хотите вывести результат этой функции в новый столбец и сохранить исходный без изменений. |

## Преобразовать во время

Преобразует тип данных, содержащихся в столбце, так, чтобы они интерпретировались в системе как время.

### Свойства

| Свойство | Конфигурация |
| --- | --- |
| Columns to process (Столбцы для обработки) | Выберите один или несколько столбцов, к которым будет применена функция.<br><br>Чтобы применить функцию к нескольким столбцам, выберите столбцы в раскрывающемся списке и нажмите Применить. |
| Формат даты | Выберите ожидаемый формат времени для столбца.<br><br><ul> <li> <p>«Автоматически»: текущий формат будет определяться автоматически.</p> </li> <li> <p>«Пользовательский»: введите свой формат времени (задается в поле <span>Образец даты</span>).</p> </li> <li> <p>чч:мм</p> </li> <li> <p>чч:мм:сс</p> </li> <li> <p>чч:мм AM/PM</p> </li> <li> <p>чч:мм:сс AM/PM</p> </li> </ul> |
| Create new column (Создать новый столбец) | Установите этот флажок, если вы хотите вывести результат этой функции в новый столбец и сохранить исходный без изменений. |

## Преобразовать в метку времени

Преобразует тип данных, содержащихся в столбце, так, чтобы они интерпретировались в системе как метка времени.

### Свойства

| Свойство | Конфигурация |
| --- | --- |
| Columns to process (Столбцы для обработки) | Выберите один или несколько столбцов, к которым будет применена функция.<br><br>Чтобы применить функцию к нескольким столбцам, выберите столбцы в раскрывающемся списке и нажмите Применить. |
| Формат даты | Выберите ожидаемый формат метки времени для столбца.<br><br><ul> <li> <p>«Автоматически»: текущий формат будет определяться автоматически.</p> </li> <li> <p>«Пользовательский»: введите свой формат метки времени (задается в поле <span>Образец даты</span>).</p> </li> <li> <p>ГГГГММДД чч:мм</p> </li> <li> <p>ГГГГММДД чч:мм:сс</p> </li> <li> <p>ГГГГММДДТчч:мм</p> </li> <li> <p>ГГГГММДДТчч:мм:сс</p> </li> <li> <p>М/Д/ГГГГ чч:мм AM/PM</p> </li> <li> <p>М/Д/ГГ чч:мм AM/PM</p> </li> <li> <p>ММ/ДД/ГГ чч:мм AM/PM</p> </li> <li> <p>М/Д/ГГГГ чч:мм:сс &nbsp;AM/PM</p> </li> <li> <p>М/Д/ГГ чч:мм:сс AM/PM</p> </li> <li> <p>ММ/ДД/ГГ ЧЧ:мм:сс&nbsp;AM/PM</p> </li> <li> <p>МММ Д, ГГГГ чч:мм:сс AM/PM</p> </li> <li> <p>День недели, ММММ Д, ГГГГ чч:мм:сс AM/PM</p> </li> </ul> |
| Create new column (Создать новый столбец) | Установите этот флажок, если вы хотите вывести результат этой функции в новый столбец и сохранить исходный без изменений. |

## Создать дату из частей

Создает столбец с новой датой путем объединения чисел из других столбцов

### Свойства

| Свойство | Конфигурация |
| --- | --- |
| Год | Выберите столбец, содержащий информацию о годе для получаемой даты. |
| Месяц | Выберите столбец, содержащий информацию о месяце для получаемой даты. |
| День | Выберите столбец, содержащий информацию о дне для получаемой даты. |
| Имя нового столбца | Введите имя столбца, который будет создан для сохранения результата объединения. Если оставить поле пустым, будет присвоено имя по умолчанию `new_date`. |

### Пример

| Входные данные | Конфигурация | Выходные данные |
| --- | --- | --- |
| <ul> <li> <p>Столбец А: 10</p> </li> <li> <p>Столбец В:&nbsp;2021</p> </li> <li> <p>Столбец С: 12</p> </li> </ul> | <ul> <li> <p>Год: Столбец B</p> </li> <li> <p>Месяц: Столбец A</p> </li> <li> <p>День: Столбец C</p> </li> </ul> | Столбец D: 10/21/2021 |

## Создать время из частей

Создает столбец с новым значением времени, полученным путем объединения чисел из других столбцов

### Свойства

| Свойство | Конфигурация |
| --- | --- |
| Час | Выберите столбец, содержащий информацию о часах для получаемого значения времени. |
| Минута | Выберите столбец, содержащий информацию о минутах для получаемого значения времени. |
| Секунда | Выберите столбец, содержащий информацию о секундах для получаемого значения времени. |
| Миллисекунда | Выберите столбец, содержащий информацию о миллисекундах для получаемого значения времени. |
| Имя нового столбца | Введите имя столбца, который будет создан для сохранения результата объединения. Если оставить поле пустым, будет присвоено имя по умолчанию `new_time`. |

### Пример

| Входные данные | Конфигурация | Выходные данные |
| --- | --- | --- |
| <ul> <li> <p>Столбец А: 9</p> </li> <li> <p>Столбец В: 1</p> </li> <li> <p>Столбец С: 30</p> </li> <li> <p>Столбец D: 56</p> </li> </ul> | <ul> <li> <p>Час: Столбец A</p> </li> <li> <p>Минута: Столбец D</p> </li> <li> <p>Секунда: Столбец C</p> </li> <li> <p>Миллисекунда: Столбец B</p> </li> </ul> | Столбец E: 09:56:30.100 |

## Создать метку времени из частей

Создает столбец с новой временной меткой, полученной путем объединения чисел из других столбцов.

### Свойства

| Свойство | Конфигурация |
| --- | --- |
| Год | Выберите столбец, содержащий информацию о годе для получаемой метки времени. |
| Месяц | Выберите столбец, содержащий информацию о месяце для получаемой метки времени. |
| День | Выберите столбец, содержащий информацию о дне для получаемой метки времени. |
| Час | Выберите столбец, содержащий информацию о часах для получаемой метки времени. |
| Минута | Выберите столбец, содержащий информацию о минутах для получаемой метки времени. |
| Секунда | Выберите столбец, содержащий информацию о секундах для получаемой метки времени. |
| Миллисекунда | Выберите столбец, содержащий информацию о миллисекундах для получаемой метки времени. |
| Имя нового столбца | Введите имя столбца, который будет создан для сохранения результата объединения. Если оставить поле пустым, будет присвоено имя по умолчанию `new_timestamp`. |

### Пример

| Входные данные | Конфигурация | Выходные данные |
| --- | --- | --- |
| <ul> <li> <p>Столбец А: 10</p> </li> <li> <p>Столбец В: 2021</p> </li> <li> <p>Столбец С: 12</p> </li> <li> <p>Столбец D: 9</p> </li> <li> <p>Столбец E: 1</p> </li> <li> <p>Столбец F: 30</p> </li> <li> <p>Столбец G: 56</p> </li> </ul> | <ul> <li> <p>Год: Столбец B</p> </li> <li> <p>Месяц: Столбец A</p> </li> <li> <p>День: Столбец C</p> </li> <li> <p>Час: Столбец D</p> </li> <li> <p>Минута: Столбец G</p> </li> <li> <p>Секунда: Столбец F</p> </li> <li> <p>Миллисекунда: Столбец E</p> <p>&nbsp;</p> </li> </ul> | Столбец H: 10/12/2021 9:56:30 AM |

## Извлечь части даты

Извлекает части даты и создает отдельные столбцы с выбранными частями даты.

### Свойства

| Свойство | Конфигурация |
| --- | --- |
| Columns to process (Столбцы для обработки) | Выберите один или несколько столбцов, к которым будет применена функция.<br><br>Чтобы применить функцию к нескольким столбцам, выберите столбцы в раскрывающемся списке и нажмите Применить. |
| <ul> <li> <p><span>До полудня/после полудня</span> </p> </li> <li> <p><span>День</span> </p> </li> <li> <p><span>Название дня</span> </p> </li> <li> <p><span>День недели</span> </p> </li> <li> <p><span>День года</span> </p> </li> <li> <p><span>Час (12-часовой формат)</span> </p> </li> <li> <p><span>Час (24-часовой формат)</span> </p> </li> <li> <p><span>Минута</span> </p> </li> <li> <p><span>Месяц</span> </p> </li> <li> <p><span>Название месяца</span> </p> </li> <li> <p><span>Квартал года</span> </p> </li> <li> <p><span>Номер квартала</span> </p> </li> <li> <p><span>Секунда</span> </p> </li> <li> <p><span>Неделю</span> </p> </li> <li> <p><span>Год</span> </p> </li> <li> <p><span>Год-месяц</span> </p> </li> <li> <p><span>Год-квартал</span> </p> </li> <li> <p><span>Год-неделя</span> </p> </li> </ul> | С помощью переключателей выберите, какие столбцы будут созданы. Каждая выбранная часть будет извлечена и сохранена в отдельном столбце. Имя столбца по умолчанию: `<prefix_or_source_column_name>_<date_part>`. |
| Префикс части даты | Укажите префикс, который будет добавляться к названию каждого создаваемого столбца. Если префикс не указан, в качестве префикса будет использоваться имя исходного столбца с датами. |

### Пример

| Входные данные | Конфигурация | Выходные данные |
| --- | --- | --- |
| 10/12/2021 9:56:30 AM | <ul> <li> <p>Название дня</p> </li> <li> <p>День недели</p> </li> <li> <p>Название месяца</p> </li> <li> <p>Квартал года</p> </li> <li> <p>Неделя</p> </li> <li> <p>Префикс части даты: извлечено</p> </li> </ul> | <ul> <li> <p>extracted_dayLabel: Thu</p> </li> <li> <p>extracted_dayOfWeek: 4</p> </li> <li> <p>extracted_monthLabel: Oct</p> </li> <li> <p>extracted_quarterLabel: Q4</p> </li> <li> <p>extracted_weekOfYear: 43</p> </li> </ul> |

## Форматировать дату

Изменяет формат даты для использования в столбце даты.

### Свойства

| Свойство | Конфигурация |
| --- | --- |
| Columns to process (Столбцы для обработки) | Выберите один или несколько столбцов, к которым будет применена функция.<br><br>Чтобы применить функцию к нескольким столбцам, выберите столбцы в раскрывающемся списке и нажмите Применить. |
| Формат даты | Выберите из списка один из сохраненных форматов или введите свой формат:<br><br><ul> <li> <p>«Пользовательский»: введите свой формат даты (задается в поле <span>Образец даты</span>).</p> </li> <li> <p>ГГГГ-ММ-ДД</p> </li> <li> <p>ГГГГММДД</p> </li> <li> <p>М/Д/ГГГГ</p> </li> <li> <p>М/Д/ГГ</p> </li> <li> <p>ММ/ДД/ГГ</p> </li> <li> <p>МММ Д, ГГГГ</p> </li> <li> <p>ММММ Д, ГГГГ</p> </li> <li> <p>ГГГГММДД чч:мм</p> </li> <li> <p>ГГГГММДД чч:мм:сс</p> </li> <li> <p>ГГГГММДДТчч:мм</p> </li> <li> <p>ГГГГММДДТчч:мм:сс</p> </li> <li> <p>М/Д/ГГГГ чч:мм AM/PM</p> </li> <li> <p>М/Д/ГГ чч:мм AM/PM</p> </li> <li> <p>ММ/ДД/ГГ чч:мм AM/PM</p> </li> <li> <p>М/Д/ГГГГ чч:мм:сс AM/PM</p> </li> <li> <p>М/Д/ГГ чч:мм:сс AM/PM</p> </li> <li> <p>ММ/ДД/ГГ ЧЧ:мм:сс AM/PM</p> </li> <li> <p>МММ Д, ГГГГ чч:мм:сс AM/PM</p> </li> <li> <p>День недели, ММММ Д, ГГГГ чч:мм:сс AM/PM</p> </li> <li> <p>чч:мм</p> </li> <li> <p>чч:мм:сс</p> </li> <li> <p>чч:мм AM/PM</p> </li> <li> <p>чч:мм:сс AM/PM</p> </li> </ul> |
| Create new column (Создать новый столбец) | Установите этот флажок, если вы хотите вывести результат этой функции в новый столбец и сохранить исходный без изменений. |

### Пример

| Входные данные | Конфигурация | Выходные данные |
| --- | --- | --- |
| 12-31-2000 | <ul> <li> <p>Формат даты: Пользовательский</p> </li> <li> <p>Шаблон даты: ДД/ММ/ГГГГ</p> </li> </ul> | 31/12/2000 |
| 05/04/2017 | Формат даты: день недели, ММММ Д, ГГГГ чч:мм:сс AM/PM | Thursday, May 4, 2017 12:00:00 am |

## Усечь дату

Удаляет часть даты. Дата или метка времени будет обрезана до первой точки единицы времени, до которой производится обрезка.

### Свойства

| Свойство | Конфигурация |
| --- | --- |
| Columns to process (Столбцы для обработки) | Выберите один или несколько столбцов, к которым будет применена функция.<br><br>Чтобы применить функцию к нескольким столбцам, выберите столбцы в раскрывающемся списке и нажмите Применить. |
| Единица времени | Выберите часть даты, после которой значение будет усечено. Если значение усекается до единицы «День» или выше, возвращаемое значение будет датой, в противном случае – меткой времени.<br><br><ul> <li> <p>Год</p> </li> <li> <p>Месяц</p> </li> <li> <p>День</p> </li> <li> <p>Час</p> </li> <li> <p>Минута</p> </li> <li> <p>Секунда</p> </li> </ul> |
| Create new column (Создать новый столбец) | Установите этот флажок, если вы хотите вывести результат этой функции в новый столбец и сохранить исходный без изменений. |

### Пример

| Входные данные | Конфигурация | Выходные данные |
| --- | --- | --- |
| 2024-06-22 | Единица измерения: «Год» | 2024-01-01 |
| 2024-06-22 11:05 | Единица измерения времени: «Месяц» | 2024-06-01 |
| 2024-06-22 11:05:35 | Единица времени: «Секунда» | 2024-06-22 11:05:01 |