在薪酬計算時候，一些薪酬項目計算是需要取值到僱員排班考勤起始日期、薪酬計算週期起始日期、薪資支付日期，並計算出這些開始和結束日期之間相差的天數/月份/年數。

workstem提供了相關的函數：

DateDiff( , , ,) 、DateAdd( , , ,)、PayRunCycleStartDate()、PayRunCycleEndDate()、PayRunAttendStartDate() 、PayRunAttendEndDate()、PayRunPayDate()

在薪酬項目計算的時候，可以靈活運用這類函數進行計算，下面詳細介紹這些函數的使用：

「薪酬」> 「設置」 >「薪酬項目」>「設置」

點擊「設置」進入「薪酬項目」詳情界面，找到對應需要設置公式的項目點開「公式」或新增項目到公式設置步驟，進入「薪酬項目」公式設置界面

1、函數DateDiff(Date Part, StartDate, EndDate,)、PayRunCycleStartDate() 、PayRunCycleEndDate()：

a. DateDiff(Part, StartDate, EndDate)

功能說明：計算指定兩個日期之間的時間差

參數列表：

Date Part可選範圍：DAY / MONTH / YEAR

StartDate/EndDate 格式：YYYY-MM-DD

示例：

// 結果為 364

var c = DateDiff (DAY, '2019-01-01', '2019-12-31')

// 結果為 11

var d = DateDiff (MONTH, '2019-01-01', '2019-12-31')

b. PayRunCycleStartDate()

功能說明：返回當前薪酬計算週期的開始日期

無參數

示例：

// 假設當前薪酬計算週期是2020-03-01 到 2020-03-31 其結果為 2020-03-01

var b = PayRunCycleStartDate()

c. PayRunCycleEndDate()

功能說明：返回當前薪酬計算週期的結束日期

無參數

示例：

// 如果當前薪酬計算週期是2020-03-01 到 2020-03-31 其結果為 2020-03-31

var a = PayRunCycleEndDate ()

2、函數DateAdd(Part, number, Date)、PayRunAttendStartDate()、PayRunAttendEndDate()

a. DateAdd(Part, number, Date)

功能說明：推算一個特定的日期

參數說明：

Date Part：字符串可選範圍 DAY/MONTH/YEAR，

Date：完整日期YYYY-MM-DD

Number：整數，往前（正數）或往後（負數）推算的日期值

示例：

// 結果為 2019-12-15

var a = DateAdd (DAY, -5, '2019-12-20')

// 結果為 2020-05-20

var b = DateAdd (MONTH, 5, '2019-12-20')

b. PayRunAttendStartDate()

功能說明：返回當前薪酬計算週期中所採用的考勤週期開始日期

無參數

示例：

// 如果當前的薪酬計算週期採用的考勤時間是2020-03-01 到 2020-03-31

//結果為 2020-03-01

var c = PayRunAttendStartDate ()

c. PayRunAttendEndDate()

功能說明：返回當前薪酬計算週期中所採用的考勤週期結束日期

無參數

示例：

// 如果當前的薪酬計算週期採用的考勤時間是2020-03-01 到 2020-03-31

//結果為 2020-03-31

var d = PayRunAttendStartDate ()