日付と時刻の変換関数

日付と時刻の変換関数には、日付/時刻または文字列入力データピルが必要です。一部の機能は、期間データピルもサポートしています。日付と時刻の変換関数を適用するときは、正しい入力データピルタイプを使用してください。日付と時刻の変換関数が不適切なデータピルタイプに適用されると、データは実行時に変換されず、代わりに入力値が返されます。フローランタイム値を確認する方法の詳細については、「フローをテストする」を参照してください。

注:

ランタイム日付/時刻の値はローカライズされず、UTC (協定世界時) タイムゾーンで表示されます。詳細については、「タイムゾーン」および「タイムゾーン表現」を参照してください。

時間を追加 (Add Time)

入力した日付/時刻、日付、期日、または期間に日、時、分、または秒を追加します。


入力データピル	パラメーター	出力データピル
日付/時刻、日付、期日、または期間注: 入力が日付または期日である場合、変換では、時間 0、分 0、および秒 0 の時間値を使用して完全な日付/時刻値が作成されます。	Duration：追加する時間 (日、時、分、および秒)	日付/時刻：指定した Duration を追加した後に変換された日付/時刻値

図 : 1. 例

入力：2019-09-12 11:00:00
期間：3 時間
出力：2019-09-12 14:00:00

時間を減算 (Subtract Time)

入力した日付/時刻、日付、期日、または期間から日、時、分、または秒を減算します。


入力データピル	パラメーター	出力データピル
日付/時刻、日付、期日、または期間注: 入力が日付または期日である場合、変換では、時間 0、分 0、および秒 0 の時間値を使用して完全な日付/時刻値が作成されます。	Duration：減算する時間 (日、時、分、および秒) を入力	日付/時刻：指定した Duration を減算した後に変換された日付/時刻値

図 : 2. 例

入力：2019-09-12 11:00:00
期間：2 日、1 時間、5 分、10 秒
出力：2019-09-10 09:54:50

この例では、フローはリモートインスタンスから CMDB 構成アイテムレコードを取得します。次に、[時間を減算 (Subtract Time)] 変換関数は、入力された日付/時刻から 3 時間を減算して [作成日] フィールドの値をローカライズします。

フィールド値のタイムゾーンのローカライズ。 — 図 : 3. フィールド値のタイムゾーンのローカライズ

文字列から日付 (String to Date)

入力文字列を日付/時刻に変換します。


入力データピル	パラメーター	出力データピル
Input Date Format で指定されている文字列形式	Input Date Format：入力文字列の日付/時刻または日付形式 Custom Format：文字列として表される有効な日付/時刻または日付形式。[カスタム形式 (Custom Format)] が Input Date Format として選択されている場合にのみ必要です。	日付/時刻

注:

[カスタム形式 (Custom Format)] の入力の日付/時刻値が不完全な場合、変換はデフォルトの日付と時刻を使用して完全な日付/時刻値を作成します。この場合、変換のデフォルトは、現在の年、現在の月、月の 1 日目、時 0、分 0、秒 0 になります。たとえば、入力データピル値が 2019 年 10 月で、カスタム日付形式が MMM yyyy の場合、2019-10-01 00:00:00 の出力が生成されます。
間違ったデータピルタイプまたは無効な [カスタム形式 (Custom Format)] を使用すると、フローは実行時にキャンセルされます。

図 : 4. 例

入力：'1995-11-20'
入力日付形式：ISO 日付 (2004-06-28)
出力：1995-11-20 00:00:00

日付から文字列 (Date to String)

入力した日付/時刻、日付、または期日を文字列に変換します。入力する日付/時刻の [日付形式] を選択します。または、入力する日付/時刻に [カスタム形式 (Custom Format)] を入力します。


入力データピル	パラメーター	出力データピル
日付/時刻、日付、または期日	Output Date Format：入力文字列の日付/時刻または日付形式 Custom Format：文字列として表される有効な日付/時刻または日付形式。[カスタム形式 (Custom Format)] が [日付形式] として選択されている場合にのみ必要です。	Output Date Format で指定されている文字列形式

注:

間違った入力データピルタイプまたは無効な [カスタム形式 (Custom Format)] を使用すると、フローは実行時にキャンセルされます。

カスタム日付形式

