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

Сводка

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

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

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

• Если для ввода времени выбрано числовое поле (короткое целое, длинное целое, с плавающей точкой или двойной точности), то формат входного времени можно выбрать из списка поддерживаемых форматов полей стандартного времени. Пользовательские форматы времени с числовыми полями не поддерживаются.

Синтаксис

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)

Environments

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

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

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