Title: How to use Date Business Functions in the J.D.

Edwards software
Abstract: This document provides information on various date business functions that are available in the J.D. Edwards software.
Product Suite Release Document ID Date Created Date Reviewed Date Revised J.D. Edwards 5 and OneWorld Software Technical ERP 8.0, Xe ott-01-0053 05/04/2001 01/30/2003 01/30/2003

Table of Contents
1. Summary Table of the Date Business Functions 2. What is JDE Julian Date? 3. JDE Date Routines: Date Mask Available 4. B0000127: ReturnTodaysDate 5. B0700068: RetrieveDayofWeek 6. B4201480: GetDayofWeek 7. B0800013: ConvertStringToDate 8. B0800208: ConvertStringDatetoDateFormat 9. B3000250: GetMonthDescription 10. B3000260: GetYearDescription 11 B41B0470: FormatDateFromDMY 12. B7600920: ConvertNumbersAndDatesToString 13. B9100001: ConvertjulianDatetojdeDate 14. B9800210: Convert From and To Julian Date from JDEDATE 15. B4500490: DateConversiontoJulian 16. B0000200: SixDigitNumerictoDate 17. B0000200: DatetoSixDigitNumeric

18. B9800460: ConvertDateToString 19. N1700090: CalculateBeginDateofPeriod

Summary Table of the Date Business Functions

Source Module B0000127 B0700068, B4201480 B0800013 B0800208 B3000250 Function Name ReturnTodaysDate RetrieveDayofWeek, GetDayofWeek ConvertStringToDate ConvertStringDatetoDateFormat GetMonthDescription Input None JDE Date Output JDE Date Day description, i.e. Monday, Tuesday, . JDE Date JDE Date

Month description, i.e. January, February, .... B3000260 GetYearDescription Numeric Calendar 4-digit year Year description B41B0470 FormatDateFromDMY String YY, MM, DD JDE Date B7600920 ConvertNumbersAndDatesToString JDE Date String B9100001 ConvertjulianDatetojdeDate Numeric CYYDDD JDE Date B9800210 ConvertDateToJulian JDE Date Numeric YYYYDDD B9800210 ConvertJulianToDate Numeric JDE Date YYYYDDD B4500490 DateConversiontoJulian JDE Date Numeric CYYDDD B0000200 SixDigitNumerictoDate Numeric CYYDDD JDE Date B0000200 DatetoSixDigitNumeric JDE Date Numeric CYYDDD B9800460 ConvertDateToString JDE Date + Mask String N1700090 CalculateBeginDateofPeriod Period Number, Period Begin Date, Company, Fiscal Period End Date, Year and Century Begin Date of Fiscal Year, and/or Period Ending Dates for all 14 Periods
Back to Top

String MM/DD/YYYY String Date + Date Mask Numeric Calendar Month

What is JDE Julian Date?

All dates in the J.D. Edwards database are stored in a JDE Julian format. A date in JDE Julian format is a six-digit numeric field which represents the century, year and day of the year. It should be updated using the following rules:

The first digit describes the century. A value of 0 indicates the 20th century (1900s). A value of 1 indicates the 21st century (2000s); The second and third digits represent the year (98, 99, 00, 01, etc); The fourth, fifth and sixth digits represent the day in the year (001 for January 1, 112 for April 21, etc.)

Example: The date for January 31, 2000 = 100031 in a Julian date format (CYYDDD). 1 = 21st Century 00 = Year in the 21st Century 031 = Day in the year Note: If the Business Function requires JDEDATE as an input/output parameter, users can only pass parameters with the attribute of data dictionary item type 11 (Date) and class DATEW. The Business function will not return correct information if the user passes a numeric field of CYYDDD to the JDEDate parameter.
Back to Top Back to Summary Table

JDE Date Routines: Date Masks Available

MASK D A Y M O N T B R E S C
Back to Top