特定の日付と時刻パターンの文字列シーケンスを使用して、カスタム日付形式を指定できます。パターン文字列は、A から Z までの 1 つ以上の大文字と小文字で構成されます。引用符で囲まれたテキストは無視され、代わりに日付出力にコピーされます。


文字列	説明	出力形式	例
G	年代指定子	テキスト	AD
y	年	年	2019; 19
Y	年の週	年	2019; 19
M	年の月 (日付内)	月次	July; Jul; 07
L	年の月 (スタンドアロン値)	月次	July; Jul; 07
w	年の週	番号	52
W	月の週	番号	1
D	年の日	番号	365
d	月の日	番号	2
F	月の曜日	番号	3
E	曜日名	テキスト	Wednesday; Wed
u	週の日の番号	番号	3
a	午前または午後	テキスト	p.m.
H	0 〜 23 の日の時間	番号	0
k	1 〜 24 の日の時間	番号	24
K	午前または午後 0 時から 11 時までの時間	番号	0
h	午前または午後 1 時から 12 時までの時間	番号	12
m	分	番号	59
s	秒	番号	1
S	ミリ秒	番号	500
z	デフォルト形式のタイムゾーン	デフォルト形式のタイムゾーン	太平洋標準時; PST
Z	RFC 822 形式のタイムゾーン	RFC 822 形式のタイムゾーン	-0800
X	ISO 8601 形式のタイムゾーン	ISO 8601 形式のタイムゾーン	-08; -0800; -08:00

日

指定された日付/時刻から日コンポーネントを取得します。


入力データピル	出力データピル
日付/時刻	整数：指定された日付からの日。

図 : 7. 例

入力： 2021-11-20 13:06:12
入力日付形式：ISO 日付 (2004-06-28)
出力：20

時間

指定された日付/時刻から時間コンポーネントを取得します。


入力データピル	出力データピル
日付/時刻	整数：指定された日付からの時間。

図 : 8. 例

入力： 2021-11-20 13:06:12
入力日付形式：ISO 日付 (2004-06-28)
出力：13

分

指定された日付/時刻から分コンポーネントを取得します。


入力データピル	出力データピル
日付/時刻	整数：指定された日付から分コンポーネント。

図 : 9. 例

入力： 2021-11-20 13:06:12
入力日付形式：ISO 日付 (2004-06-28)
出力：06

第 2

指定された日付/時刻から秒コンポーネントを取得します。


入力データピル	出力データピル
日付/時刻	整数：指定された日付から秒コンポーネント。

図 : 10. 例

入力： 2021-11-20 13:06:12
入力日付形式：ISO 日付 (2004-06-28)
出力：12

月次

指定された日付/時刻から月コンポーネントを取得します。


入力データピル	出力データピル
日付/時刻	整数：指定された日付から月コンポーネント。

図 : 11. 例

入力： 2021-11-20 13:06:12
入力日付形式：ISO 日付 (2004-06-28)
出力：11

週

指定された日付/時刻の週番号を評価します。


入力データピル	出力データピル
日付/時刻	整数：指定した日付の週番号。

図 : 12. 例

入力： 2021-04-07 12:01:12
入力日付形式：ISO 日付 (2004-06-28)
出力：15

年

指定された日付/時刻から年コンポーネントを取得します。


入力データピル	出力データピル
日付/時刻	整数：指定された日付から年コンポーネント。

図 : 13. 例

入力： 2021-04-07 12:01:12
入力日付形式：ISO 日付 (2004-06-28)
出力：2021

日付の差異

指定された入力日付とパラメーター日付の間の期間差を評価し、その差の期間をエポック時間 (1970-01-01 00:00:00) に追加します。


入力データピル	パラメーター	出力データピル
日付/時刻、日付、または期日	日付/時刻、日付、または期日	期間：エポック時間 (1970-01-01 00:00:00) に追加された期間差。

図 : 14. 例

入力：2021-05-02 09:10:12
入力日付形式：ISO 日付 (2004-06-28)
パラメーター：2021-04-07 06:02:23
出力：1970-01-26 03:07:49

月末

指定した日付に指定した月数を加えた後の月の最終日を評価します。


入力データピル	パラメーター	出力データピル
日付	月数：指定された日付に追加する月。	整数：指定した入力日付に月数を加えた後の月の最終日。

図 : 15. 例

入力：2021-11-20
入力日付形式：ISO 日付 (2004-06-28)
月数：3
出力：2022-02-28