全部系列
考勤(香港)
考勤數據
常用的考勤函數,考勤項目說明
常用的考勤函數,考勤項目說明

不知道如何新增考勤項目的計算公式?在這裡找到你所需要的公式,即可立即套用!

Workstem CS avatar
作者:Workstem CS
一週前已更新

1. 取絕對值

函數名:Abs(Expression)

功能:返回Expression的絕對值

Expression:數值型,待計算的數值;可傳入數值型的計算項目名稱或數值。

示例:abs(-1.25) 結果為 1.25

2. 取職員屬性

函數名:GetEmployeeInfo(fieldName)

功能:取職員屬性對應的值(數值,日期或文本等)

fieldName:職員屬性介面的欄位名稱

示例:GetEmployeeInfo('entryDate')

3. 取考勤日期

函數名:AttendDay()

功能:獲取當前計算行記錄的考勤日期

Expression:無

示例:var a = AttendDay() 返回值為2021-11-10

4. 取工作類型

函數名:CalendarWorkDays()

功能:取假期日曆的工作類型

無參數

示例:var a = CalendarWorkDays()
if ( a == 'PH'){ value = 4 }
if (a == 'SH'){value = 3}
if ( a == 'rest'){value = 2}
if ( a == 'normal' ){value = 1}
else value = 0

5. 向上進位

函數名:Ceil(Expression, digits)

功能:向上進位

Expression:數值型,待計算的數值;可傳入數值型的計算項目名稱或數值

digits:數值型,保留的小數位數(可缺省,缺省值為0)

示例1:value = Ceil(5.42),則計算結果為6。
示例2:value = Ceil(1.352, 2) ,則計算結果為1.36。

6. 取考勤上班打卡時間

函數名:ClockIn()

功能:取雇員當日考勤上班打卡時間

Expression:數值型,待計算的數值;可傳入數值型的計算項目名稱或數值

返回值:YYYY-MM-DD HH:MM:SS

示例:var a =ClockIn()

7. 取考勤下班打卡時間

函數名:ClockOff()

功能:取雇員當日考勤下班打卡時間

Expression:數值型,待計算的數值;可傳入數值型的計算項目名稱或數值

返回值:YYYY-MM-DD HH:MM:SS

示例:var a =ClockOff()

8. 日期時間拼接

函數名:Convert(Expression1, Expression2)

功能:日期時間拼接

Expression1:時間
Expression2:日期

返回值:YYYY-MM-DD HH:MM:SS

示例:var a= Convert( ShiftIn() ,'2022-01-02')

9. 取當前考勤計算週期的開始或結束日期

函數名:CycleBeginOrEnd(Type)

功能:取當前考勤計算週期的開始或結束日期

Expression
Type: 值為STAR/END

示例:var a =DateAdd(day,0, CycleBeginOrEnd('START') )
value = Day(a)

10. 增加時間間隔

函數名:DateAdd(DatePart, Number, Expression)

功能:在指明日期中添加時間間隔

DatePart:可以為YEAR/MONTH/DAY
Number:數值型,增加的年或月或日數;
Expression:日期型/專案

返回值:得到的新的日期

示例:var a = DateAdd(YEAR, 2, '2001-01-01') 返回值為2003-01-01
var a = DateAdd(MONTH, 2, '2001-01-01') 返回值為2001-03-01
var a = DateAdd(DAY, 2, '2001-01-01') 返回值為2001-01-03

11. 比較日期

函數名:DateDiff(Type, Expression1, Expression2)

功能:返回兩個待比較日期之間相隔的時間數

Type: YEAR/MONTH/DAY/hour/min
Expression1:字元/日期型
Expression2:字元/日期型

示例:value = DateDiff( hour, GetToday() , '2025-01-01 10:35:24')

12. 取日期時間

函數名:DateTimePart(Type, Expression)

功能:返回日期時間的時、分

Type:Type可以為HOUR或MIN
Expression:為日期時間型,時間格式:'yyyy-MM-dd HH:mm'

示例:value = DateTimePart(HOUR, '2020-02-02 09:00') 返回值9
value = DateTimePart(MIN, '2020-02-02 09:10') 返回值10

13. 取當前日期對應的日

函數名:Day(Expression)

功能:返回值為數值,返回當前日期對應的日
Expression:字元型/日期型,當前日期值(格式YYYY-MM-DD);可傳入字元類型的專案,值為具體的日期,如果參數為null或者空字串,則返回系統當前日期的日。

示例:value = Day( GetToday() )

14. 向下舍位

函數名:Floor(Expression, digits)

功能:向下舍位
Expression:數值型,待處理的數值;可傳入數值型的計算項目名稱或數值。
digits:數值型,需精確到小數點後第幾位;輸入數位。

示例:value = Floor(1.352) ,則計算結果為1。

value = Floor(1.3567, 2),則計算結果為1.35。

value = Floor(-5.42),則計算結果為-6。

15. 取考勤排班打卡多段明細資訊

函數名:GetAttendanceInfo(fieldName,index)

功能:獲取考勤排班打卡多段明細資訊
Expression:
fieldName: clockin、clockout、shiftin、shiftout、mealtime、mealstarttime、mealendtime

index:多段當中的第幾段,int ,缺省值為1

示例:var a = GetAttendanceInfo('clockin', 2) // 傳回第二段上班打卡時間

var b = GetAttendanceInfo('mealtime', 1) // 傳回排班班次的用膳時長

16. 當前日期

函數名:GetToday()

功能:返回當前日期

示例:var a = GetToday()

17. 遇到運算式NULL,返回指定字串

函數名:IfNull(Expression,Value)

功能:遇到運算式NULL,返回指定字串

