日付の formula ​

日付や日時の formula を使用すると、日付や時刻のデータピルを処理できます。これらの formula は、ホワイトリストで許可された Ruby メソッドです。したがって、すべての Ruby メソッドがサポートされているわけではありません。その他の formula をホワイトリストに追加したい場合は、弊社までご連絡ください。

日付の演算 ​

日付や日時のデータで演算を行うには、以下のキーワードを使用します。

• seconds
• minutes
• days
• months
• years

formula と組み合わせると、足し算や引き算を実行できます。

使用例 ​

now ​

米国太平洋時間 (PST) で実行時の時刻と日付を返します。

使用例 ​

動作 ​

この formula はジョブの処理中にタイムスタンプを計算します。この formula を使用する各ステップが、そのステップの実行時のタイムスタンプを返します。

関連情報 ​

• today: 実行時の日付を返します。
• in_time_zone: 時刻の値を別のタイムゾーンに変換します。

today ​

米国太平洋時間で実行時の日付を返します。

使用例 ​

動作 ​

この formula はジョブの処理中にタイムスタンプを計算します。この formula を使用する各ステップが、そのステップの実行時の日付を返します。

関連情報 ​

• now: 実行時の時刻と日付を返します。
• in_time_zone: 時刻の値を別のタイムゾーンに変換します。

from_now ​

指定された期間だけ後のタイムスタンプを返します。タイムスタンプは実行時に計算されます。

構文 ​

Unit.from_now

• Unit - オフセットする時刻値。

使用例 ​

動作 ​

この formula は現在のタイムスタンプを計算し、指定された期間だけオフセットします。このタイムスタンプは、ジョブの処理中に計算されます。この formula を使用するステップそれぞれが、各実行ステップのタイムスタンプを返します。

関連情報 ​

• ago: 指定された期間だけ前のタイムスタンプを返します。
• now: 実行時の時刻と日付を返します。
• today: 実行時の日付を返します。

ago ​

指定された期間だけ前のタイムスタンプを返します。タイムスタンプは実行時に計算されます。

構文 ​

Unit.ago

• Unit - オフセットする時刻値。

使用例 ​

動作 ​

この formula は現在のタイムスタンプを計算し、指定された期間だけオフセットします。このタイムスタンプは、ジョブの処理中に計算されます。この formula を使用するステップそれぞれが、各実行ステップのタイムスタンプを返します。

関連情報 ​

• from_now: 指定された期間だけ後のタイムスタンプを返します。
• now: 実行時の時刻と日付を返します。
• today: 実行時の日付を返します。

wday ​

曜日を返します。日曜日の場合は0を、月曜日の場合は1を返します。

構文 ​

Date.wday

• Date - 日付または日時のデータ型。

使用例 ​

動作 ​

この formula はジョブの処理中に現在の日付を計算します。曜日は整数の出力データに変換されます。日曜日は0、月曜日は1になります。

関連情報 ​

• yday: 年内通算日数を返します。
• yweek: 年内通算週数を返します。

yday ​

年内通算日数を返します。

構文 ​

Date.yday

• Date - 日付または日時のデータ型。

使用例 ​

動作 ​

この formula はジョブの処理中に現在の日付を計算します。年内通算日数は整数の出力データに変換されます。

関連情報 ​

• wday: 週内通算日数を返します。
• yweek: 年内通算週数を返します。

yweek ​

年内通算週数を返します。

構文 ​

Date.yweek

• Date - 日付または日時のデータ型。

使用例 ​

動作 ​

この formula はジョブの処理中に現在の日付を計算します。年内通算週数は整数の出力データに変換されます。

関連情報 ​

• wday: 週内通算日数を返します。
• yday: 年内通算日数を返します。

beginning_of_hour ​

与えられた日時の正時の日時を返します。

構文 ​

Datetime.beginning_of_hour

• Datetime - 入力日時。

使用例 ​

beginning_of_day ​

与えられた日付/日時の、午前0時の日時を返します。

構文 ​

Date.beginning_of_day

• Date - 入力日付または入力日時。

使用例 ​

beginning_of_week ​

与えられた日付/日時の、前の月曜日の日付を返します。

構文 ​

Date.beginning_of_week

• Date - 入力日付または入力日時。

