21.1. 日期函数
21.1.1. 日期、时间验证
DATE_CHECK_PLAUSIBILITY:检查一个日期是否是有效格式,如果不是有效日期,则报异常:
CALL FUNCTION 'DATE_CHECK_PLAUSIBILITY'
EXPORTING
date = '20110229'
EXCEPTIONS
plausibility_check_failed = 1
OTHERS = 2.
IF sy-subrc <> 0.
ENDIF.
TIME_CHECK_PLAUSIBILITY:时间有效性检查,与上面日期有效性检查使用方式相同
21.1.2. 内部转换外部格式
FORMAT_DATE_4_OUTPUT:将数据库中8位的日期(YYYYMMDD)转换为指定的任意格式
注意:在程序中,日期格式要使用大写格式。
CONVERT_DATE_TO_EXTERNAL:将数据库中的8位内部日期(YYYYMMDD)以当前Client设置的外部日期格式显示:
21.1.3. 外部转内部格式
CONVERT_DATE_TO_INTERNAL:将外部日期(要符合Client设置的日期格式)转换为数据库内部日期(YYYYMMDD)
INPUT: 02/03/2008 "Should be same as the user's default setting
OUPUT: 20080203
CONVERT_DATE_INPUT:将外部日期(要符合Client设置的日期格式)转换为数据库内部日期
DATA: d TYPE d.
CALL FUNCTION 'CONVERT_DATE_INPUT'
EXPORTING
input = '2011.10.18'
plausibility_check = 'X'"进行日期有效性验证
IMPORTING
output = d
EXCEPTIONS
plausibility_check_failed = 1
wrong_format_in_input = 2
OTHERS = 3.
21.1.4. 获取Client格式
获取当前Client端的日期格式与时间格式:
SELECT datfm INTO lv_datfm FROM usr01 UP TO 1 ROWS WHERE bname = zname . ENDSELECT.
21.1.5. 日期加减
RP_CALC_DATE_IN_INTERVAL:加减自然年、自然月,还可以加减天数(一般加多少天直接通过日期类型就加减就可以了,但如果向下面那样需要在20070101加上1年1个月零28天时,就很有用了):
21.1.6. 转成工厂日期
DATE_CONVERT_TO_FACTORYDATE:如果输入的是周末与公共节假日,则将它把调整为工厂日历日期(工作日期):
DATA: date LIKE scal-date,
factorydate LIKE scal-facdate,
workday LIKE scal-indicator.
CALL FUNCTION 'DATE_CONVERT_TO_FACTORYDATE'
EXPORTING
"如果输入的日期不是工作日,则是该函数会返回离该输入的节假日前或者后面的最近的工作日,是返回前面还是后面由 +/- 来决定 +:返回后面最近的工作日 -:返回前面最近的工作日默认就是+
* CORRECT_OPTION = '+'
date = '20111119'
"使用的工厂日历ID,可以从 T001W-FABKL 中获取
factory_calendar_id = 'CN'
IMPORTING
"如果输入的是节假日,则返回是经过转换过了的工作日;如果输入的就是工作时,则返回的是自身,格式为 YYYYMMDD
date = date
"返回的工作日在指定的工作日历中位于第几个工作日,一般对我们没什么作用
factorydate = factorydate
"标示返回的DATE是否是工作日,如果为空,则是,如果为 + ,表示返回的是输入的节假日后面最近一个工作;如果为 - ,表示返回的是输入的节假日前面最近一个工作日。
workingday_indicator = workday.
WRITE:/ date , factorydate, workday.
其中工厂日历的代码按工厂号到表T001W上取:
SELECT SINGLE fabkl INTO l_fabkl FROM t001w WHERE werks = im_mt61d-werks.
FACTORYDATE_CONVERT_TO_DATE:该函数可以将DATE_CONVERT_TO_FACTORYDATE返回的factorydate(工作日序号:工作日在指定的工作日历中位于第几个工作日)转换成工作日,也可以用在“加几个工作日”的应用中:比如给某个时间加上几个工作日时,可以先使用DATE_CONVERT_TO_FACTORYDATE函数将某个时间转换为工厂日期,并获取factorydate工作日序号,再在这个工作日序号上加上几个工作日,得到新的工作日序号,然后再将这个新的工作日序号传递给FACTORYDATE_CONVERT_TO_DATE函数,得到最终的新的工作日期:
工厂日历定义表为TFACD(节假日历定义表THOCD),表里存储了工厂日历ID(TFACD-IDENT)与节假日历ID(TFACD-HOCID)的关系,所以只要知道了工厂日历ID,则要使用节假日历ID则可以查询出来(注:工厂日历ID还可以通过T001W来查询得到):
工厂日历相关表是以“TFA”开头的表,节假日历相关的表是以“THO”开头相关的表
21.1.7. 日期属性
DAY_ATTRIBUTES_GET:查看某日期的属性(休息日、节假日、星期几):
CALL FUNCTION 'DAY_ATTRIBUTES_GET'
EXPORTING
FACTORY_CALENDAR = 'CN'引用表字段TFACD-IDENT
* HOLIDAY_CALENDAR = ' '引用表字段THOCI-IDENT
DATE_FROM = '20110428'
DATE_TO = '20110510'
* LANGUAGE = SY-LANGU
* NON_ISO = ' '
* IMPORTING
* YEAR_OF_VALID_FROM =
* YEAR_OF_VALID_TO =
* RETURNCODE =
TABLES
day_attributes = attr .
21.1.8. 节假日
HOLIDAY_CHECK_AND_GET_INFO:判断某天是否是假日,并且可以返回该日期所对应的节假日信息。
DATA attr TYPE casdayattr OCCURS 0.
DATA: is_hol .
DATA: THOL TYPE THOL OCCURS 0.
CALL FUNCTION 'HOLIDAY_CHECK_AND_GET_INFO'
EXPORTING
date = '20100529'
holiday_calendar_id = 'Z1'
"需要返回节假日属性内表信息
with_holiday_attributes = 'X'
IMPORTING
"是否节假日(注:周末不是节假日,但是一种休息日)
holiday_found = is_hol
"Attributes of the found public holidays The table contains
"the holiday aAttributes, if the specified date is a holiday.
"The attributes must be passed in a table because several
"holidays can fall on a date.即一天有可能有两个节,所以需要使用内表接收
TABLES
holiday_attributes = THOL.
21.1.9. 年月选择框
POPUP_TO_SELECT_MONTH:弹出一个对话框显示月份和年度下拉列表,让用户选择年与月
输入:
ACTUAL_MONTH: 当前月份(弹出框中的默认值),必须填写。形式为 YYYYMM。
FACTORY_CALENDAR:工厂日历,可以省略,默认值为空。更多信息请参考表 TFACD。
HOLIDAY_CALENDAR: 公共假日日历,可以省略,默认值为空。更多信息请参考表 THOCI。
LANGUAGE: 语言,可以省略。用来指定月份名称用哪种语言显示,不指定就是当前登录语言。
START_COLUMN: 弹出对话框出现的位置,列,可以省略,默认值为 8。
START_ROW: 弹出对话框出现的位置,行,可以省略,默认值为 5。
输出:
SELECTED_MONTH: 选择的月份,如果按了取消按钮,则值为 000000。
RETURN_CODE: 返回码,如果按了取消按钮,则值为 4,否则为 0。
说明:工厂日历和公共假日日历主要用来限制下拉列表中的可选年份范围。如果不指定,就是当前年前后各 50 年,共 100 年
21.1.10. 财政年
GET_CURRENT_YEAR:得到当前的财政年(fiscal year)
21.1.11. 星期翻译对照表
WEEKDAY_GET:从数据表中获得指定语言每周七天的名称,例如中文就是星期一、星期二……星期日,英文就是Sunday、Monday……Saturday
输入参数:
LANGUAGE:指定语言代码,可以省略,如果不填就是当前登录语言。注意,在调用时如果指定某种特定语言,必须用一个字节的语言代码,例如中文是 1、英文是 E……,而不能用 ZH、EN,语言代码参见表 T002
输出内表:WEEKDAY:结构与透明表 T246 相同,用来存储返回给用户的周日名称。
21.1.12. 日期所在周末、天/周、周/年
HR_GBSSP_GET_WEEK_DATES:获得某个日期所在周的周六周日、所在周的第几天、所在年的第几周:
输入参数:
P_PDATE:一个日期,必须填写。
输出参数:
P_SUNDAY:该周的周日,在 SSP 日期系统中,周日为第一天。
P_SATURDAY:该周的周六,在 SSP 日期系统中,周六为最后一天。
P_DAY_IN_WEEK:输入日期在当周的第几天,周日第 1 天,周一第 2 天,依此类推,周六第 7 天。
P_WEEK_NO:该周是年度的第几周。6 位数字,格式为 YYYYWW,前四位是年,后两位是周。
说明:SSP 是 Statutory Sick Pay的缩写
该函数包括了以下两个函数的功能:
DATE_GET_WEEK:获得某个日期所在的周
WEEK_GET_FIRST_DAY:计算某周的第一天(如下面的1999年的第52周第一天):