示例:var vPosition = GetEmployeeInfo('positionName')
var a= IfNull(vPosition, 'test')

18. 取請假單與排班的時間段交集匹配後的結果

函數名:IntersectTimeForLeaveBill()

功能:取請假單與排班的時間段交集匹配後的結果

Expression:null

示例:value = IntersectTimeForLeaveBill()

19. 取加班申請單與實際打卡資料匹配後的結果

函數名:IntersectTimeForOtBill()

功能:取加班申請單與實際打卡資料匹配後的結果

Expression:null

示例:value = IntersectTimeForOtBill(),返回結果60min

20. 比較取較大的數值

函數名:Max(item1, item2)

功能:返回兩個待比較數中較大的那個數值

item1:數值型,待比較大小的數值1;可傳入數值型的計算項目名稱或數值
item2:數值型,待比較大小的數值2;可傳入數值型的計算項目名稱或數值

示例:value = Max(5.4,5.7),則計算結果為5.7

21. 比較取較小的數值

函數名:Min(item1, item2)

功能:返回兩個待比較數中較小的那個數值

item1:數值型,待比較大小的數值1;可傳入數值型的計算項目名稱或數值
item2:數值型,待比較大小的數值2;可傳入數值型的計算項目名稱或數值

示例:value = Max(5.4,5.7),則計算結果為5.4

22. 返回日期月

函數名:Month(Expression)

功能:返回日期月

Expression:字元型/日期型,可傳入數數值型別的專案

示例:value = Month( '2001-07-18') 返回結果為7

23. 數位轉字串

函數名:NumToStr(Expression)

功能:數位轉字串

Expression:數值型,需要處理的數值;可傳入數數值型別的項目。

示例:var a = NumToStr(2001.0) 返回值為'2001'

var a = NumToStr(3.5) 返回值為 '3.5'

24. 取前一天考勤運算最晚打卡時間

函數名:PreviousDayLastCard(Type)

功能:取前一天考勤運算最晚打卡時間

Expression:Type:'TIME’/'DATETIME'

示例:1、var a = PreviousDayLastCard() 或
var a = PreviousDayLastCard('TIME') 返回結果為'18:01'
2、var a = PreviousDayLastCard('DATETIME') 返回結果'2020-11-10 18:10'

25. 四捨五入

函數名:Round(Expression, digits)

功能:四捨五入

Expression:數值型,待處理的數值;可傳入數值型的計算項目名稱或數值。
digits:數值型,需精確到小數點後第幾位;輸入數位。

示例:value = Round(5.42, 1),則計算結果為5.4
value = Round(-5.56),則計算結果為-6

26. 取排班類型

函數名:ScheduleDayType()

功能:取排班表的日期類型

示例:value = ScheduleDayType()

工作日或不排班:0
休息日:1
法定:2

27. 取當日排班上班時間

函數名:ShiftIn()

功能:取雇員考勤明細表,當日排班上班時間,沒有排班返回NULL

示例:var a = ShiftIn()

返回值:YYYY-MM-DD HH:MM:SS

28. 取當前班次名稱

函數名:ShiftName()

功能:獲取當前計算行班次名稱

示例:var a = ShiftName()

29. 取當日排班下班時間

函數名:ShiftOff()

功能:取雇員考勤明細表,當日排班下班時間

示例:var a = ShiftOff()

返回值:YYYY-MM-DD HH:MM:SS。

30. 字串轉數位

函數名:StrToNum(Expression)

功能:字串轉數位

Expression:字元型專案或需要處理的字串;

示例:value = StrToNum('2001') 返回值為2001.0;

var a = 6018.8,value =StrToNum(a) ,返回值為6018.8;

31. 字串截取

函數名:Substring(Expression, start, end)

功能:字串截取

Expression:字串或日期
start:數值型,子字串開始的字元序號(從1開始計數);
end:數值型,子字串包含的字元數;

示例:var vPosition = Substring('高級經理',3,4),則返回結果“經理”

32. 取工時單的小時數

函數名:TimesheetHours('Type')

功能:取工時單的小時數

Expression:
Type: 值為'OT1'或'OT2'或'OT3'或'NORMAL'

示例: value = TimesheetHours('OT1') +TimesheetHours('Normal') +TimesheetHours('OT2') +TimesheetHours('OT3')

33. 取工時單的類型

函數名:TimesheetInfo(Type)

功能:返回工時單的類型

Expression:
Type:值為’Location‘、’Project‘

示例: var a = TimesheetInfo('Location')
if ( a =='HK' ) {
value = 200
}
else {
value = 0
}

34. 取工時單的開始時間/結束時間

函數名:TimesheetTime(Type, Index)

功能:工時單的開始時間/結束時間

Expression:
Type:START/END ;Index:指明第幾張工時單

示例: var a = TimesheetTime( 'StartTime', 1)
var b= TimesheetTime( 'EndTime', 1)
value = DateDiff(min ,a ,b)

35. 取不同類型工時單的數量

函數名:Timesheetcount(Type)

功能:統計不同類型工時單的數量

Expression:
Type: 字元型,值為'OT1'或'OT2'或'OT3'或'NORMAL'

示例: value = Timesheetcount('OT1') 返回值為2

36. 取當前正在計算中的考勤日期對應的星期

函數名:Weekday(Expression)

功能:取當前正在計算中的考勤日期對應的星期

Expression:字元/日期型/專案

示例: value = Weekday( AttendDay())

37. 取日期的年

函數名:Year(Expression)

功能:返回日期的年

Expression:字元型/日期型

示例: value = Year( '2001-07-18') 返回結果為2001

是否回答了您的問題?