com.seeyon.v3x.worktimeset.manager

接口 WorkTimeManager

public interface WorkTimeManager

Title: 工作时间对上层应用的接口

Description: 工作时间对上层应用的接口

Copyright: Copyright (c) 2012

Company: seeyon.com

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	COMPUTE_UNIT_DAY
static java.lang.String	COMPUTE_UNIT_HOUR

方法概要

限定符和类型	方法和说明
java.lang.Long	convert2WorkTime(java.lang.Long naturetime, java.lang.Long orgAccountId) 将自然时间转化为工作时间。
java.lang.Long	convert2WorkTime(java.lang.Long naturetime, java.lang.Long orgAccountId, java.lang.Integer worktimeOfDay) 将自然时间转化为工作时间。
float	differDate(java.lang.String beginDealDateStr, java.lang.String endDealDateStr, java.lang.Long orgAcconutID) 日期差。
float	differDateTime(java.util.Date beginDealTimeDate, java.util.Date endDealTimeDate, java.lang.Long orgAcconutID) 日期时间差。
java.util.Date	getCompleteDate4Nature(java.util.Date beginTimeDate, long deadline, java.lang.Long orgAcconutID) 根据超期时间(自然时间)取得超期时间点
java.util.Date	getCompleteDate4Worktime(java.util.Date beginTimeDate, long deadline, java.lang.Long orgAcconutID) 根据超期时间(工作时间)取得超期时间点
java.util.Date	getComputeDate(java.util.Date beginTimeDate, java.lang.String operation, java.lang.Double time, java.lang.String unit, java.lang.Long orgAcconutID) 取得计算后的时间
java.util.Date	getComputeDate(java.util.Date beginTimeDate, java.lang.String operation, long time, java.lang.String unit, java.lang.Long orgAcconutID) 日期时间与“天”或“小时”的加减运算，结果为工作日
java.util.Date	getComputeDate(java.lang.String beginTimeDateStr, java.lang.String operation, long time, java.lang.Long orgAcconutID) 日期与天的加减运算，结果为工作日
long	getDealWithTimeValue(java.util.Date beginDealTimeDate, java.util.Date endDealTimeDate, java.lang.Long orgAcconutID) 日期时间差。
int	getEachDayWorkTime(int year, java.lang.Long orgAcconutID) 取得指定单位的指定年的每天的工作时间。
java.util.Date	getRemindDate(java.util.Date completeDate, long remindTime) 根据给定限定时间计算提前提醒时间。
int	getWorkDaysByWeek() 获取当前日期的每周工作日是几天
int	getWorkDaysByWeek(java.lang.Long orgAccountId) 按单位 获取当前日期的每周工作日是几天

字段详细资料

COMPUTE_UNIT_DAY

static final java.lang.String COMPUTE_UNIT_DAY

另请参阅:

常量字段值

COMPUTE_UNIT_HOUR

static final java.lang.String COMPUTE_UNIT_HOUR

另请参阅:

常量字段值

方法详细资料

getCompleteDate4Worktime

java.util.Date getCompleteDate4Worktime(java.util.Date beginTimeDate,
                                        long deadline,
                                        java.lang.Long orgAcconutID)
                                 throws WorkTimeSetExecption

根据超期时间(工作时间)取得超期时间点

参数:

beginTimeDate - 起始时间点

deadline - 超期分钟数,deadline是按照工作时间计算好的

orgAcconutID - 单位ID

返回:

抛出:

WorkTimeSetExecption

getCompleteDate4Nature

java.util.Date getCompleteDate4Nature(java.util.Date beginTimeDate,
                                      long deadline,
                                      java.lang.Long orgAcconutID)
                               throws WorkTimeSetExecption

根据超期时间(自然时间)取得超期时间点

参数:

beginTimeDate - 起始时间点

deadline - 超期分钟数，deadline是按照自然时间计算好的

orgAcconutID - 单位ID

返回:

抛出:

WorkTimeSetExecption

getRemindDate

java.util.Date getRemindDate(java.util.Date completeDate,
                             long remindTime)

根据给定限定时间计算提前提醒时间。不按工作时间，简单地按自然时间计算。

参数:

completeDate - 限定时间

remindTime - 提前提醒的分钟数

返回:

提前提醒的时间

getDealWithTimeValue

long getDealWithTimeValue(java.util.Date beginDealTimeDate,
                          java.util.Date endDealTimeDate,
                          java.lang.Long orgAcconutID)
                   throws WorkTimeSetExecption

日期时间差。取得给定工作时间区间使用了的工作时间 单位 ms

