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

Сводка

Конвертирует значения времени, хранящиеся в строковом или числовом поле, в поле даты. Этот инструмент также позволяет конвертировать значения времени, хранящиеся в строках, числовых полях или полях времени, в пользовательские форматы, такие как день недели и месяц года.

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

Синтаксис

arcpy.management.ConvertTimeField(in_table, input_time_field, {input_time_format}, output_time_field, {output_time_type}, {output_time_format})
ParameterОбъяснениеТип данных
in_table

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

Table View
input_time_field

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

Field
input_time_format
(Дополнительный)

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

Примечание:

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

  • Если тип данных поля времени – дата, формат времени не требуется.
  • Если тип данных поля времени - числовой (короткое, длинное целое, с плавающей точкой или двойной точности), в ниспадающем списке предоставляется перечень стандартных числовых форматов времени.
  • Если тип данных поля времени – строка, перечень стандартных строковых форматов времени предоставляется в ниспадающем списке. Для строковых полей вы также можете задать пользовательский формат времени. Например, значения времени могли храниться в строковом поле в одном из стандартных форматов, например, 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Целые числа между -2147483648 и 2147483647
  • SHORTЦелые числа между -32768 и 32767
  • DOUBLEДробные числа между -2,2E308 и 1,8E308
  • FLOATДробные числа между -3,4E38 и 1,2E38
String
output_time_format
(Дополнительный)

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

Примечание:

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

String

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

NameОбъяснениеТип данных
out_table

Обновленная входная таблица.

Представление таблицы

Пример кода

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

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