[SAP ABAP开发技术总结]日期函数

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周第一天）：