参数:

beginDealTimeDate - 开始工作时间

endDealTimeDate - 结束工作时间

orgAcconutID - 单位ID

返回:

在开始工作时间和结束工作时间之间，消耗了多少工作时间，单位ms

抛出:

WorkTimeSetExecption

differDateTime

float differDateTime(java.util.Date beginDealTimeDate,
                     java.util.Date endDealTimeDate,
                     java.lang.Long orgAcconutID)
              throws WorkTimeSetExecption

日期时间差。取得给定工作时间区间使用了的工作时间， 单位 天

参数:

beginDealTimeDate - 开始工作时间

endDealTimeDate - 结束工作时间

orgAcconutID - 单位ID

返回:

在开始工作时间和结束工作时间之间，消耗了多少工作时间，单位 天

抛出:

WorkTimeSetExecption

differDate

float differDate(java.lang.String beginDealDateStr,
                 java.lang.String endDealDateStr,
                 java.lang.Long orgAcconutID)
          throws WorkTimeSetExecption

日期差。根据传入的日期字符串，计算时间间隔。

参数:

beginDealDateStr - 开始日期字符串 2010-12-08

endDealDateStr - 结束日期字符串 2010-12-08

orgAcconutID - 单位ID

返回:

时间间隔天数

抛出:

WorkTimeSetExecption

getEachDayWorkTime

int getEachDayWorkTime(int year,
                       java.lang.Long orgAcconutID)
                throws WorkTimeSetExecption

取得指定单位的指定年的每天的工作时间。

参数:

year - 年,如2011

orgAcconutID - 单位ID

返回:

每天的工作时间，单位是分钟 比如 8*60分钟，返回单位ms。

抛出:

WorkTimeSetExecption

getComputeDate

java.util.Date getComputeDate(java.util.Date beginTimeDate,
                              java.lang.String operation,
                              long time,
                              java.lang.String unit,
                              java.lang.Long orgAcconutID)
                       throws WorkTimeSetExecption

日期时间与“天”或“小时”的加减运算，结果为工作日

参数:

beginTimeDate -

operation - "+"/"-"

time - 非负整数

unit - day/hour

orgAcconutID -

返回:

抛出:

WorkTimeSetExecption

getComputeDate

java.util.Date getComputeDate(java.lang.String beginTimeDateStr,
                              java.lang.String operation,
                              long time,
                              java.lang.Long orgAcconutID)
                       throws WorkTimeSetExecption

日期与天的加减运算，结果为工作日

参数:

beginTimeDateStr -

operation - "+"/"-"

time - 单位“天”，非负整数

orgAcconutID -

返回:

抛出:

WorkTimeSetExecption

convert2WorkTime

java.lang.Long convert2WorkTime(java.lang.Long naturetime,
                                java.lang.Long orgAccountId)

将自然时间转化为工作时间。比如每天的工作时间为8*60，传入参数为24*60，返回8*60
小于24*80的直接返回，大于24*60的取每天的工作时间相加返回。

参数:

naturetime -

orgAccountId -

返回:

convert2WorkTime

java.lang.Long convert2WorkTime(java.lang.Long naturetime,
                                java.lang.Long orgAccountId,
                                java.lang.Integer worktimeOfDay)

将自然时间转化为工作时间。比如每天的工作时间为8*60，传入参数为24*60，返回8*60
小于24*80的直接返回，大于24*60的取每天的工作时间相加返回。

参数:

naturetime -

orgAccountId -

worktimeOfDay - :每天的工作时间。

返回:

getWorkDaysByWeek

int getWorkDaysByWeek()
               throws WorkTimeSetExecption

获取当前日期的每周工作日是几天

返回:

抛出:

WorkTimeSetExecption

getWorkDaysByWeek

int getWorkDaysByWeek(java.lang.Long orgAccountId)
               throws WorkTimeSetExecption

按单位 获取当前日期的每周工作日是几天

返回:

抛出:

WorkTimeSetExecption

getComputeDate

java.util.Date getComputeDate(java.util.Date beginTimeDate,
                              java.lang.String operation,
                              java.lang.Double time,
                              java.lang.String unit,
                              java.lang.Long orgAcconutID)
                       throws WorkTimeSetExecption

取得计算后的时间

参数:

beginTimeDate - :开始时间

time - :计算时间 :例如(1.5) 小数，保留1位

unit - :计量单位 :(小时/天)

operation - :操作符号(+/-)

orgAcconutID -

返回:

抛出:

WorkTimeSetExecption