Omnistudio 日期和時間函數

您位於此處：

Omnistudio 日期和時間函數

以日期和時間作業的函數。

Omnistudio ADDDAY 函數
傳回新增指定天數後的日期和時間。
Omnistudio ADDMONTH 函數
傳回新增指定月數後的日期和時間。
Omnistudio ADDYEAR 函數
在新增指定年數後傳回日期和時間。
Omnistudio AGE 函數
傳回指定生日的年齡。
Omnistudio AGEON 函數
傳回指定日期指定生日的年齡。
Omnistudio DATEDIFF 函數
將兩個指定日期之間的天數差異傳回為整數值。
Omnistudio DATETIMETOUNIX 函數
傳回指定日期和時間的 UNIX 時間毫秒數。
Omnistudio DAY 函數
將指定日期的日期傳回為整數值。
Omnistudio EOM 函數
傳回指定日期的月份最後一天日期和時間。
Omnistudio FORMATDATETIME 函數
以指定的格式和時區傳回日期和時間作為字串。
Omnistudio FORMATDATETIMEGMT 函數
以指定的格式和 GMT 時區傳回日期和時間作為字串。
Omnistudio HOUR 函數
將指定時間的小時傳回為整數值。
Omnistudio MINUTE 函數
將指定時間的分鐘傳回為整數值。
Omnistudio MONTH 函數
將指定日期的月份傳回為整數值。
Omnistudio NOW 函數
以指定的格式傳回目前日期和時間。
Omnistudio SECOND 函數
以整數值傳回指定時間的秒數。
Omnistudio TIMEDIFF 函數
以整數傳回兩個指定次之間的毫秒數差。
Omnistudio TODAY 函數
傳回目前日期。
Omnistudio UNIXTODATETIME 函數
傳回 UNIX 時間中指定的秒數或毫秒數的日期和時間。
Omnistudio YEAR 函數
將指定日期的年份傳回為整數值。

Omnistudio ADDDAY 函數

傳回新增指定天數後的日期和時間。

如果您指定日期和時間,請使用日期格式 "YYYY-MM-DD" 來保留輸入時間。使用日期格式 "MM/DD/YYYY" 重設時間至 00:00:00。

簽署

ADDDAY(date, days)

傳回值

日期時間

參數

參數	資料類型	必要	描述
`date`	日期時間	必要	以 Day.js 格式指定為字串的日期。您可以指定日期和時間。
`days`	整數	必要	要新增至指定日期的天數。使用負數減去該日期的天數。

新增天數範例

公式:ADDDAY("2025-01-01", 31)

公式:ADDDAY("01/01/2025", 31)

公式:ADDDAY("01/01/2025T12:00:00Z", 31)

傳回值:"2025-02-01T00:00:00.000Z"

新增天數範例

公式:ADDDAY("2025-01-01T12:00:00Z", 31)

傳回值:"2025-02-01T12:00:00.000Z"

減去天數範例

公式:ADDDAY("2025-01-01", -100)

公式:ADDDAY("2025-01-01T00:00:00Z", -100)

傳回值:"2024-09-23T00:00:00.000Z"

Omnistudio ADDMONTH 函數

傳回新增指定月數後的日期和時間。

如果您指定日期和時間,請使用日期格式 "YYYY-MM-DD" 來保留輸入時間。使用日期格式 "MM/DD/YYYY" 重設時間至 00:00:00。

簽署

ADDMONTH(date, months)

傳回值

日期時間

參數

參數	資料類型	必要	描述
`date`	日期時間	必要	以 Day.js 格式指定為字串的日期。您可以指定日期和時間。
`months`	整數	必要	要新增至指定日期的月數。使用負數來減去該日期的月數。

新增月數範例

公式:ADDMONTH('2025-25-01', 15)

公式:ADDMONTH("01/25/2025", 15)

公式:ADDMONTH("01/25/2025T16:35:30Z", 15)

傳回值:"2026-04-25T00:00:00.000Z"

新增月數範例

公式:ADDMONTH("2025-01-25T16:35:30Z", 15)

傳回值:"2026-04-25T16:35:30.000Z"

減去月數範例

