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

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

Переносит значения даты и времени, хранящиеся в поле, в другое поле. Инструмент можно применять для конвертации между различными типами полей (текстовыми, числовыми или полями дат) или для конвертации значений в другой формат, например, dd/MM/yy HH:mm:ss в yyyy-MM-dd.

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

Параметры

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

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

Table View
Входное поле времени

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

Field
Формат входного времени
(Дополнительный)

Формат значений времени в параметре Входное поле времени. Вы можете выбрать либо стандартный формат времени из ниспадающего списка, либо указать пользовательский формат. Параметр не поддерживается, если у входного поля времени тип "дата".

Примечание:

Формат строк чувствителен к регистру.

  • Если тип данных поля времени – дата, формат времени не требуется.
  • Если тип данных поля времени – числовой (короткое, длинное целое, с плавающей точкой или двойной точности), в ниспадающем списке предоставляется перечень стандартных числовых форматов времени.
  • Если тип данных поля времени – строка, перечень стандартных строковых форматов времени предоставляется в ниспадающем списке. Для строковых полей вы также можете задать пользовательский формат времени. Например, значения времени могли храниться в строковом поле в одном из стандартных форматов, например, yyyy/MM/dd HH:mm:ss, или в пользовательском формате, например, dd/MM/yyyy HH:mm:ss. Для пользовательского формата вы также можете установить указатель a.m. или p.m. Некоторые из часто используемых форматов приведены ниже:
    • yyyy – год, представленный четырьмя цифрами
    • MM – месяц, указанный цифрами, с нулем в начале для месяцев из одной цифры
    • MMM – трехбуквенное сокращение названия месяца
    • dd – день месяца, указанный цифрами, с нулем в начале для дат из одной цифры
    • 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Типом поля будет Дата. Поля даты поддерживают значения даты и времени.
  • ТекстТип поля будет Текст. Текстовые поля поддерживают строку символов.
  • Длинное целое (32-битное целочисленное)Тип поля будет Длинное целое. Поля типа Длинное целое поддерживают целые числа от -2 147 483 648 до 2 147 483 647.
  • Короткое целое (16-битное целочисленное)Тип поля будет Короткое целое. Поля типа Короткое целое поддерживают целые числа от -32 768 до 32 767.
  • Двойной точности (64-битное с плавающей точкой)Тип поля будет Двойной точности. Поля типа Двойной точности поддерживают дробные числа от -2.2E308 до 1.8E308.
  • С плавающей точкой (32-битное с плавающей точкой)Тип поля будет С плавающей точкой. Поля типа С плавающей точкой поддерживают дробные числа от -3.4E38 до 1.2E38.
String
Формат выходного времени
(Дополнительный)

Формат выходных значений времени. Поддерживаемые форматы выходного времени зависят от значения параметра Тип поля выходного времени. Пользовательский формат также можно использовать для преобразования значения в другой формат или для извлечения части значения (например, года). Список пользовательских форматов смотрите в справке для параметра Входной формат времени. Это параметр не используется, если значение параметра Тип поля выходного времени - Дата.

Примечание:

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

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 – трехбуквенное сокращение названия месяца
    • dd – день месяца, указанный цифрами, с нулем в начале для дат из одной цифры
    • 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Типом поля будет Дата. Поля даты поддерживают значения даты и времени.
  • TEXTТип поля будет Текст. Текстовые поля поддерживают строку символов.
  • LONGТип поля будет Длинное целое. Поля типа Длинное целое поддерживают целые числа от -2 147 483 648 до 2 147 483 647.
  • SHORTТип поля будет Короткое целое. Поля типа Короткое целое поддерживают целые числа от -32 768 до 32 767.
  • DOUBLEТип поля будет Двойной точности. Поля типа Двойной точности поддерживают дробные числа от -2.2E308 до 1.8E308.
  • 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: Да

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