轉換函式 conversion-functions

• 小數
• 布林值
• 字串
• 整數

toBool(<decimal>)

toBool(<boolean>)

toBool(<string>)

toBool(<integer>)

傳回布林值。

toBool("true")

toBool(1)

傳回true。

toBool("this is not a boolean")

傳回false。

toDateOnly(<dateTime>)

toDateOnly(<dateTimeOnly>)

toDateOnly(<string>)

toDateOnly(<integer>, <integer>, <integer>)

傳回dateOnly型別值。

toDateOnly("2023-08-18")

toDateOnly("2023-08-18T00:00:00.000Z")

toDateOnly("2023-08-18T00:00:00")

所有傳回代表2023-08-18的dateOnly物件。

toDateOnly(#{ExperiencePlatform.ProfileFieldGroup.person.birthDate})

傳回dateOnly。

toDateTime(<string>)

toDateTime(<string>, <dateOnly>)

toDateTime(<string>, <dateTimeOnly>)

toDateTime(<integer>)

傳回​日期時間。

toDateTime("2023-08-18T23:17:59.123Z")

傳回2023-08-18T23:17:59.123Z

ISO-8601字串已包含時區資訊。

toDateTime("Europe/Paris", toDateOnly("2023-08-18"))

傳回2023-08-18T00:00:00.000+02:00

這會將時區與僅限日期的值結合，以建立dateTime。 時間設定為指定時區的午夜(00:00:00)。

toDateTime("UTC", toDateTimeOnly("2023-08-18T23:17:59.123"))

傳回2023-08-18T23:17:59.123Z

這會透過將時區套用到dateTimeOnly值（沒有時區資訊）來建立dateTime。

toDateTime(1560762190189)

傳回2019-06-17T09:03:10.189Z

將以毫秒為單位的Unix時間戳記轉換為dateTime值。

toDateTimeOnly(<dateTime>)

toDateTimeOnly(<string>)

傳回日期時間而不考慮時區。

toDateTimeOnly ("2023-08-18")

傳回代表2023-08-18T00:00:00.000的dateTime

toDateTimeOnly(now())

toDecimal(<integer>)

toDecimal(<decimal>)

toDecimal(<string>)

toDecimal(<boolean>)

傳回小數。

toDecimal("4.0")

傳回4.0。

如果字串運算式：接受的格式是以ISO-8601期間格式PnDTnHnMn.nS為基礎，而天數則視為24小時。

字串以選用的符號開頭，以ASCII負號或正號表示。 如果為負值，則整個期間都會被否定。 ASCII字母「P」是下一個大寫或小寫。 然後會有四個區段，每個區段包含一個數字和一個尾碼。 區段的ASCII尾碼為"D"、“H”、“M"及"S”，分別代表日、小時、分鐘及秒，可使用大寫或小寫。 尾碼必須依序出現。 ASCII字母「T」必須在小時、分鐘或秒區段的第一個專案（如果有的話）之前出現。 四個區段中的至少一個必須存在，如果存在「T」，則在「T」之後必須至少有一個區段。 每個區段的數字部分必須包含一個或多個ASCII數字。 數字可以以ASCII負號或正號為前置詞。 必須分析的天數、小時數和分鐘數。 秒數必須剖析為以及選用的分數。 小數點可以是點或逗號。 分數部分可能有0到9位數。

toDuration(<string>)

toDuration(<integer>)

傳回持續時間。

toDuration("PT10H")

傳回10小時的持續時間。

toDuration("PT4S")

傳回4s的持續時間。

toDuration(4000)

傳回4s的持續時間。

toInteger(<dateTime>)

toInteger(<decimal>)

toInteger(<integer>)

toInteger(<string>)

toInteger(<boolean>)

傳回整數。

toInteger("4")

傳回4。

toString(<dateTimeOnly>)

toString(<dateTime>)

toString(<duration>)

toString(<boolean>)

toString(<integer>)

toString(<decimal>)

傳回字串。

toString(4)

傳回「4」。

toString(#{ExperiencePlatform.test_date.person.birthDate}))

傳回給定dateOnly欄位（XDM日期欄位）的字串表示法，例如「2023-08-18」。

toString(toDuration(1520))

傳回「PT1.52S」。

本節包含結構化知識，用於支援與本主題相關的解譯、擷取和問答。

如需完整瞭解，此資訊應結合本頁的檔案。 兩者皆非獨立來源；頁面說明功能，本節提供額外內容，以協助去除術語、意圖、適用性和限制條件的歧義。

• TL；DR：​此頁面記錄了AJO歷程運算式中的所有轉換函式，說明如何在字串、整數、小數、布林值、日期、日期時間和持續時間等型別之間轉換值。

意圖：

• 使用toDateTime將字串或epoch整數轉換為時區感知的日期時間
• 使用toDateTimeOnly將字串或日期時間轉換為無時區的日期時間
• 使用toDateOnly從字串或日期時間擷取僅日期值（年 — 月 — 日）
• 使用toInteger、toDecimal或toBool將值轉換為整數、十進位或布林值
• 使用toString將任何值序列化為它的字串表示法
• 使用toDuration將字串或毫秒整數轉換為持續時間

字彙表：

• dateTime：包含時區位移資訊​ （產品專用） ​的日期時間值
• dateTimeOnly：沒有時區資訊的datetime值​（產品特定）
• dateOnly：代表年月日的日期值，沒有時間元件​（產品特定）
• 持續時間：以ISO-8601格式表示的時間段（例如PT10H） （產品特定）
• epoch毫秒：自1970-01-01T00:00:00Z以來的Unix時間戳記以毫秒表示

護欄：

• toDateTime中的時區引數必須是字串常數 — 不允許欄位參考和動態運算式
• toDateTime和toDateTimeOnly的字串輸入必須遵循ISO-8601格式；格式錯誤的字串傳回null且沒有錯誤
• 帶有epoch整數的toDateTime需要毫秒；請在傳遞前將秒數形式的時間戳記乘以1000
• toBool只會針對完全相同的字串"true"傳回true；如"1"、"yes"或"TRUE"等字串會傳回false

術語：

• 正式名稱：轉換函式 — 縮寫：無 — 變體：型別轉換函式，型別轉換函式
• 同義字： “toDateTime” = “convert to datetime with timezone”； “toDateTimeOnly” = “convert to datetime without timezone”
• 請勿混淆：「toDateTime」（可感知時區）≠「toDateTimeOnly」（無時區）
• 請勿混淆：「toDateOnly」（僅限日期，無時間）≠「toDateTime」（具有時區的日期和時間）

常見問題集：

• 問：何時應該使用toDateTime而非toDateTimeOnly？ — 在時區資訊很重要時使用toDateTime （例如，排程或跨區域比較）；在只有當地日期時間相關且可以忽略時區時使用toDateTimeOnly。
• 問：為什麼toBool("TRUE")傳回false？ — toBool僅可辨識精確的小寫字串"true"；所有其他字串值（包括"TRUE"或"yes"）都會傳回false。
• 問：如何將Unix時間戳記（以秒為單位）轉換為dateTime？ — 將秒數值乘以1000以取得毫秒，然後傳給toDateTime，例如toDateTime(myField * 1000)。
• 問：是否可從設定檔屬性讀取toDateTime中的時區？ — 否，時區ID必須是字串常數；不支援欄位參考和運算式。
• 問：toDuration接受哪種格式作為字串？ — ISO-8601期間格式，例如"PT10H"表示10小時，或"P1DT2H"表示1天又2小時。