中的日期和時間函式 Adobe Workfront Fusion

存取需求

您必須具有下列存取權才能使用本文中的功能：

如需有關此表格的詳細資訊，請參閱 Workfront檔案中的存取需求.

有關的資訊 Adobe Workfront Fusion 授權，請參閱 Adobe Workfront Fusion 授權.

變數

now

timestamp

函數

addSeconds (date； number)

將指定秒數新增至日期後，傳回新日期。 若要減去秒數，請輸入負數。

addMinutes （日期；數字） addminutes-date-number

將指定分鐘數新增至日期後，傳回新日期。 若要減去分鐘，請輸入負數。

addHours （日期；數字） addhours-date-number

將指定小時數新增至日期後，傳回新日期。 若要減去時數，請輸入負數。

addDays （日期；數字） adddays-date-number

將指定天數新增至日期後，傳回新日期。 若要減去天數，請輸入負數。

addMonths (date； number)

將指定月份數新增至日期後，傳回新日期。 若要減去月份，請輸入負數。

addYears （日期；數字）

將指定年份新增至日期後，傳回新日期。 若要減去年數，請輸入負數。

setSecond （日期；數字）

此函式使用引數中指定的秒數傳回新日期。

指定從0到59的數字。 如果數字超出該範圍，此函式會傳回前一分鐘的第二秒（代表負數）或後續的分鐘（代表正數）。

如果您需要指定範圍以外的數字，我們建議您使用​ addSeconds，如一節中所述 addSeconds (date； number).

setMinute （日期；數字）

此函式使用引數中指定的分鐘數傳回新日期。

指定從0到59的數字。 如果數字超出該範圍，此函式會傳回前一小時（負數）或後續小時（正數）的分鐘數。

如果您需要指定超出範圍的數字，建議您使用addMinutes，如上所述 addMinutes （日期；數字）.

setHour （日期；數字）

此函式使用引數中指定的小時數傳回新日期。

指定從0到23的數字。 如果數字超出此範圍，此函式會傳回前一天的一小時（若為負數）或後續的天數（若為正數）。

如果您需要指定範圍外的數字，建議您使用addHours，如上所述 addHours （日期；數字）.

setDay （日期；英文的當日編號/名稱）

此函式傳回具有引數中所指定日期的新日期。

您可以使用此函式將星期日設為1，將星期六設為7。 如果您指定從1到7的數字，則產生的日期會在目前（星期日至星期六）的周內。 如果數字超出該範圍，此函式會傳回前一週（負數）或後續周（正數）的某天。

如果您需要指定超出範圍的數字，建議您使用addDays，如上所述 addDays （日期；數字）.

setDate (date； number)

此函式傳回新的日期，其中包含引數中指定的月份日期。

指定從1到31的數字。 如果數字超出此範圍，此函式會傳回前一個月中的一天（如果是負數）或後續的月份（如果是正數）。

setMonth （日期；英文的月份編號/名稱）

此函式使用引數中指定的月份傳回新日期。

指定從1到12的數字。 如果數字超出此範圍，此函式會傳回前一年（負數）或後續年度（正數）中的月份。

setYear （日期；數字）

以引數中指定的年份傳回新日期。

formatDate (日期；格式； [時區])

當您有日期值時，使用此函式，例如 12-10-2021 20:30，並且想要格式化為文字值，例如 Dec 10, 2021 8:30 PM.

例如，當您需要將某個應用程式或Web服務的日期格式變更為相同案例中連線應用程式或Web服務的日期格式時，這個選項會很有用。

如需詳細資訊，請參閱 日期 和 文字 在文章中 Adobe Workfront Fusion中的專案資料型別.

參數

如果提供不同的型別，則會套用型別強制執行。 如需詳細資訊，請參閱 輸入強制 Adobe Workfront Fusion.

傳回值和型別

此 formatDate 函式會根據指定的格式和時區，傳回指定日期值的文字表示法。 資料型別為「文字」。

INFO

範例： 情境和網頁時區皆設為 Europe/Prague 在這些範例中。

• formatDate(1. Date created;MM/DD/YYYY)

  傳回2018/10/01

• formatDate(1. Date created; YYYY-MM-DD hh:mm A)

  傳回2018-10-01 09:32 AM

• formatDate(1. Date created;DD.MM.YYYY HH:mm;UTC)

  傳回01.10.2018 07:32

• formatDate(now;DD.MM.YYYY HH:mm)

  傳回19.03.2019 15:30

parseDate (文字；格式； [時區])

當您有代表日期的文字值時(例如 12-10-2019 20:30 或 Aug 18, 2019 10:00 AM)，並且您想要將其轉換（剖析）為Date值（二進位電腦可讀表示法）。 如需詳細資訊，請參閱 日期 和 文字 在文章中 中的專案資料型別 Adobe Workfront Fusion.

參數

第二欄指出預期的型別。 如果提供不同的型別，則會套用型別強制執行。 如需詳細資訊，請參閱 輸入強制 Adobe Workfront Fusion.

如果提供不同的型別，則會套用型別強制執行。 如需詳細資訊，請參閱 輸入強制 Adobe Workfront Fusion.

傳回值和型別

此函式根據您指定的格式和時區將文字字串轉換為日期。 值的資料型別為「日期」。

dateDifference (Date1； Date2； Unit)

傳回代表兩個日期之間差異的數字，以指定的單位表示。

從Date1減去Date2。

使用下列其中一個時間值 unit 引數：

若未指定單位，此函式會傳回毫秒差。

其他範例

如何計算每個月中每週的第n天

本節內容適用於 Workfront Fusion 從 Exceljet 說明如何取得一個月中一週的第n天的網頁。

如果您需要計算與當月第n天對應的日期（例如，第一個星期二、第三個星期五等），您可以使用下列公式：

{{addDays(setDate(1.date; 1); 1.n * 7 - formatDate(addDays(setDate(1.date; 1); "-" + 1.dow); "E"))}}

公式包含下列專案：

如果您只想計算一個特定案例，例如，在每個星期三，您可以取代專案 1.n 和 2.dow 在公式中具有對應編號。 對於當月的第二個星期三，您會使用下列值：

說明：

如何計算日期之間的天數

一種可能是使用以下運算式：

{{round((2.value - 1.value) / 1000 / 60 / 60 / 24)}}

如何計算月份的最後一天/毫秒

當您指定日期範圍時，例如在搜尋模組中，如果範圍跨越整個前一個月為關閉間隔（包括其兩個限制點的間隔），則需要計算該月的最後一天。

2019-09-01 ≤ D ≤ 2019-09-30

下列公式顯示一種計算前一個月最後一天的方法：

{{addDays(setDate(now; 1); -1)}}

在某些情況下，您不僅需要計算當月的最後一天，還需要實際計算其最後一毫秒：

2019-09-01T00:00:00.000Z ≤ D ≤ 2019-09-30T23:59:59.999盎司

此公式顯示計算前一個月最後一毫秒的一種方式：

{{parseDate(parseDate(formatDate(now; "YYYYMM01"); "YYYYMMDD"; "UTC") - 1; "x")}}

如果您需要結果來使用時區設定，請省略UTC引數：

{{parseDate(parseDate(formatDate(now; "YYYYMM01"); "YYYYMMDD") - 1; "x")}}

不過，最好改用半開間隔（排除其限制點之一的間隔），改為指定下個月的第一天，並將「小於或等於」運運算元取代為「小於」，如下所示：

2019-09-01 ≤ D < 2019-10-01

2019-09-01T00:00:00.000Z ≤ D < 2019-10-01T00:00:00.000Z