DESCRIPTION Day Number, 1 or 2 digits Day Number, zero pad to 2 digits Day Number, space pad 2 digits Month Number, 1 or 2 digits Month Number, zero pad to 2 digits Month Number, space pad to 2 digits Month Number, by language, from UDC Abbreviated Month Name, by language, from UDC 2 digit year 4 digit year Date slash character, from configuration Date comma character, from configuration
Back to Summary Table

B0000127: ReturnTodaysDate
Purpose: This function will return today's date in a Julian date (JDE format). Parameters: Data Structure: D0000127 Parameter Name jddateDateForToday
Back to Top

Data Item DGJ

Data Type JDEDATE

Back to Summary Table

I/O O

B0700068: RetrieveDayofWeek
Purpose: This function will take a date, and return the numeric day of the week (0-6) and its' corresponding description (Sunday-Saturday). Numeric Value 0 1 2 3 4 5 6 Parameters: Data Structure: D0700068C Parameter Name jdDate mnDayofWeek dsDayofWeekDesc
Back to Top

Descriptions Sunday Monday Tuesday Wednesday Thursday Friday Saturday

Data Item BDOWLD DOW DS20

Data Type JDEDATE MATH_NUMERIC Char

Back to Summary Table

I/O I O O

B4201480: GetDayofWeek
Purpose: This function will take a date, and return the numeric day of the week (0=Sunday, 6=Saturday) and error code (0=success). Parameters: Data Structure: D4201480A Parameter Name jdDate mnDayofWeekA cErrorCode
Back to Top

Data Item DTE DOW ERRC

Data Type JDEDATE MATH_NUMERIC Char

Back to Summary Table

I/O I O O

B0800013: ConvertStringToDate
Purpose: This function will convert a string that is in a date format (MM/DD/YYYY) to a Julian date (JDE format). One digit day and/or one digit month input won't work on this business function. Parameters: Data Structure: D0800013 Parameter Name jdDateConvertdDate szStringToConvert
Back to Top

Data Item DRQJ VC10A

Data Type JDEDATE String

Back to Summary Table

I/O O I

B0800208: ConvertStringDateToDateFormat
Purpose:

This function will convert a string that is in a date format to a Julian date (JDE format). The Date Mask passed as a literal to the function describes the format of the string date. For example, if the string date is in a format of 05/29/2002 the format mask to be passed to the function would be OSASE. If the date was in a format of 052902 the format mask would be OAR. See the information on the Date Masks Available for the available date masks. Parameters: Data Structure: D0800208 Parameter Name jdConvertedDate szStringToConvert szFormatMask
Back to Top

Data Item DRQJ VC10A VC09A

Data Type JDEDATE String String

Back to Summary Table

I/O O I I

B3000250: GetMonthDescription
Purpose: This function will validate a two digit number entered within a range (1-12) and convert the 2-digit number to a string description of the month. (1=January, 2=February, 3=March, etc.). The function will return "Invalid Entry" if the input number is not in the range. Parameters: Data Structure: D3000250 Parameter Name mnCalendarMonth szDescription Data Item MT DESC Data Type Numeric String I/O I O

Note: To get the month description from a JDEDate: - Call B9800460 to convert JDEDate to String (i.e. 12/20/05) - Use the substr Expression Manager function to get the month in String format (i.e. 12) - Call B4000770 to convert string to numeric to get a numeric calendar month (i.e. 12)

Back to Top

Back to Summary Table

B3000260: GetYearDescription
Purpose: This function will validate a number entered within a range (00-99) and convert a 2-digit number to a 4-digit description of the year. The function will combine the century and year and give the description (i.e. 19 + 98 = 1998). If the year is less than or equal to the default value of DCYR data item, then century will be '20' If the year is greater than the default value or DCYR data item, then century will be '19' Parameters: Data Structure: D3000260 Parameter Name mnCalendarYear szYearDescription Data Item YR DESC Data Type Numeric String I/O I O

Note: To get the year description from JDEDate: - Call B9800460 to convert JDEDate to String (i.e. 12/20/05) - Use substr Expression Manager function to get the year in String format (i.e. 05) - Call B4000770 to convert string to numeric to get a numeric calendar year (i.e. 05)