公式:ADDMONTH("01/25/2025", -15)

公式:ADDMONTH('01/25/2025T16:35:30Z', -15)

傳回值:"2023-10-25T00:00:00.000Z"

Omnistudio ADDYEAR 函數

在新增指定年數後傳回日期和時間。

如果您指定日期和時間,請使用日期格式 "YYYY-MM-DD" 來保留輸入時間。使用日期格式 "MM/DD/YYYY" 重設時間至 00:00:00。

簽署

ADDYEAR(date, years)

傳回值

日期時間

參數

參數	資料類型	必要	描述
`date`	日期時間	必要	以 Day.js 格式指定為字串的日期。您可以指定日期和時間。
`years`	整數	必要	要新增至指定日期的年數。使用負數減去該日期的年數。

新增年份範例

公式:ADDYEAR("2025-01-01", 10)

公式:ADDYEAR("01/01/2025", 10)

公式:ADDYEAR("01/01/2025T16:35:30", 10)

傳回值:"2035-01-01T00:00:00.000Z"

新增年份範例

公式:ADDYEAR("2025-01-01T16:35:30", 10)

傳回值:"2035-01-01T16:35:30.000Z"

減去年份範例

公式:ADDYEAR("2025-01-01", -10)

公式:ADDYEAR("2025-01-01T00:00:00", -10)

傳回值:"2015-01-01T00:00:00.000Z"

Omnistudio AGE 函數

傳回指定生日的年齡。

簽署

AGE(birthDate)

傳回值

整數

參數

參數	資料類型	必要	描述
`birthDate`	日期時間	必要	以 Day.js 格式指定為字串的日期。您可以指定日期和時間。

日期字串範例

公式:AGE("02/15/2002")

公式:AGE("2002-02-15")

傳回值:23

日期和時間字串範例

公式:AGE("2002-02-15T16:35:30")

公式:AGE("2002-02-15T16:35:30Z")

傳回值:23

Omnistudio AGEON 函數

傳回指定日期指定生日的年齡。

此函數只會根據日期計算帳齡;它會忽略時間。如果指定的 date 開始於少於一年的時間,或早於 birthDate,則函數會傳回 0。

簽署

AGEON(birthDate, date)

傳回值

整數

參數

參數	資料類型	必要	描述
`birthDate`	日期時間	必要	要計算年齡的生日。以 Day.js 格式指定日期作為字串。您可以指定日期和時間。
`date`	日期時間	必要	函數是根據生日計算年齡的日期。以 Day.js 格式指定日期作為字串。您可以指定日期和時間。

日期和時間字串範例

公式:AGEON("02/15/2002T16:35:30Z", "2030-02-28")

公式:AGEON("2002-02-15", "2030-02-28T16:35:30Z")

傳回值:28

JSON 物件範例

範例資料:

"BirthDate": "6/25/2004T09:05:00 GMT -0500 (EDT)"
"FutureDate1": "02/28/2030",
"FutureDate2": "2030-02-28"

公式:AGEON(%Birthdate%, %FutureDate1%)

