日付Formula ​

Workatoは、さまざまな日付および日時Formulaをサポートしています。

WorkatoのFormulaは、許可リストに登録されたRubyメソッドです。 これらのFormulaの構文と機能は、通常変更されていません。 Formulaがnull（Rubyではnilと表されます）に対して動作する場合、present?、presence、blank?を除き、ほとんどのFormulaはエラーを返し、ジョブを停止します。

詳細については、Rubyのtimeドキュメントを参照してください。 ただし、許可リストに登録されたRubyメソッドのみがサポートされます。 許可リストへの新しいFormulaの追加をリクエストするには、Customer Success Managerにお問い合わせください。

日付算術演算 ​

日付および日時データで算術演算を実行するには、次のキーワードを使用します:

• 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）はdatetimeの特定の要素を参照します。 カンマ（,）、スラッシュ（/）、コロン（:）などの静的テキストや句読点も追加できます。 よく使用されるコードの次の一覧を参照してください:

完全な一覧にアクセスするには、Rubyドキュメントを確認してください

仕組み ​

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

関連項目 ​

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

in_time_zone ​

IANAタイムゾーン名を使用して、日付または日時を別のタイムゾーンに変換します。 日時を返します。

構文 ​

Date.in_time_zone(timezone)

• Date - 入力日付または日時。
• timezone - 対象のタイムゾーン名（任意）。 有効なタイムゾーン名については、リージョンリファレンスを参照してください。

動作 ​

Formulaは呼び出し方によって動作が異なります:

• 引数なし - 太平洋時間を返します: now.in_time_zone
• タイムゾーン指定 - 指定したタイムゾーンに変換します: now.in_time_zone("America/New_York")
• 明示的なnil - UTCタイムゾーンを返します: now.in_time_zone(nil)

サンプル利用状況 ​

dst? ​

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

構文 ​

Datetime.dst?

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

サンプル利用状況 ​

リージョンリファレンス ​

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

to_date ​

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

構文 ​

String.to_date(format: format)

• String - 日付または日時を表す文字列入力。
• format - （任意）入力日付文字列の形式。 指定しない場合、Workatoは入力文字列を自動的に解析します。

サンプル利用状況 ​

仕組み ​

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

関連項目 ​

• strftime: カスタム形式のdatetimeを返します。
• to_time: 文字列をISOタイムスタンプに変換します。

to_time ​

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

構文 ​

String.to_time(format: format)

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

サンプル利用状況 ​

仕組み ​

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

関連項目 ​

• strftime: カスタム形式のdatetimeを返します。
• 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: 時間値を別のタイムゾーンに変換します。