Back to Top

Back to Summary Table

B41B0470: FormatDateFromDMY
Purpose:

This business function will convert 3 numeric values (YY, MM, DD) to a Julian date (JDE format). One digit number on the input month and day is acceptable. Parameters: Data Structure: D41B0470 Parameter Name mnYear mnMonth mnDay jdDate Special Instructions: This business function calls B0000154. If YY is greater than the default value of CENTCHG (DD item), the century is 19 If YY is less than the default value of CENTCHG (DD item), the century is 20 Data Item YR MNTH DOM OPDT Data Type MATH_NUMERIC MATH_NUMERIC MATH_NUMERIC JDEDATE I/O I I I O

Back to Top

Back to Summary Table

B7600920: ConvertNumbersAndDatesToString
Purpose: This business function will convert a Julian date (JDE format) into a string DDMMYY format (0 pad for one digit day and month). Parameters: Data Structure: D7600920 Parameter Name NumberToBeConverted DateToBeConverted TargetString LengthOfTargetString
Back to Top

Data Item MATH01 DATE01 REM1 INT01

Data Type MATH_NUMERIC JDEDATE STRING INTEGER

Back to Summary Table

I/O I I O I

B9100001: ConvertjulianDatetojdeDate
Purpose: This business function will convert a Julian numeric date (JDE Julian Format of CYYDDD) to a Julian date (JDE format). The first digit of a Julian numeric date input represents century -- 0 for 19's, 1 for 20's, 2 for 21's, .... Parameters: Data Structure: D9800210 Parameter Name Data Item jdDateToConvert TRDJ mnJulinaDateInYYYYDDD CDL
Back to Top

Data Type JDEDATE MATH_NUMERIC

Back to Summary Table

I/O O I

B9800210: Convert From and To Julian Date from JDEDATE

Purpose: ConvertDateToJulian: This function will convert a Julian date (JDE format) to a Julian numeric date (YYYYDDD) Note: This Julian numeric date output is not in the JDE Julian Date format of CYYDDD, but rather in a YYYYDDD format. ConvertJulianToDate: This function will convert Julian numeric date (YYYYDDD) to a Julian date (JDE format) Note: The input Julian numeric date should not be in the JDE Julian Date format of CYYDDD, but rather in a YYYYDDD format. Parameters: Data Structure: D9800210 ConvertDateToJulian: Parameter Name Data Item jdDateToConvert TRDJ mnJulinaDateInYYYYDDD CDL* ConvertJulianToDate: Data Type JDEDATE MATH_NUMERIC I/O I O

Parameter Name Data Item jdDateToConvert TRDJ mnJulinaDateInYYYYDDD CDL*

Data Type JDEDATE MATH_NUMERIC

I/O O I

*CDL is a 2 digit numeric data item. You might need to use other math numeric data items to pass in/out to the business function. To get the numeric field to print out on the report, display decimal and edit code need to be changed on the field.
Back to Top Back to Summary Table

B4500490: DateConversiontoJulian
Purpose: This business function will convert a Julian date that is in JDE Date Format to a math numeric Julian date (JDE Julian Format of CYYDDD). The first digit of a Julian numeric date input represents century -- 0 for 19's, 1 for 20's, 2 for 21's, .... Parameters: Data Structure: D4500490 Parameter Name Data Item jdDateToConvert TRDJ mnJulianDateInYYYDDD CDL
Back to Top

Data Type JDEDATE MATH_NUMERIC

Back to Summary Table

I/O I O

B0000200: SixDigitNumerictoDate
Purpose: This business function will convert a math numeric that is in JDE Julian format of CYYDDD to a Julian date in JDE Date Format. The first digit of a Julian numeric date input represents century -- 0 for 19's, 1 for 20's, 2 for 21's, .... Parameters: Data Structure: D0000200B Parameter Name mnInputNumeric Data Item CHGH Data Type MATH_NUMERIC I/O I