使用例 ​

beginning_of_month ​

与えられた日付/日時の、月の初日を返します。

構文 ​

Date.beginning_of_month

• Date - 入力日付または入力日時。

使用例 ​

beginning_of_year ​

与えられた日付/日時の、年の初日を返します。

構文 ​

Date.beginning_of_year

• Date - 入力日付または入力日時。

使用例 ​

end_of_month ​

与えられた日付/日時の、月の最終日を返します。この formula は入力データに基づいて日付または日時を返します。

構文 ​

Date.end_of_month

• Date - 入力日付または入力日時。

使用例 ​

strftime ​

日時の入力データを、ユーザー定義の文字列として返します。

構文 ​

Date.strftime(format)

• Date - 入力日付または入力日時。
• format - 文字列として記述された、ユーザー定義の日時の書式。

使用例 ​

パラメータ ​

上記で示されているように、各コード (%B、%e、%I など) は日時の特定の要素を表します。カンマ (,)、スラッシュ (/)、コロン (😃 といった静的なテキストや句読点を挿入することもできます。以下に示すのは、Workato でよく使われるコードの一覧です。

完全なリストについては、Ruby のドキュメントを参照してください。

動作 ​

ユーザーが日時の書式を定義できるようにします。日時の入力データを、指定された書式で返します。

関連情報 ​

• to_date: 日付を日付のデータ型で返します。

in_time_zone ​

IANA のタイムゾーンデータベースに含まれるタイムゾーン名を使用して、日付または日時を異なるタイムゾーンに変換できます。この formula は日時を返します。

構文 ​

Date.in_time_zone(timezone)

• Date - 入力日付または入力日時。
• timezone - (任意) 目的のタイムゾーン。指定されていない場合、この formula は Workato アカウントで定義されたタイムゾーンを返します。

使用例 ​

dst? ​

入力日時が夏時間の範囲内にある場合、true を返します。

構文 ​

Datetime.dst?

• Datetime - 入力日付または入力日時。

使用例 ​

リージョンの参考情報 ​

この formula で使用するタイムゾーン名については、以下の表を参照してください。

to_date ​

この formula は入力データを日付に変換します。YYYY-MM-DD 形式の日付を返します。

構文 ​

String.first(format: format)

• String - 入力日時、または日付や日時を表す文字列。
• format - (任意) 文字列として記述された、入力データの日付形式。指定されていない場合、入力文字列が自動的に解析されます。

使用例 ​

動作 ​

入力データを日付データ型に変換します。

関連情報 ​

• strftime: 日付をカスタム書式で返します。
• to_time: 文字列を ISO タイムスタンプに変換します。

to_time ​

文字列を ISO タイムスタンプに変換します。レスポンスには UTC タイムゾーン (+00:00) が使用されます。

構文 ​

String.to_time(format)

• String - 日付または日時を表す入力文字列。
• format - 文字列として記述された、ユーザー定義の日時の書式。

使用例 ​

動作 ​

入力文字列を日時データ型に変換します。出力日時は UTC タイムゾーン (+00:00) に変換されます。

関連情報 ​

• strftime: 日付をカスタム書式で返します。
• to_date: この formula は日付に類似した入力データを日付に変換します。YYYY-MM-DD 形式の日付を返します。

パラメータ ​

上記で示されているように、各コード (%B、%e、%I など) は datetime の特定の要素を表します。カンマ (,)、スラッシュ (/)、コロン (:) といった静的なテキストや句読点を挿入することもできます。よく使われるコードについては、以下のリストを参照してください。

完全なリストについては、Ruby のドキュメントを参照してください。

to_i ​

日時をエポック時間に変換します。UTC (+00:00) でエポック時間を返します。

構文 ​

Datetime.to_i

• Datetime - 入力日時。

使用例 ​

動作 ​

入力日時を整数に変換します。エポック時間を、ミリ秒単位ではなく秒単位で返します。出力日時は UTC タイムゾーン (+00:00) に変換されます。

関連情報 ​

• to_time: 文字列を ISO タイムスタンプに変換します。
• to_date: この formula は日付に類似した入力データを日付に変換します。YYYY-MM-DD 形式の日付を返します。
• in_time_zone: 時刻の値を別のタイムゾーンに変換します。