Skip to main content

Создать дату и время

Инструмент Создать дату и время создает поле дат, используя существующие значения полей.

Примеры

Инструмент Создать дату время можно использовать в следующих сценариях:

  • Набор данных отслеживания ураганов содержит строковое представление времени наблюдения. Используйте инструмент Создать дату время для форматирования и вывода строкового поля как поля даты.

  • Набор данных хранит информацию о времени в полях 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.

  • У вас есть строковое поле с именем MY_DATE_TIME, содержащее даты, хранящиеся в различных форматах. Например, 2022-12-30 17:30:00 и April 30, 2020 6:30:30 PM. Для преобразования обоих значений в новое поле даты укажите пары поле и формат следующим образом:

    • MY_DATE_TIME для поля времени и значение yyyy-MM-dd HH:mm:ss для формата времени

    • MY_DATE_TIME для поля времени и значение MMMM' 'dd', 'yyyy' 'h:mm:ss a для формата времени

Формат должен точно соответствовать значениям в указанном поле. Например, вы не можете использовать формат MM/dd/yyyy, если поле содержит поднабор таких значений, как 12/30.

По умолчанию поля, используемые для создания даты, будут удалены из выходного набора данных. Чтобы сохранить входные поля, включите параметр Сохранить поля источника.

Параметр Часовой пояс указывает часовой пояс, в котором хранятся входные значения времени. По умолчанию, это значение - всемирное координированное время (UTC). Если вы укажете значение, отличное от UTC, входные значения будут рассчитаны с использованием указанного значения времени, но поле выходного времени будет преобразовано в UTC.

Если поле времени содержит значения смещения часового пояса, например, -07:00 или America/Los_Angeles, параметр Часовой пояс будет проигнорирован. Вместо этого будет применено смещение часового пояса для каждого значения записи.

Если в поле времени используется формат миллисекунд от начала эпохи или секунд от начала эпохи, например, 1769097663948 или 1769097703, параметр Часовой пояс будет проигнорирован. Даты, используемые в этих форматах, всегда указываются в часовом поясе 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.

  • Указание нескольких форматов для одного поля не поддерживается, если поле содержит как числовые, так и строковые форматы. В результате все значения будут null. Например, такой результат может возникнуть, если одно поле содержит значение 1590863430000, заданное в числовом формате миллисекунд эпохи, и значение 12/20/2027 18:30:30, заданное в строковом формате MM/dd/yyyy HH:mm:ss, и оба формата были указаны в качестве входных для инструмента.

Лицензионные требования

Требуется следующее лицензии и конфигурации:

  • Тип пользователя Creator или GIS Professional

  • Роль Издатель, Посредник или Администратор, или эквивалентная пользовательская роль

Подробнее о системных требованиях Data Pipelines см. в разделе Требования.

Кроме того, Data Pipelines доступен только в том случае, если у вас есть ArcGIS Data Pipelines Server, настроенный с ArcGIS Enterprise.