jdOutputDate cReturnCode Special Note:

DATE01 EV01

JDEDATE CHARACTER

O O

This Business Function is first available with Update 4 of J.D. Edwards software release Xe.
Back to Top Back to Summary Table

B0000200: DatetoSixDigitNumeric
Purpose: This business function will convert a Julian date that is in JDE Date Format to a math numeric Julian date (JDE Julian Format of CYYDDD). The first digit of a Julian numeric date input represents century -- 0 for 19's, 1 for 20's, 2 for 21's, .... Parameters: Data Structure: D0000200A Parameter Name jdInputDate mnOutputNumeric cReturnCode Special Note: This Business Function is first available with Update 4 of J.D. Edwards software release Xe.
Back to Top Back to Summary Table

Data Item DATE01 CHGJ EV01

Data Type JDEDATE MATH_NUMERIC CHARACTER

I/O I O O

B9800460: ConvertDateToString
Purpose: ConvertDateToString: This business function will convert a Julian date (JDE format) into a string according to the selected MASK. Date Mask is defined in UDC 00/DF Parameters:

Data Structure: D9800460A Parameter Name jdDateToConvert szDateConvertedToString szDateFormat Data Item DRQJ VC08A FRMT* Data Type JDEDATE STRING STRING I/O I O I

*User can define the field by selecting Literal and doing a visual assist and you will get the choice below. Date Mask available (UDC 00/DF) Codes Description Use System Value Day, Month, 4-digit Year* Day, Month, Year (DDMMYY) 4-digit Year, Month, Day* Month, Day, 4-digit Year* Month, Day, Year (MMDDYY) Year, Month, Day (YYMMDD) Appearance Regional setting in control panel DD/MM/YY DD/MM/YY YY/MM/DD MM/DD/YY MM/DD/YY YY/MM/DD

DME DMY EMD MDE MDY YMD *Special Note:

The business function ConvertStringToDate B9800460 was built for a very limited use and has a very restrictive format. It forces slashes between the day month and year, it requires a leading 0 for months and days that are a single digit, and it allows a date that is only 8 characters long. This prevents printing 4 digit years. A 4-digit year will be truncated into a 2-digit year.
Back to Top Back to Summary Table

N1700090: CalculateBeginDateofPeriod
Purpose: This business function will return a period begin date, period end date, beginning date of the fiscal year, and/or the ending dates for all 14 periods of the fiscal year. Parameters: Data Structure: D1700090 Parameter Name Data Item Data Type I/O

mnPeriodNo cRetrieveF0008Records szCompany mnCentury mnFiscalYear1 jdPeriodBeginDate jdBeginDateofFiscalYear jdPeriod1EndDate jdPeriod2EndDate jdPeriod3EndDate jdPeriod4EndDate jdPeriod5EndDate jdPeriod6EndDate jdPeriod7EndDate jdPeriod8EndDate jdPeriod9EndDate jdPeriod10EndDate jdPeriod11EndDate jdPeriod12EndDate jdPeriod13EndDate jdPeriod14EndDate cSuppressErrorMessage szErrorMessageID jdPeriodEndDate Special Note:

PN EV01 CO CTRY FY DTEJ DTEJ DTEJ DTEJ DTEJ DTEJ DTEJ DTEJ DTEJ DTEJ DTEJ DTEJ DTEJ DTEJ DTEJ DTEJ SUPPS DTAI DTEJ

MATH_NUMERIC CHARACTER STRING MATH_NUMERIC MATH_NUMERIC JDEDATE JDEDATE JDEDATE JDEDATE JDEDATE JDEDATE JDEDATE JDEDATE JDEDATE JDEDATE JDEDATE JDEDATE JDEDATE JDEDATE JDEDATE JDEDATE CHARACTER STRING JDEDATE

I I I I I

I O O

This Business Function is first available with Update 4 of J.D. Edwards software release Xe.
Back to Top Back to Summary Table

Related Knowledge Documents

Document Document Title ID OTT-99Expression Manager Functions 0016