Инструмент Создать дату и время создает поле дат, используя существующие значения полей.
Примеры
Инструмент Создать дату время можно использовать в следующих сценариях:
- Набор данных отслеживания ураганов содержит строковое представление времени наблюдения. Используйте инструмент Создать дату время для форматирования и вывода строкового поля как поля даты.
- Набор данных хранит информацию о времени в полях Hour, Minute, и Second. Чтобы указать эти поля и задать форматы значений этих полей при создании нового поля даты, используйте инструмент Создать дату и время.
Параметры
В следующей таблице приводится описание параметров, используемых в инструменте Создать дату время:
| Параметр | Описание |
|---|---|
Входной набор данных | Набор данных, содержащий значения полей, которые будут использоваться для создания поля даты. |
Поля | Список из одного или нескольких полей и формат значений даты или времени, содержащихся в указанном поле. |
Поле времени | Поле, содержащее значения даты или времени. |
Формат времени | Формат значений в поле времени. |
Сохранить поля источника | Указывает, будут ли в выходных данных сохраняться поля, используемые для создания даты. |
Часовой пояс | Часовой пояс входных значений. |
Имя выходного поля времени | Имя выходного поля времени. Это дополнительный параметр. Значение по умолчанию равно TIMESTAMP. |
Примечания по использованию
Используйте параметр Входной набор данных для идентификации набора данных, содержащего значения полей, которые будут использоваться для создания поля даты. Этот набор данных появится в выходных данных вместе с добавленным столбцом новой даты.
Используйте параметр Поля, чтобы указать одно или несколько полей для вычисления значений выходных данных. Результатом будет отдельное поле даты. Ниже приведены примеры полей ввода и форматов:
- У вас есть строковое поле с именем MY_DATE_TIME и значением 2022-12-30 17:30:00. Укажите MYDATETIME для поля времени и значение yyyy-MM-dd HH:mm:ss для формата времени.
- У вас есть два поля: MY_DATE со значением 07/25/2000 и MY_TIMEсо значением 5:30:00 PM. Укажите две пары полей и форматов. Укажите первое поле времени как MY_DATE со значением формата MM/dd/yyyy, а второе поле времени как MY_TIME со значением формата hh:mm:ss a.
По умолчанию поля, используемые для создания даты, будут удалены из выходного набора данных. Чтобы сохранить входные поля, включите параметр Сохранить поля источника.
Параметр Часовой пояс указывает часовой пояс, в котором хранятся входные значения времени. По умолчанию, это значение - всемирное координированное время (UTC). Если вы укажете значение, отличное от UTC, входные значения будут рассчитаны с использованием указанного значения времени, но поле выходного времени будет преобразовано в UTC.
Часовые пояса основаны на Joda времени. Подробнее о форматах времени Joda см. Часовые пояса доступные в формате времени Joda.
Форматы времени в Data Pipelines
| Значение | Описание | Пример |
|---|---|---|
yy | Год выражается двумя цифрами. | 16 |
yyyy | Год выражается четырьмя цифрами. | 2016 |
MM | Месяц выражается числом. | 01 или 1 |
MMM | Месяц выражается трехбуквенным обозначением. | Jan |
MMMM | Месяц выражается полным названием. | January |
dd | День. | 02 или 2 |
HH | Час в 24-часовой системе (значения от 0 до 23). | 21 |
hh | Час в 12-часовой системе (значения от 1 до 12). | 9 |
mm | Минута (значения в диапазоне от 0 до 59). | 45 |
ss | Секунда (значения в диапазоне от 0 до 59). | 02 |
SSS | Миллисекунда (значения в диапазоне от 0 до 999). | 50 |
a | Маркер AM/PM. | PM |
epoch_millis | Время в миллисекундах с epoch. | 1509581781000 |
epoch_seconds | Время в секундах с epoch. | 1509747601 |
Z | Смещение часового пояса, выраженное в часах. | -0100 или -01:00 |
ZZZ | Смещение часового пояса, выраженное с помощью ID. | America/Los_Angeles |
'' | Одинарные кавычки добавляют текст, который не представляет значение, описанное в этой таблице. | 'T' |
Выходные данные
Этот инструмент формирует одно поле даты. Все указанные вами пары полей и форматов времени будут использоваться для формирования одного значения даты. Чтобы создать несколько полей дат, запустите этот инструмент несколько раз.
Результатом работы этого инструмента является набор данных со всеми полями из входного набора данных и новое поле даты. Если вы не указали имя выходного поля, поле времени будет названо TIMESTAMP по умолчанию. Тип выходного поля - date, содержит информацию о дате и времени для каждой записи.
При предварительном просмотре полей дат значения будут отображаться в часовом поясе браузера. При записи значений в векторный слой они будут сохранены в UTC.
Ограничения
Ниже перечислены известные ограничения для инструмента Создать дату время:
- Этот инструмент возвращает одно поле даты. Чтобы вычислить несколько полей дат, настройте дополнительные инструменты Создать дату и время.
- Указанные пары полей и форматов должны вычислять значение даты полностью, например, 12/23/2022 12:30:00. Значения только даты, такие как 12/23/2022, или значения только времени, такие как 12:30:00, для полей типа дата не поддерживаются.
- Формат должен точно соответствовать значениям в указанном поле. Например, вы не можете использовать формат MM/dd/yyyy, если поле содержит поднабор таких значений, как 12/30.
Лицензионные требования
Требуется следующее лицензии и конфигурации:
- Тип пользователя Creator или GIS Professional
- Роль Издатель, Посредник или Администратор, или эквивалентная пользовательская роль
Подробнее о системных требованиях Data Pipelines см. раздел Требования