日付/時間の作成
日付/時間の作成ツールは、既存のフィールド値を使用して、日付フィールドを作成します。
例
日付/時間の作成ツールは、次のようなシナリオで使用できます。
ハリケーン トラッキング データセットには、観測時間の文字列表現が含まれています。 日付/時間の作成ツールを使用して、文字列フィールドを日付フィールドとして書式設定および出力します。
データセットには、
Hour、Minute、およびSecondフィールドにまたがって時間情報が格納されています。 日付/時間の作成ツールを使用して、これらのフィールドとフィールド値の形式を指定し、新しい日付フィールドを作成します。さまざまな形式で格納された日付値を含む単一のフィールド。 時間の作成ツールを使用して、フィールド内に含まれる各形式を指定します。
パラメーター
次の表に、日付/時間の作成ツールで使用するパラメーターの概要を示します。
| Parameter | 説明 |
|---|---|
| 入力データセット | 日付フィールドの作成に使用するフィールド値を含むデータセット。 |
| フィールド | 1 つ以上のフィールドのリストと、指定したフィールドに含まれる日付または時間値の形式。 |
| 時間フィールド | 日付または時間値が格納されているフィールド。 |
| 時間形式 | 時間フィールドの値の形式。 |
| ソース フィールドを維持 | 日付の作成に使用するフィールドを出力で維持するかどうかを指定します。 |
| タイム ゾーン | 入力値のタイム ゾーン。 |
| 出力時間フィールド名 | 出力時間フィールドの名前。 このパラメーターはオプションです。 デフォルト値は TIMESTAMP です。 |
使用上の注意
[入力データセット] パラメーターを使用して、日付フィールドの作成に使用するフィールド値を含むデータセットを特定します。 このデータセットは、新しい日付列が追加された出力で返されます。
[フィールド] パラメーターを使用して、出力日付値を計算する 1 つ以上のフィールドを指定します。 単一の日付フィールドが出力されます。 入力フィールドおよび形式の例を示します。
値が
2022-12-30 17:30:00のMY_DATE_TIMEという文字列フィールドがあります。 時間フィールドとしてMYDATETIMEを指定し、時間形式としてyyyy-MM-dd HH:mm:ssの値を指定します。値が
07/25/2000のMY_DATEフィールドと、値が5:30:00 PMのMY_TIMEフィールドがあります。 2 つのフィールドと形式のペアを指定します。 1 つ目の時間フィールドを形式値がMM/dd/yyyyのMY_DATEとして指定し、2 つ目の時間フィールドを形式値がhh:mm:ss aのMY_TIMEとして指定します。さまざまな形式で格納されている日付を含む、
MY_DATE_TIMEという名前の文字列フィールドがあります。 例として、2022-12-30 17:30:00とApril 30, 2020 6:30:30 PMが挙げられます。 両方の値を新しい日付フィールドに変換するには、両方のフィールドと形式のペアを次のように指定します:時間フィールドとして
MY_DATE_TIME、時間形式としてyyyy-MM-dd HH:mm:ssの値時間フィールドとして
MY_DATE_TIME、時間形式としてMMMM' 'dd', 'yyyy' 'h:mm:ss aの値
形式は、指定したフィールドの値と正確に一致する必要があります。 たとえば、フィールドに 12/30 などの値のサブセットが含まれている場合、MM/dd/yyyy 形式は使用できません。
デフォルトでは、日付の作成に使用するフィールドが出力データセットから削除されます。 入力フィールドを維持するには、[ソース フィールドを維持] パラメーターを有効にします。
[タイム ゾーン] パラメーターは、入力時間値が格納されるタイム ゾーンを示します。 デフォルト値は UTC (協定世界時) です。 UTC 以外の値を指定した場合、入力値は指定した時間値を使用して計算されますが、出力時間フィールドは UTC に変換されます。
時間フィールドに、-07:00 や America/Los_Angeles などのタイム ゾーン オフセット値が含まれる場合、タイム ゾーン パラメーターは無視されます。 代わりにレコード値ごとのタイム ゾーン オフセットが適用されます。
時間フィールドに、1769097663948 や 1769097703 など、エポックからの時間 (ミリ秒) またはエポックからの時間 (秒) 形式が使用される場合、タイム ゾーン パラメーターは無視されます。 これらの形式を使用する日付では、常に UTC タイム ゾーンが使用されます。
タイム ゾーンは、Joda-Time に基づきます。 Joda-Time 形式の詳細については、「Joda-Time の利用可能なタイム ゾーン」をご参照ください。
Data Pipelines の時間形式
次の表に、完全な日付または時間の形式の構築に使用される各値の概要を示します:
| 値 | 説明 | 例 |
|---|---|---|
| yy | 2 桁で表された年。 | 16 |
| yyyy | 4 桁で表された年。 | 2016 |
| MM | 数値で表された月。 | 01 または 1 |
| MMM | 3 文字で表された月。 | Jan |
| MMMM | 完全なつづりで表された月。 | January |
| dd | 日。 | 02 または 2 |
| HH | 24 時間表記の場合の時。値の範囲は 0 ~ 23 です。 | 21 |
| hh | 12 時間表記の場合の時。値の範囲は 1 ~ 12 です。 | 9 |
| mm | 分 (値の範囲は 0 ~ 59)。 | 45 |
| ss | 秒 (値の範囲は 0 ~ 59)。 | 02 |
| SSS | ミリ秒 (値の範囲は 0 ~ 999)。 | 50 |
| a | AM/PM マーカー。 | PM |
| epoch_millis | エポックからの時間 (ミリ秒)。 | 1509581781000 |
| epoch_seconds | エポックからの時間 (秒)。 | 1509747601 |
| Z | タイムゾーンのオフセット (時)。 | -0100 または -01:00 |
| ZZZ | タイムゾーンのオフセット (ID)。 | America/Los_Angeles |
| '' | この表に説明されている値を表していないテキストを追加するには、一重引用符を使用します。 | 'T' |
出力
このツールは、単一の日付フィールドを作成します。 指定したすべての時間フィールドと形式のペアを使用して、単一の日付値が構築されます。 複数の日付フィールドを作成するには、このツールを複数回実行します。
このツールの出力には、新しい日付フィールドだけでなく、入力データセットのすべてのフィールドを含むデータセットも含まれます。 出力フィールドに名前を指定しなかった場合、時間フィールドにはデフォルトで TIMESTAMP という名前が付けられます。 出力フィールド タイプは date になり、各レコードの日付/時間情報を含みます。
日付フィールドをプレビューすると、お使いのブラウザーのタイム ゾーンで値が表示されます。 値をフィーチャ レイヤーに書き込むと、UTC で保存されます。
制限事項
日付/時間の作成ツールの既知の制限事項は以下のとおりです。
このツールは、単一の日付フィールドを返します。 複数の日付フィールドを計算するには、追加の日付/時間の作成ツールを構成します。
指定したフィールドと形式のペアでは、完全な日付値を計算する必要があります (例:
12/23/2022 12:30:00)。 日付のみの値 (12/23/2022など) と時間のみの値 (12:30:00など) は、日付タイプのフィールドには指定できません。形式は、指定したフィールドの値と正確に一致する必要があります。 たとえば、フィールドに
12/30などの値のサブセットが含まれている場合、MM/dd/yyyy形式は使用できません。単一のフィールドに数値形式と文字列形式が混在している場合、そのフィールドに複数の形式を指定することはサポートされません。 結果はすべて NULL 値になります。 たとえば、単一のフィールドに、エポック ミリ秒数値形式を使用する値
1590863430000と、MM/dd/yyyy HH:mm:ssという文字列形式を使用する値12/20/2027 18:30:30が含まれ、両方の形式がツールへの入力として指定された場合、このような結果が発生する可能性があります。
ライセンス要件
次のライセンスと構成が必要です。
Creator または Professional ユーザー タイプ
公開者、ファシリテーター、管理者ロール、またはそれと同等のカスタム ロール
Data Pipelines の要件の詳細については、「要件」をご参照ください。
また、Data Pipelines は、ArcGIS Data Pipelines Server が ArcGIS Enterprise で構成されている場合にのみ使用できます。