公式:AGEON("BirthDate%, %FutureDate2%)

傳回值:25

Omnistudio DATEDIFF 函數

將兩個指定日期之間的天數差異傳回為整數值。

第一個日期會從第二個日期減去。如果第一個日期大於第二個日期,則函數會傳回負整數。

如果您包含時間,則函數會在計算中考量時間。如果您指定時區,則函數會在其計算中考量該時區。

簽署

DATEDIFF(firstDate, secondDate)

傳回值

整數

參數

參數	資料類型	必要	描述
`firstDate`	日期	必要	以 Day.js 格式指定為字串的日期。您可以指定日期和時間。
`secondDate`	日期	必要	函數用於計算第一個日期之間天數差異的日期。以 Day.js 格式指定日期作為字串。您可以指定日期和時間。

正數天數範例

公式:DATEDIFF("02/01/2000", "2001-02-01")

傳回值:366

負天數範例

公式:DATEDIFF("2001-02-01", "02/01/2000")

傳回值:-366

日期和時間範例

公式:DATEDIFF("2025-02-04T00:00:00", "2025-03-04T00:00:00")

傳回值:28

日期和時間範例

公式:DATEDIFF("2025-02-04T12:00:00", "2025-03-04T11:59:59")

傳回值:27

含時區的日期和時間範例

公式:DATEDIFF("2025-02-04T12:00:00-0500", "2025-03-04T11:59:59+0000")

傳回值:28

JSON 物件範例

範例資料:

"Account": [
  {
    "Cases": [
      {
        "Case1": {
          "CreatedDate": "2/1/2024T16:35:30 GMT -0500 (EDT)",
          "LastUpdate": "2/8/2024T09:15:00 GMT -0500 (EDT)"
        }
      },
      {
        "Case2": {
          "CreatedDate": "2/2/2025T11:05:05 GMT -0500 (EDT)",
          "LastUpdate": "2/3/2025T15:50:57 GMT -0500 (EDT)"
        }
      }
    ]
  }
]

公式:DATEDIFF(Account:Cases:Case1:CreatedDate, Account:Cases:Case1:LastUpdate)

傳回值:7

公式:DATEDIFF(%Account:Cases:Case2:CreatedDate%, TODAY())

傳回值:8

Omnistudio DATETIMETOUNIX 函數

傳回指定日期和時間的 UNIX 時間毫秒數。

UNIX 時間是自 1970 年 1 月 1 日 (國際標準時間 (UTC) 00:00:00 起經過的非跳轉秒數。UTC 與格林威治標準時間 (GMT) 相同。此值稱為 UNIX 世代。

簽署

DATETIMETOUNIX(datetime)

傳回值

整數

參數

參數	資料類型	必要	描述
`datetime`	日期時間	必要	以 Day.js 格式指定為字串的日期和時間。您也可以只指定日期。

日期和時間範例

公式:DATETIMETOUNIX("2002-02-01T16:35:30:000Z")

公式:DATETIMETOUNIX("2002-02-01T16:35:30:000")

公式:DATETIMETOUNIX("2002-02-01T16:35:30")

公式:DATETIMETOUNIX("02/01/2002T16:35:30")

傳回值:1012581330000

日期和零時間範例

公式:DATETIMETOUNIX("2002-02-01")

公式:DATETIMETOUNIX("02/01/2002")

公式:DATETIMETOUNIX("2002-02-01T00:00:00")

公式:DATETIMETOUNIX("02/01/2002T00:00:00")

公式:DATETIMETOUNIX("2002-02-01T00:00:00Z")

公式:DATETIMETOUNIX("02/01/2002T00:00:00Z")

傳回值:1012521600000

Omnistudio DAY 函數

將指定日期的日期傳回為整數值。

簽署

DAY(date)

傳回值

整數

參數

參數	資料類型	必要	描述
`date`	日期時間	必要	以 Day.js 格式指定為字串的日期。您可以指定日期和時間。

日期字串範例

公式:DAY("2025-01-31")

公式:DAY("01/31/2025")

公式:DAY("1/31/2025")

傳回值:31

JSON 物件範例

範例資料:"Birthdate": "2002-02-15T16:35:30 GMT -0500 (EDT)"

公式:DAY(Birthdate)

傳回值:15

Omnistudio EOM 函數

傳回指定日期的月份最後一天日期和時間。

簽署

EOM(date)

傳回值

日期時間

參數

參數	資料類型	必要	描述
`date`	日期時間	必要	以 Day.js 格式指定為字串的日期。您可以指定日期和時間。

日期範例

公式:EOM("2024-02-01")

公式:EOM("02/01/2024")

傳回值:"2024-02-29T00:00:00.000Z"

日期和時間範例

公式:EOM("02/01/2024T16:35:30")

公式:EOM("02/01/2024T16:35:30Z")

傳回值:"2024-02-29T00:00:00.000Z"

Omnistudio FORMATDATETIME 函數

以指定的格式和時區傳回日期和時間作為字串。

格林威治標準時間 (GMT) 與國際標準時間 (UTC) 相同,這是 UNIX 時間與 UNIX 世代的基礎。

簽署

FORMATDATETIME(datetime, format, timezone)

傳回值

字串

參數

參數	資料類型	必要	描述
`datetime`	日期時間	必要	以 Day.js 格式指定為字串的日期和時間。您只能指定日期或時間。如果您僅指定日期,則預設時間為 `00:00:00`。如果您僅指定時間,則預設日期為 `1970-01-01` (UNIX 世代)。
`format`	字串	選擇性	指定傳回日期和時間格式的字串。使用 Java SimpleDateFormat 標記法指定回應的格式。依預設,函數會傳回 `"MM/DD/YY HH:mm aaa"` 格式的日期和時間。
`timezone`	字串	選擇性	表示傳回日期和時間所在時區的字串。依預設,函數會以來電者的時區傳回日期和時間。若要使用不同的時區,請指定時區識別碼,例如 `America/New_York`。如需時區識別碼的完整清單,請參閱 IANA (TZDB) 時區資訊。如果您指定一個 `時區`,則您也必須指定一個 `格式`。

無時間、格式或時區的日期範例

公式:FORMATDATETIME("01/31/2025")

傳回值:"1/30/25 4:00 PM"

無格式或時區的日期時間範例

公式:FORMATDATETIME("01/31/2025T12:00:00")

傳回值:"1/31/25 4:00 AM"

沒有時區的日期時間範例

公式:FORMATDATETIME("01/31/2025T12:00:00", "yyyy-MM-dd'T'HH:mm:ssZ")

傳回值:"2025-01-31T04:00:00-0800"

日期時間範例

公式:FORMATDATETIME("01/31/2025T12:00:00", "yyyy-MM-dd'T'HH:mm:ssZ", "America/Los_Angeles")

傳回值:"2025-01-31T04:00:00-0800"

日期時間範例

公式:FORMATDATETIME("01/31/2025T12:00:00", "yyyy-MM-dd'T'HH:mm:ssZ", "America/New_York")

傳回值:"2025-01-31T07:00:00-0500"

Omnistudio FORMATDATETIMEGMT 函數

以指定的格式和 GMT 時區傳回日期和時間作為字串。

格林威治標準時間 (GMT) 與國際標準時間 (UTC) 相同,這是 UNIX 時間與 UNIX 世代的基礎。

簽署

FORMATDATETIMEGMT(datetime, timezone, format)

傳回值

字串

參數

參數	資料類型	必要	描述
`datetime`	日期時間	必要	以 Day.js 格式指定為字串的日期和時間。您只能指定日期或時間。如果您僅指定日期,則預設時間為 `00:00:00`。如果您僅指定時間,則預設日期為 `1970-01-01` (UNIX 世代)。
`timezone`	字串	選擇性	表示指定日期和時間時區的字串。依預設,此函數會使用來電者的時區。若要使用不同的時區,請指定時區識別碼,例如 `America/New_York`。如需時區識別碼的完整清單,請參閱 IANA (TZDB) 時區資訊。
`format`	字串	選擇性	指定傳回日期和時間格式的字串。使用 Java SimpleDateFormat 標記法指定回應的格式。依預設,函數會傳回 `"MM/DD/YY HH:mm aaa"` 格式的日期和時間。如果您指定一個 `格式`,則也必須指定一個 `時區`。

無時間、時區或格式範例的日期

公式:FORMATDATETIMEGMT("01/31/2025")

傳回值:"2025-01-31T08:00:00.000Z"

沒有時區或格式的日期時間範例

公式:FORMATDATETIMEGMT("01/31/2025T12:00:00")

傳回值:"2025-01-31T20:00:00.000Z"

無格式日期時間範例

公式:FORMATDATETIMEGMT("01/31/2025T12:00:00", "America/Los_Angeles")

傳回值:"2025-01-31T20:00:00.000Z"

日期時間範例

公式:FORMATDATETIMEGMT("01/31/2025T12:00:00", "America/Los_Angeles", "yyyy-MM-dd'T'HH:mm:ssZ")

傳回值:"2025-01-31T20:00:00+0000"

日期時間範例

公式:FORMATDATETIMEGMT("01/31/2025T12:00:00", "America/New_York", "yyyy-MM-dd'T'HH:mm:ssZ")

傳回值:"2025-01-31T17:00:00+0000"

Omnistudio HOUR 函數

將指定時間的小時傳回為整數值。

簽署

Hour(time)

傳回值

整數

參數

參數	資料類型	必要	描述
`time`	日期時間	必要	以 Day.js 格式指定為字串的時間。您可以指定日期和時間。

時間範例

公式:HOUR("08:00:00")

公式:HOUR("T08:00:00")

傳回值:8

日期和時間範例

公式:HOUR("2004-02-01T08:00:00Z")

公式:HOUR("02/01/2004T08:00:00Z")

傳回值:8

JSON 物件範例

範例資料:"DateField": "2003-02-01T16:35:30Z"

公式:HOUR(%DateField%)

傳回值:16

Omnistudio MINUTE 函數

將指定時間的分鐘傳回為整數值。

簽署

MINUTE(time)

傳回值

整數

參數

參數	資料類型	必要	描述
`time`	日期時間	必要	以 Day.js 格式指定為字串的時間。您可以指定日期和時間。

時間範例

公式:MINUTE("08:17:00")

公式:MINUTE("T08:17:00")

傳回值:17

日期和時間範例

公式:MINUTE("2004-02-01T08:17:00Z")

公式:MINUTE("02/01/2004T08:17:00Z")

傳回值:17

JSON 物件範例

範例資料:"DateField": "2003-02-01T16:35:30Z"

公式:MINUTE(DateField)

傳回值:35

Omnistudio MONTH 函數

將指定日期的月份傳回為整數值。

簽署

MONTH(date)

傳回值

整數

參數

參數	資料類型	必要	描述
`date`	日期時間	必要	以 Day.js 格式指定為字串的日期。您可以指定日期和時間。

日期字串範例

公式:MONTH("2025-01-01")

公式:MONTH("01/01/2025")

公式:MONTH("1/1/2025")

傳回值:1

JSON 物件範例

範例資料:"Birthdate": "2007-06-25T08:35:00Z"

公式:MONTH(%Birthdate%)

傳回值:6

Omnistudio NOW 函數

以指定的格式傳回目前日期和時間。

依預設,此函數會以國際標準時間 (UTC) 傳回日期和時間。UTC 與格林威治標準時間 (GMT) 相同。使用 $Vlocity.NOW 環境變數可套用使用者或組織的時區。

您可以將 NOW 函數搭配其他函數使用,以指定相對於目前日期和時間的日期和時間。

簽署

NOW(format)

傳回值

日期時間

參數

參數	資料類型	必要	描述
`format`	字串	選擇性	SimpleDateFormat 標記法中的格式字串,可指定回應的格式。依預設,函數會以 `"yyyy-MM-dd'T'HH:mm:ss:SSS"` UTC (GMT) 格式傳回日期和時間。

無格式範例

公式:NOW()

傳回值:"2025-03-08T22:01:46.684Z"

Java SimpleDateFormat 日期和時間範例

公式:NOW("yyyy-MM-dd'T'HH:mm:ss")

傳回值:"2025-03-08T22:10:42"

Java SimpleDateFormat 日期和時間範例

公式:NOW("yyyy-MM-dd'T'HH:mm:ss z")

傳回值:"2025-03-08T22:08:24 GMT"

Java SimpleDateFormat 日期和時間範例

公式:NOW("yyyy-MM-dd'T'HH:mm:ss Z")

傳回值:"2025-03-08T22:07:30 +0000"

Java SimpleDateFormat 日期和時間範例

公式:NOW("yyyy-MM-dd'T'HH:mm:ss:SSS")

傳回值:"2025-03-08T21:59:24:895"

Java SimpleDateFormat 日期和時間範例

公式:NOW("yyyy-MM-dd'T'HH:mm:ss:SSSz")

傳回值:"2025-03-08T21:57:48:740GMT"

Java SimpleDateFormat 日期和時間範例

公式:NOW("yyyy-MM-dd'T'HH:mm:ss:SSSZ")

傳回值:"2025-03-08T21:58:08:412+0000"

Java SimpleDateFormat 僅限日期範例

公式:NOW("yyyy-MM-dd")

公式:NOW("MM/dd/yyyy")

傳回值:"03/08/2025"

Java SimpleDateFormat 僅限時間範例

公式:NOW("HH:mm:ss")

傳回值:"22:12:30"

Java SimpleDateFormat 僅限時間範例

公式:NOW("HH:mm:ss.SSS")

傳回值:"22:13:43.304"

多個函數範例

範例資料:該函數會在 2025 年 3 月 8 日 10:16:19 UTC (GMT) ("2025-03-08T22:16:19Z") 呼叫。

公式:DATETIMETOUNIX(NOW("yyyy-MM-dd'T'HH:mm:ss"))

傳回值:1741472179000

多個函數範例

範例資料:該函數會在 2025 年 3 月 8 日 10:16:19 UTC (GMT) ("2025-03-08T22:16:19.956Z") 呼叫。

公式:DATETIMETOUNIX(NOW())

傳回值:1741472179956

Omnistudio SECOND 函數

以整數值傳回指定時間的秒數。

簽署

SECOND(time)

傳回值

整數

參數

參數	資料類型	必要	描述
`time`	日期時間	必要	以 Day.js 格式指定為字串的時間。您可以指定日期和時間。

時間範例

公式:SECOND("08:00:59")

公式:SECOND("T08:00:59")

傳回值:59

日期和時間範例

公式:SECOND("2004-02-01T08:00:59Z")

公式:SECOND("02/01/2004T08:00:59Z")

傳回值:59

JSON 物件範例

範例資料:"DateField": "2003-02-01T16:35:30Z"

公式:SECOND(%DateField%)

傳回值:30

Omnistudio TIMEDIFF 函數

以整數傳回兩個指定次之間的毫秒數差。

第二次會從第一次減去。如果第二次大於第一次,則函數會傳回負整數。如果您指定時區,則函數會在其計算中考量該時區。

簽署

TIMEDIFF(firstTime, secondTime)

傳回值

整數

參數

參數	資料類型	必要	描述
`firstTime`	日期時間	必要	以 Day.js 格式指定為字串的時間。您可以指定日期和時間。如果您僅指定日期,則函數會使用 `00:00:00:000` 作為時間。
`secondTime`	日期時間	必要	函數用於計算第一次次數之間毫秒數差異的時間。以 Day.js 格式指定時間作為字串。您可以指定日期和時間。如果您僅指定日期,則函數會使用 `00:00:00:000` 作為時間。

正數時間範例

公式:TIMEDIFF("16:35:30", "08:00:15")

傳回值:30915000

負時間範例

公式:TIMEDIFF("T08:00:15", "T16:35:30")

傳回值:-30915000

正數日期範例

公式:TIMEDIFF("2001-02-01", "02/01/2000")

傳回值:31622400000

含時區的日期和時間範例

公式:TIMEDIFF("03/01/2025T12:00:00+0000", "03/01/2025T12:00:00-0500")

傳回值:43200000

JSON 物件範例

範例資料:

"Account": [
  {
    "Cases": [
      {
        "Case1": {
          "CreatedDate": "2/1/2024T16:35:30 GMT -0500 (EDT)",
          "LastUpdate": "2/8/2024T09:15:00 GMT -0500 (EDT)"
        }
      },
      {
        "Case2": {
          "CreatedDate": "2/2/2025T11:05:05 GMT -0500 (EDT)",
          "LastUpdate": "2/3/2025T15:50:57 GMT -0500 (EDT)"
        }
      }
    ]
  }
]

公式:TIMEDIFF(Account:Cases:Case2:CreatedDate, Account:Cases:Case2:LastUpdate)

傳回值:-86400000

公式:TIMEDIFF(%Account:Cases:Case2:LastUpdate%, %Account:Cases:Case2:CreatedDate%)

傳回值:86400000

Omnistudio TODAY 函數

傳回目前日期。

TODAY 函數一律傳回 "YYYY-MM-DD" 格式的目前日期。依預設,此函數會傳回國際標準時間 (UTC) 的日期。UTC 與格林威治標準時間 (GMT) 相同。使用 $Vlocity.NOW 環境變數可套用使用者或組織的時區。

您可以將 TODAY 函數搭配其他函數使用,以指定相對於目前日期的日期。

簽署

TODAY()

傳回值

日期時間

參數

無

今日範例

公式:TODAY()

傳回值:"2025-01-15"

下一年的第一天範例

公式:CONCAT(YEAR(ADDYEAR(TODAY(), 1)), "-01-01")

傳回值:"2026-01-01"

Omnistudio UNIXTODATETIME 函數

傳回 UNIX 時間中指定的秒數或毫秒數的日期和時間。

UNIX 時間是自 1970 年 1 月 1 日 (國際標準時間 (UTC) 00:00:00 起經過的非跳轉秒數。UTC 與格林威治標準時間 (GMT) 相同。此值稱為 UNIX 世代。

簽署

UNIXTODATETIME(timestamp)

傳回值

日期時間

參數

參數	資料類型	必要	描述
`timestamp`	整數	必要	正整數,代表自 UNIX 世代經過的秒數或毫秒數。此值稱為 UNIX 時間戳記。

時間戳記 (以秒為單位) 範例

公式:UNIXTODATETIME(1012581330)

傳回值:"2002-02-01T16:35:30.000Z"

時間戳記 (以毫秒為單位) 範例

公式:UNIXTODATETIME(1012581330000)

傳回值:"2002-02-01T16:35:30.000Z"

Omnistudio YEAR 函數

將指定日期的年份傳回為整數值。

簽署

YEAR(date)

傳回值

整數

參數

參數	資料類型	必要	描述
`date`	日期時間	必要	以 Day.js 格式指定為字串的日期。您可以指定日期和時間。

日期字串範例

公式:YEAR("2025-01-01")

公式:YEAR("01/01/2025")

公式:YEAR("1/1/2025")

傳回值:2025

JSON 物件範例

範例資料:

"Account": [
  {
    "Cases": [
      {
        "Case1": {
          "CreatedDate": "2/1/2024T16:35:30 GMT -0500 (EDT)",
          "LastUpdate": "2/8/2024T09:15:00 GMT -0500 (EDT)"
        }
      },
      {
        "Case2": {
          "CreatedDate": "2/2/2025T11:05:05 GMT -0500 (EDT)",
          "LastUpdate": "2/3/2025T15:50:57 GMT -0500 (EDT)"
        }
      }
    ]
  }
]

公式:YEAR(Account:Cases:Case1:CreatedDate)

傳回值:2024

公式:YEAR(Account:Cases:Case2:CreatedDate)

傳回值:2025

此文章是否解決您的問題？

請讓我們知道，以便我們改進！

此文已使用 Salesforce 機器翻譯系統翻譯。更多詳細資料請參見此處。切換至英文不要現在

產品區域

功能影響

版本

經驗

Omnistudio 日期和時間函數

Omnistudio ADDDAY 函數

簽署

傳回值

參數

Omnistudio ADDMONTH 函數

簽署

傳回值

參數

Omnistudio ADDYEAR 函數

簽署

傳回值

參數

Omnistudio AGE 函數

簽署

傳回值

參數

Omnistudio AGEON 函數

簽署

傳回值

參數

Omnistudio DATEDIFF 函數

簽署

傳回值

參數

Omnistudio DATETIMETOUNIX 函數

簽署

傳回值

參數

Omnistudio DAY 函數

簽署

傳回值

參數

Omnistudio EOM 函數

簽署

傳回值

參數

Omnistudio FORMATDATETIME 函數

簽署

傳回值

參數

Omnistudio FORMATDATETIMEGMT 函數

簽署

傳回值

參數

Omnistudio HOUR 函數

簽署

傳回值

參數

Omnistudio MINUTE 函數

簽署

傳回值

參數

Omnistudio MONTH 函數

簽署

傳回值

參數

Omnistudio NOW 函數

簽署

傳回值

參數

Omnistudio SECOND 函數

簽署

傳回值

參數

Omnistudio TIMEDIFF 函數

簽署

傳回值

參數

Omnistudio TODAY 函數

簽署

傳回值

參數

Omnistudio UNIXTODATETIME 函數

簽署

此文已使用 Salesforce 機器翻譯系統翻譯。更多詳細資料請參見此處。