時間フィールドの変換 (Convert Time Field) (データ管理)

サマリー

フィールドに格納された日付と時間の値を、別のフィールドに変換します。 このツールを使用すると、複数のフィールド タイプ (テキスト、数値、または日付フィールド) 間で変換したり、dd/MM/yy HH:mm:ss 形式から yyyy-MM-dd など、値を別の形式に変換したりできます。

使用法

• 入力時間フィールドがテキスト フィールドか数値フィールドである場合は、[入力時間形式] パラメーターから適切な形式を選択します。

  サポートされる時間フィールド形式の詳細

• [入力時間フィールド] パラメーター値がテキスト フィールドである場合、[入力時間形式] パラメーターにカスタム形式を追加できます。

  文字列の時間値を日付形式に変換する方法の詳細

パラメーター

ダイアログ

ラベル	説明	データ タイプ
入力テーブル	変換される時間値を格納しているフィールドを含むレイヤーまたはテーブル。	Table View
入力時間フィールド	時間値が格納されているフィールド。 このフィールドは、Short、Long、Float、Double、テキスト、または日付のいずれかのタイプになります。	Field
入力時間形式 (オプション)	[入力時間形式] パラメーター値の時間値の形式。 標準時間形式をドロップダウン リストから選択するか、カスタム形式を手動で入力できます。 入力時間フィールドが日付形式である場合は、パラメーターはサポートされません。 注意: この形式の文字列では、大文字と小文字が区別されます。 時間フィールドのデータ タイプが Date の場合、時間形式は必要ありません。 時間フィールドのデータ タイプが数値 (Short、Long、Float、または Double) の場合は、標準の数値時間形式のリストがドロップダウン リストに表示されます。 時間フィールドのデータ タイプが文字列の場合は、標準の文字列時間形式のリストがドロップダウン リストに表示されます。 文字列フィールドの場合は、カスタム時間形式を指定することもできます。 たとえば、文字列フィールドに格納されている時間値は、yyyy/MM/dd HH:mm:ss などの標準形式である場合もあれば、dd/MM/yyyy HH:mm:ss などのカスタム形式である場合もあります。 カスタム形式では、午前または午後の指定子を指定することもできます。 一般に使用されている形式は次のとおりです。 yyyy - 4 桁で表された年 MM - 月が示され、それが 1 桁の場合はその先頭に 0 が付きます MMM - 月が略称で示されます dd - 日が示され、それが 1 桁の場合はその先頭に 0 が付きます ddd - 曜日が略称で示されます hh - 12 時間制で「時」を表します。時間が 1 桁の場合、先頭にゼロが付きます HH - 24 時間制で「時」を表します。時間が 1 桁の場合、先頭にゼロが付きます mm -「分」を表します。分が 1 桁の場合、数字の先頭にゼロが付きます ss - 秒が示され、それが 1 桁の場合はその先頭に 0 が付きます t - 1 文字の時間マーカー文字列 (A、P など) tt - 複数文字の時間マーカー文字列 (AM、PM など) unix_us - マイクロ秒単位の Unix 時間です unix_ms - ミリ秒単位の Unix 時間です unix_s - 秒単位の Unix 時間です unix_hex - 16 進数表記の Unix 時間です	String
出力時間フィールド名	変換された時間値が格納される、追加されるフィールドの名前。	String
出力時間フィールド タイプ (オプション)	出力時間フィールドのフィールド タイプを指定します。 Date—フィールド タイプは日付です。 日付フィールドは、日付値と時間値をサポートします。 Text—フィールド タイプはテキストです。 テキスト フィールドは文字列をサポートします。 Long (大きい整数)—フィールド タイプは Long です。 Long フィールドは、-2,147,483,648 ～ 2,147,483,647 の範囲の整数をサポートします。 Short (小さい整数)—フィールド タイプは Short です。 Short フィールドは、-32,768 〜 32,767 の範囲の整数をサポートします。 Double (倍精度)—フィールド タイプは Double です。 Double フィールドは、-2.2E308 ～ 1.8E308 の範囲の有理数をサポートします。 Float (単精度)—フィールド タイプは Float です。 Float フィールドは、-3.4E38 ～ 1.2E38 の範囲の有理数をサポートします。	String
出力時間形式 (オプション)	出力時間値の形式。 サポートされる出力時間形式は、[出力時間フィールド タイプ] パラメーター値に依存します。 カスタム形式を使用すると、値を別の形式に変換したり、値の一部 (年など) を抽出したりすることもできます。 カスタム形式のリストについては、[入力時間形式] パラメーターのヘルプをご参照ください。 このパラメーターは、[出力時間フィールド タイプ] パラメーター値が [日付] の場合は使用されません。 注意: 出力時間フィールドのデータ タイプが、変換された時間値を格納できるほど長くない場合は、出力値が切詰められます。	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	時間値が格納されているフィールド。 このフィールドは、Short、Long、Float、Double、テキスト、または日付のいずれかのタイプになります。	Field
input_time_format (オプション)	input_time_field パラメーター値での時間値の形式。 入力時間フィールドが日付形式である場合は、パラメーターはサポートされません。 注意: この形式の文字列では、大文字と小文字が区別されます。 時間フィールドのデータ タイプが Date の場合、時間形式は必要ありません。 時間フィールドのデータ タイプが数値 (Short、Long、Float、または Double) の場合は、標準の数値時間形式のリストがドロップダウン リストに表示されます。 時間フィールドのデータ タイプが文字列の場合は、標準の文字列時間形式のリストがドロップダウン リストに表示されます。 文字列フィールドの場合は、カスタム時間形式を指定することもできます。 たとえば、文字列フィールドに格納されている時間値は、yyyy/MM/dd HH:mm:ss などの標準形式である場合もあれば、dd/MM/yyyy HH:mm:ss などのカスタム形式である場合もあります。 カスタム形式では、午前または午後の指定子を指定することもできます。 一般に使用されている形式は次のとおりです。 yyyy - 4 桁で表された年 MM - 月が示され、それが 1 桁の場合はその先頭に 0 が付きます MMM - 月が略称で示されます dd - 日が示され、それが 1 桁の場合はその先頭に 0 が付きます ddd - 曜日が略称で示されます hh - 12 時間制で「時」を表します。時間が 1 桁の場合、先頭にゼロが付きます HH - 24 時間制で「時」を表します。時間が 1 桁の場合、先頭にゼロが付きます mm -「分」を表します。分が 1 桁の場合、数字の先頭にゼロが付きます ss - 秒が示され、それが 1 桁の場合はその先頭に 0 が付きます t - 1 文字の時間マーカー文字列 (A、P など) tt - 複数文字の時間マーカー文字列 (AM、PM など) unix_us - マイクロ秒単位の Unix 時間です unix_ms - ミリ秒単位の Unix 時間です unix_s - 秒単位の Unix 時間です unix_hex - 16 進数表記の Unix 時間です	String
output_time_field	変換された時間値が格納される、追加されるフィールドの名前。	String
output_time_type (オプション)	出力時間フィールドのフィールド タイプを指定します。 DATE—フィールド タイプは日付です。 日付フィールドは、日付値と時間値をサポートします。 TEXT—フィールド タイプはテキストです。 テキスト フィールドは文字列をサポートします。 LONG—フィールド タイプは Long です。 Long フィールドは、-2,147,483,648 ～ 2,147,483,647 の範囲の整数をサポートします。 SHORT—フィールド タイプは Short です。 Short フィールドは、-32,768 〜 32,767 の範囲の整数をサポートします。 DOUBLE—フィールド タイプは Double です。 Double フィールドは、-2.2E308 ～ 1.8E308 の範囲の有理数をサポートします。 FLOAT—フィールド タイプは 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: Yes
• Standard: Yes
• Advanced: Yes