Конвертировать поле времени (Управление данными)

Краткая информация

Конвертирует значения даты и времени, хранящиеся в поле, в другое поле. Инструмент можно использовать для конвертации значений между полями разных типов (текстовое, числовое или даты), или для конвертации значений в другой формат, например, дд/мм/гг чч:мм:сс в гггг-мм-дд.

Использование

Внимание:

Этот инструмент изменяет входные значения. Более подробно о стратегиях предотвращения нежелательных изменений данных см. в разделе Инструменты, которые изменяют или обновляют входные данные.

• Если входное поле числового или текстового формата, выберите нужный формат в параметре Формат входного времени.

  Более подробно о поддерживаемых форматах поля времени

• Если параметр Формат входного времени - текстовое поле, пользовательские форматы можно добавить к параметру Формат входного времени.

  Более подробно о конвертации строковых значений времени в формат дат

Параметры

Диалог

Подпись	Описание	Тип данных
Входная таблица	Слой или таблица с полем, содержащим значения времени, которые требуется конвертировать.	Table View
Входное поле времени	Поле, содержащее значения времени. Допустимые типы: короткое целое, длинное целое, с плавающей точкой, двойной точности, текст или дата.	Field
Формат входного времени (Дополнительный)	Формат значений времени в параметре Входное поле времени. Вы можете выбрать либо стандартный формат времени из ниспадающего списка, либо указать пользовательский формат. Этот параметр не поддерживается, если входное поле типа Дата. Примечание: Формат строк чувствителен к регистру. Если тип данных поля времени – дата, формат времени не требуется. Если тип данных поля времени – числовой (короткое, длинное целое, с плавающей точкой или двойной точности), в ниспадающем списке предоставляется перечень стандартных числовых форматов времени. Если тип данных поля времени – строка, перечень стандартных строковых форматов времени предоставляется в ниспадающем списке. Для строковых полей вы также можете задать пользовательский формат времени. Например, значения времени могли храниться в строковом поле в одном из стандартных форматов, например, yyyy/MM/dd HH:mm:ss, или в пользовательском формате, например, dd/MM/yyyy HH:mm:ss. Для пользовательского формата вы также можете установить указатель a.m., p.m. Некоторые из часто используемых форматов приведены ниже: yyyy – год, представленный четырьмя цифрами MM - месяц, указанный цифрами, с нулем в начале для месяцев из одной цифры MMM – месяц, представленный трехбуквенным сокращением ddd — день месяца, указанный цифрами, с нулем в начале для дат из одной цифры ddd — трехбуквенное сокращение названия дня недели hh — значение часа, представленное цифрами с нулем впереди для часов, обозначаемых одной цифрой, 12-часовая шкала HH – значение часа, представленное цифрами с нулем впереди для часов, обозначаемых одной цифрой, 24-часовая шкала mm — число минут с нулем впереди для одноразрядных значений ss — число секунд с нулем впереди для одноразрядных значений t – одно символьная строка маркера времени, например, A или P tt – много символьная строка маркера времени, например, AM или PM unix_us – время Unix в микросекундах unix_ms – время Unix в миллисекундах unix_s – время Unix в секундах unix_hex – время Unix в шестнадцатеричной системе исчисления	String
Имя выходного поля времени	Имя добавляемого поля, в котором будут храниться конвертируемые значения времени.	String
Тип выходного поля времени (Дополнительный)	Указывает тип поля выходного поля времени. Дата—Тип поля будет установлен на date. Поля типа Дата поддерживают значения даты и времени. Текст—Тип поля будет установлен на text. Текстовые поля поддерживают строки символов. Long (32-разрядное целочисленное)—Тип поля будет установлен на long. Поля типа Длинное целое поддерживают целые числа в диапазоне от -2147483648 до 2147483647. Short (16-разрядное целочисленное)—Тип поля будет установлен на short. Поля типа Короткое целое поддерживают целые числа в диапазоне от -32768 до 32767. Двойной точности (64-битное с плавающей точкой)—Тип поля будет установлен на double. Поля двойной точности поддерживают дробные числа в диапазоне от -2.2E308 до 1.8E308. Float (32-разрядное с плавающей точкой)—Тип поля будет установлен на float. Поля с плавающей точкой поддерживают дробные числа в диапазоне от -3.4E38 до 1.2E38.	String
Формат выходного времени (Дополнительный)	Формат выходных значений времени. Поддерживаемые форматы выходного времени зависит от параметра Тип выходного поля времени. Пользовательский формат также можно использовать для конвертации значений в другой формат или извлечения фрагмента значения (например, только год). Список пользовательских форматов см в разделе Формат входного времени. Этот параметр не используется, если для Типа выходного поля времени установлено значение Date. Примечание: Если тип данных выходного поля времени не имеет достаточной длины для хранения конвертированного значения времени, выходное значение будет сокращено.	String

Производные выходные данные

Подпись	Описание	Тип данных
Обновленная входная таблица	Обновленная входная таблица.	Table View

Python

