変換関数 ​

変換関数は特定の型の値を構築します。各関数は生成する型の名前を使用し、大文字で始まります。たとえば、Decimal('19.99')はDecimal値を作成します。

通常、インバウンドデータは文字列として到着するため、変換関数を使用すると、インバウンドデータが式に入る場所で値の型を明示的に制御できます。 WELは、文字列補間と2つの設定可能なTransform dataフラグを除き、呼び出しを成功させるために引数を変換しません。境界で明示的に変換することで、ダウンストリームの操作の型安全性と予測可能性が維持されます。

数値 ​

WELには、各数値型に1つずつ、3つの数値コンストラクターがあります。

Integer ​

Integerに変換します。既存のIntegerまたは数字の文字列を受け入れます。

変換は厳密です。有効な整数以外を含む文字列はE102を発生させます。たとえば、Integer('3 items')は3を返すのではなくエラーを発生させます。

Integer(value)

Integer('42')

42

Integer(42)

42

Decimal ​

Decimal、つまり正確な任意精度の数値に変換します。

金額にはDecimalを使用します。正確な桁がコンストラクターに渡るように、Decimal('19.99')など、値を文字列として渡します。 Decimal(19.99)は、すでに近似値であるFloatを変換するため、Decimalが保持するために存在する正確性が失われます。

Decimalはスケールも保持するため、Decimal('12.50')は算術演算中も末尾のゼロを保持し、合計は12.5になるのではなく通貨金額のままになります。

Decimal(value)

Decimal('19.99')

19.99

Decimal(5)

5

Float ​

Float、つまりバイナリ浮動小数点数に変換します。

近似精度が許容される測定値、比率、科学的な値に適しています。 Floatはほとんどの小数を正確に表現できないため、金額には適していません。正確な算術演算には、代わりにDecimalを参照してください。

Float(value)

Float('3.14')

3.14

テキストと真偽値 ​

次のコンストラクターはString、Bool、Binaryに変換します:

String ​

data-planeロケールを使用して、スカラー値をStringに変換します。

Binaryとコレクションを拒否します。 ListまたはMapが暗黙的に、またはこの関数によって文字列に変換されることはありません。コレクションを意図的にシリアル化するには、to_jsonまたはto_welを使用します。この制限が存在するのは、暗黙のうちに文字列化されたコレクションが、ダウンストリームで最も気付きにくい変換バグの1つであるためです。

String(value)

String(42)

42

String(Decimal('19.99'))

19.99

Bool ​

値をBooleanに変換します。既存のBoolean、または文字列'true'と'false'を受け入れます。

'yes'、'1'、'Y'は、意味がソースシステムに依存するため受け入れられません。ソース固有の値を明示的にBooleanにマッピングします:

if _.flag == 'Y' then true else false

Bool(value)

Bool('true')

true

Binary ​

ASCII文字列をBinaryバイトに変換します。

ASCIIではないテキストには、明示的なエンコーディングを受け取るencode_stringを使用します。 Binaryは、非ASCII入力でエンコーディングを選択するのではなくE008を発生させます。

Binary(value)

Binary('AB')

0x"4142"

日付と時刻 ​

WELでは、正確な瞬間と、タイムゾーンのないカレンダー日付または壁時計時刻を区別します。正しい型を選択すると、タイムゾーンをまたぐ日付のずれを防ぐのに役立ちます。構築後に各型を操作する方法については、一時関数を参照してください。

DateTime ​

DateTime、つまりタイムゾーンを持つ正確な瞬間に変換します。

作成タイムスタンプ、イベント時刻、監査レコードなど、発生するイベントの記録に使用します。

DateTime(value)

DateTime('2026-03-15T09:30:00Z')

2026-03-15T09:30:00Z

PlainDate ​

PlainDate、つまり時刻もゾーンもないカレンダー日付に変換します。

請求書の日付、生年月日、契約開始日など、どこでも同じ日付に使用します。 PlainDateの代わりに保存されたDateTimeは、ゾーン境界をまたぐと1日ずれることがあります。

PlainDate(value)

PlainDate('2026-03-15')

2026-03-15

PlainTime ​

PlainTime、つまり店舗の開店時刻など、日付もゾーンもない時刻に変換します。

PlainTime(value)

PlainTime('09:30:00')

09:30:00

PlainDateTime ​

PlainDateTime、つまりゾーンのない日付と時刻に変換します。

PlainDateTimeはDateTime引数を変換するのではなく、そこからゾーンを取り除くため、壁時計の読み取り値はそのまま保持されます。

PlainDateTime(value)

PlainDateTime('2026-03-15T09:30:00')

2026-03-15T09:30:00

Duration ​

Duration、つまりISO 8601期間形式で記述された時間の長さに変換します。たとえば、PT1H30Mです。

Duration(value)

Duration('PT1H30M')

PT1H30M

センチネル ​

次のコンストラクターは、不在を表すためにWELが使用する2つのマーカーを構築します:

Null ​

nullを返します。引数は取りません。

Null()

Null()

null

Skip ​

Skipセンチネルを返します。引数は不要です。

Skipは、フィールドにnullを送信するのではなく、そのフィールドを完全に省略します。 Skipがmap_by内でリストをフィルタリングする方法を含む完全な比較については、Null and Skipを参照してください。宛先が明示的にクリアされたフィールドと未変更のフィールドを区別する場合は、Skipを使用します。多くのCRM APIがこれに該当します。

スキップする()

ユースケース: 境界でインバウンドペイロードを変換する ​

論理的には文字列ではないものを含め、すべてのフィールドが文字列として到着します。残りの変換が実際の型で機能できるように、先頭で1回だけ変換します:

入力

{
  "id": 1001,
  "qty": "3",
  "total": "149.50",
  "shipped": "true",
  "ship_date": "2026-03-15"
}

Formula

{
  order_id: String(_.id),
  qty: Integer(_.qty),
  total: Decimal(_.total),
  shipped: Bool(_.shipped),
  ship_date: PlainDate(_.ship_date)
}

出力

{
  "order_id": "1001",
  "qty": 3,
  "total": 149.50,
  "shipped": true,
  "ship_date": "2026-03-15"
}

Decimalはスケールを保持するため、totalは末尾のゼロを保持します。 ship_dateはPlainDateであるため、後続のステップでタイムゾーンが適用されても1日ずれることはありません。

関連情報 ​

• データ型：16個のWELデータ型と、それぞれを使用するタイミング。
• 数値関数: Decimalを丸めます。
• 一時関数: 変換後の日付を操作します。
• エラーコード: E008やE102などのジョブ失敗をトラブルシューティングします。