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

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

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

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

Параметры

ПодписьОписаниеТип данных
Входная таблица

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

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

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: Да

Связанные разделы