arcpy.management.ConvertTimeField(in_table, input_time_field, {input_time_format}, output_time_field, {output_time_type}, {output_time_format})

Имя	Описание	Тип данных
in_table	Слой или таблица с полем, содержащим значения времени, которые требуется конвертировать.	Table View
input_time_field	Поле, содержащее значения времени. Допустимые типы: короткое целое, длинное целое, с плавающей точкой, двойной точности, текст или дата.	Field
input_time_format (Дополнительный)	Формат значений времени в параметре input_time_field. Этот параметр не поддерживается, если входное поле типа Дата. Примечание: Формат строк чувствителен к регистру. Если тип данных поля времени – дата, формат времени не требуется. Если тип данных поля времени – числовой (короткое, длинное целое, с плавающей точкой или двойной точности), в ниспадающем списке предоставляется перечень стандартных числовых форматов времени. Если тип данных поля времени – строка, перечень стандартных строковых форматов времени предоставляется в ниспадающем списке. Для строковых полей вы также можете задать пользовательский формат времени. Например, значения времени могли храниться в строковом поле в одном из стандартных форматов, например, yyyy/MM/dd HH:mm:ss, или в пользовательском формате, например, dd/MM/yyyy HH:mm:ss. Для пользовательского формата вы также можете установить указатель a.m., p.m. Некоторые из часто используемых форматов приведены ниже: yyyy – год, представленный четырьмя цифрами MM - месяц, указанный цифрами, с нулем в начале для месяцев из одной цифры MMM – месяц, представленный трехбуквенным сокращением ddd — день месяца, указанный цифрами, с нулем в начале для дат из одной цифры ddd — трехбуквенное сокращение названия дня недели hh — значение часа, представленное цифрами с нулем впереди для часов, обозначаемых одной цифрой, 12-часовая шкала HH – значение часа, представленное цифрами с нулем впереди для часов, обозначаемых одной цифрой, 24-часовая шкала mm — число минут с нулем впереди для одноразрядных значений ss — число секунд с нулем впереди для одноразрядных значений t – одно символьная строка маркера времени, например, A или P tt – много символьная строка маркера времени, например, AM или PM unix_us – время Unix в микросекундах unix_ms – время Unix в миллисекундах unix_s – время Unix в секундах unix_hex – время Unix в шестнадцатеричной системе исчисления	String
output_time_field	Имя добавляемого поля, в котором будут храниться конвертируемые значения времени.	String
output_time_type (Дополнительный)	Указывает тип поля выходного поля времени. DATE—Тип поля будет установлен на date. Поля типа Дата поддерживают значения даты и времени. TEXT—Тип поля будет установлен на text. Текстовые поля поддерживают строки символов. LONG—Тип поля будет установлен на long. Поля типа Длинное целое поддерживают целые числа в диапазоне от -2147483648 до 2147483647. SHORT—Тип поля будет установлен на short. Поля типа Короткое целое поддерживают целые числа в диапазоне от -32768 до 32767. DOUBLE—Тип поля будет установлен на double. Поля двойной точности поддерживают дробные числа в диапазоне от -2.2E308 до 1.8E308. FLOAT—Тип поля будет установлен на float. Поля с плавающей точкой поддерживают дробные числа в диапазоне от -3.4E38 до 1.2E38.	String
output_time_format (Дополнительный)	Формат выходных значений времени. Поддерживаемые форматы выходного времени зависит от параметра output_time_type. Пользовательский формат также можно использовать для конвертации значений в другой формат или извлечения фрагмента значения (например, только год). Список пользовательских форматов см в разделе input_time_format. Этот параметр не используется, если для output_time_type установлено значение DATE. Примечание: Если тип данных выходного поля времени не имеет достаточной длины для хранения конвертированного значения времени, выходное значение будет сокращено.	String

Производные выходные данные

Имя	Описание	Тип данных
out_table	Обновленная входная таблица.	Table View

Пример кода

ConvertTimeField, пример 1 (окно Python)

В следующем скрипте окна Python показано, как используется функция ConvertTimeField в режиме прямого запуска.

import arcpy
arcpy.ConvertTimeField_management("C:/Data/TemporalData.gdb/Input_Table","Input_Time","1033;MMMM dd, yyyy HH:mm:ss;AM;PM","Output_Time")

ConvertTimeField, пример 2 (автономный скрипт)

В следующем автономном скрипте показано использование функции ConvertTimeField.

# Name: ConvertTimeField_Ex02.py
# Description: Convert a time field to date field
# Requirements: None

# Import system modules
import arcpy

# Set local variables
inTable = "C:\Data\TemporalData.gdb\Input_Table"
inputTimeField = "Input_Time"
inputTimeFormat = "1033;MMMM dd, yyyy HH:mm:ss;AM;PM"
outputDateField = "Output_Time"

# Execute CalculateEndDate
arcpy.ConvertTimeField_management(inTable, inputTimeField, inputTimeFormat, outputDateField)

Параметры среды

Текущая рабочая область

Информация о лицензиях

• Basic: Да
• Standard: Да
• Advanced: Да