ConvertUTCTimeToLocal

UTC Time Functions

Minor Business Rule

Object Name: B9800009

Parent DLL: CTOOL

Location: Client/Server

Language: C

Functional Description
Adjusts the passed in UTC Time to or from local time based on the passed in parameters. The adjusted
local time is still in the same format as the UTC Time (minutes since 1/1/1970).

Purpose
Needed for Scheduler (P91300) recurrence functions.

Setup Notes and Prerequisites
Time Zone and daylight savings rule (if needed) must be passed in.)

Special Logic

Technical Specification

Parameter Name	Data Item	Data Type	Req/Opt	I/O/Both
mnTime	SCHSTTIME	MATH_NUMERIC	REQ	BOTH
The start time of the job based on Universal Time Coordinate (UTC) Time. UTC Time is the number of seconds elapsed since Midnight on January 1, 1970 in Greenwich, England. UTC Time used to be called Greenwich Mean (GM) Time.
szTimeZones	TIMEZONES	char	REQ	INPUT
Choose the time zone for which you want to view the date and time.
cDaylightSavings	DAYLIGHTSV	char	REQ	INPUT
Indicates whether to adjust the local time for daylight savings time. The U.S. daylight savings standard is used.
cMode	EV01	char	REQ	INPUT
1 - Convert from UTC to local. 2 - Convert from local to UTC. ^
szDaylightSavingsRuleName	DSAVNAME	char	REQ	INPUT
Unique name identifying a daylight savings rule. Use daylight savings rules to adjust time for a geographic and political locale.

Data Structure

D9800009C - Convert UTC Time To Local Time

Parameter Name Data Item Data Type Req/Opt I/O/Both

mnTime SCHSTTIME MATH_NUMERIC REQ BOTH

The start time of the job based on Universal Time Coordinate (UTC) Time. UTC Time is the number of seconds elapsed since Midnight on
January 1, 1970 in Greenwich, England. UTC Time used to be called Greenwich Mean (GM) Time.

szTimeZones TIMEZONES char REQ INPUT

Choose the time zone for which you want to view the date and time.

cDaylightSavings DAYLIGHTSV char REQ INPUT

Indicates whether to adjust the local time for daylight savings time. The U.S. daylight savings standard is used.

cMode EV01 char REQ INPUT

1 - Convert from UTC to local.
2 - Convert from local to UTC.
^

szDaylightSavingsRuleName DSAVNAME char REQ INPUT

Unique name identifying a daylight savings rule. Use daylight savings rules to adjust time for a geographic and political locale.

Related Functions

B91300A Scheduler Date/Time Functions

X0005 Get User Defined Codes

Related Tables

F00085 Daylight Savings Rules

GetCurrentTimeInUTC
GetCurrentTimeInUTC

UTC Time Functions

Minor Business Rule

Object Name: B9800009

Parent DLL: CTOOL

Location: Client/Server

Language: C

Functional Description
Returns the number of minutes from Midnight, 1/1/1970 UTC Time.  UTC Time is also known as Greenwich
Mean Time.

Purpose
For use with the time zone and daylight saving adjustment functions.

Setup Notes and Prerequisites

Special Logic

Technical Specification
This function calls the ANSI C function time().  This returns the number of seconds from Midnight,
1/1/1970 UTC Time.  For J.D.Edwards purposes, we divide this number by 60 to get the number of minutes.
This eliminates any worry about the size of a long integer.

Data Structure

D9800009D - Get Current UTC Time

Parameter Name Data Item Data Type Req/Opt I/O/Both

mnCurrentUTCTime SCHSTTIME MATH_NUMERIC REQ OUTPUT

The start time of the job based on Universal Time Coordinate (UTC) Time. UTC Time is the number of seconds elapsed since Midnight on
January 1, 1970 in Greenwich, England. UTC Time used to be called Greenwich Mean (GM) Time.

Related Functions

B91300A Scheduler Date/Time Functions

X0005 Get User Defined Codes

Related Tables

F00085 Daylight Savings Rules

GetTimeDateFromUTC
GetTimeDateFromUTC

UTC Time Functions

Minor Business Rule

Object Name: B9800009

Parent DLL: CTOOL

Location: Client/Server

Language: C

Functional Description

This function return the date and time for a UTC time.  The date and time can be either the local
time or UTC time.

Purpose

To return the date and time for a passed in UTC time.  The date and time can be local or UTC.  UTC
stands for Universal Time Coordinate and is a long integer containing the elapsed seconds since Midnight
on January 1, 1970 in Greenwich, England.  This is useful if you want to store a time zone
independent time value.

Setup Notes and Prerequisites

The system you are running this business function on must support the ANSI standard related to time.

Special Logic

Technical Specification

Data Structure

D9800009B - Get Time/Date from UTC

Parameter Name Data Item Data Type Req/Opt I/O/Both

mnUTCTime SCHSTTIME MATH_NUMERIC REQ INPUT

The start time of the job based on Universal Time Coordinate (UTC) Time. UTC Time is the number of seconds elapsed since Midnight on
January 1, 1970 in Greenwich, England. UTC Time used to be called Greenwich Mean (GM) Time.

mnTime SCHJBSTTM MATH_NUMERIC OPT OUTPUT

The time at which the job will be submitted on the next scheduled start date.

jdDate SCHJBSTDT JDEDATE OPT OUTPUT

The next date on which the Scheduler submits the scheduled job to the server for execution.

cUTC_Local YN char REQ INPUT

The Yes or No Entry field is a common single character entry field for simple yes or no responses on prompt screens.

szTimeZone TIMEZONES char OPT INPUT

Choose the time zone for which you want to view the date and time.

cDaylightSavings YN char OPT INPUT

The Yes or No Entry field is a common single character entry field for simple yes or no responses on prompt screens.

szDaylightSavingsRuleName DSAVNAME char OPT INPUT

Unique name identifying a daylight savings rule. Use daylight savings rules to adjust time for a geographic and political locale.

Related Functions

B91300A Scheduler Date/Time Functions

X0005 Get User Defined Codes

Related Tables

F00085 Daylight Savings Rules

GetUTCTime
GetUTCTime

UTC Time Functions

Minor Business Rule

Object Name: B9800009

Parent DLL: CTOOL

Location: Client/Server

Language: C

Functional Description

This function returns the UTC time for the passed in date and time.  The date and time can be either
the local time or UTC time.

Purpose

To return the UTC time for a date and time.  UTC stands for Universal Time Coordinate and is a long
integer containing the elapsed seconds since Midnight on January 1, 1970 in Greenwich, England.  This
is useful if you want to store a time zone independent time value.

Setup Notes and Prerequisites

The system you are running this business function on must support the ANSI standard related to time.

Special Logic

Technical Specification

Data Structure

D9800009A - Get UTC Time

Parameter Name Data Item Data Type Req/Opt I/O/Both

mnUTCTime SCHSTTIME MATH_NUMERIC OPT OUTPUT

The start time of the job based on Universal Time Coordinate (UTC) Time. UTC Time is the number of seconds elapsed since Midnight on
January 1, 1970 in Greenwich, England. UTC Time used to be called Greenwich Mean (GM) Time.

jdDate SCHJBSTDT JDEDATE REQ INPUT

The next date on which the Scheduler submits the scheduled job to the server for execution.

mnTime SCHJBSTTM MATH_NUMERIC REQ INPUT

The time at which the job will be submitted on the next scheduled start date.

cUTC_Local YN char REQ INPUT

The Yes or No Entry field is a common single character entry field for simple yes or no responses on prompt screens.

szTimeZone TIMEZONES char OPT INPUT

Choose the time zone for which you want to view the date and time.

cDaylightSavings YN char OPT INPUT

The Yes or No Entry field is a common single character entry field for simple yes or no responses on prompt screens.

szDaylightSavingsRuleName DSAVNAME char OPT INPUT

Unique name identifying a daylight savings rule. Use daylight savings rules to adjust time for a geographic and political locale.

Related Functions

B91300A Scheduler Date/Time Functions

X0005 Get User Defined Codes

Related Tables

F00085 Daylight Savings Rules

IsDaylightSavingsInEffect
IsDaylightSavingsInEffect

UTC Time Functions

Minor Business Rule

Object Name: B9800009

Parent DLL: CTOOL

Location: Client/Server

Language: C

Data Structure

D9800009F - Is Daylight Savings Time in Effect

Parameter Name Data Item Data Type Req/Opt I/O/Both

jdDate SCHJBSTDT JDEDATE OPT INPUT

The next date on which the Scheduler submits the scheduled job to the server for execution.

mnTime SCHJBSTTM MATH_NUMERIC REQ INPUT

The time at which the job will be submitted on the next scheduled start date.

szDaylightSavingsRuleName DSAVNAME char REQ INPUT

Unique name identifying a daylight savings rule. Use daylight savings rules to adjust time for a geographic and political locale.

cDaylightSavingsFlag DAYSAV char OPT OUTPUT

This field designates the zip code as observing daylight savings.

cSuppressErrorMessage SUPPS char OPT INPUT

A flag indicating whether or not runtime error messaging will occur when an error message is issued from a business function.        0 = allow
runtime error message handling.        1 = suppress runtime error message handling.

szDataItem DTAI char OPT OUTPUT

A code that identifies and defines a unit of information. It is an alphanumeric code up to 8 characters long that does not allow blanks or
special characters such as %, &, or +. You create new data items using system codes 55-59. You cannot change the alias.

Related Functions

B91300A Scheduler Date/Time Functions

X0005 Get User Defined Codes

Related Tables

F00085 Daylight Savings Rules

ManageUTCDSTCache
ManageUTCDSTCache

UTC Time Functions

Minor Business Rule

Object Name: B9800009

Parent DLL: CTOOL

Location: Client/Server

Language: C

Data Structure

D9800009E - Manage UTC Daylight Savings Cache

Parameter Name Data Item Data Type Req/Opt I/O/Both

szDaylightSavingsRuleName DSAVNAME char OPT INPUT

Unique name identifying a daylight savings rule. Use daylight savings rules to adjust time for a geographic and political locale.

cMode EV01 char REQ INPUT

An option that specifies the type of processing for an event.

Related Functions

B91300A Scheduler Date/Time Functions

X0005 Get User Defined Codes

Related Tables

F00085 Daylight Savings Rules

B91300A Scheduler Date/Time Functions
X0005 Get User Defined Codes

Parameter Name	Data Item	Data Type	Req/Opt	I/O/Both
mnCurrentUTCTime	SCHSTTIME	MATH_NUMERIC	REQ	OUTPUT
The start time of the job based on Universal Time Coordinate (UTC) Time. UTC Time is the number of seconds elapsed since Midnight on January 1, 1970 in Greenwich, England. UTC Time used to be called Greenwich Mean (GM) Time.

Parameter Name	Data Item	Data Type	Req/Opt	I/O/Both
mnUTCTime	SCHSTTIME	MATH_NUMERIC	REQ	INPUT
The start time of the job based on Universal Time Coordinate (UTC) Time. UTC Time is the number of seconds elapsed since Midnight on January 1, 1970 in Greenwich, England. UTC Time used to be called Greenwich Mean (GM) Time.
mnTime	SCHJBSTTM	MATH_NUMERIC	OPT	OUTPUT
The time at which the job will be submitted on the next scheduled start date.
jdDate	SCHJBSTDT	JDEDATE	OPT	OUTPUT
The next date on which the Scheduler submits the scheduled job to the server for execution.
cUTC_Local	YN	char	REQ	INPUT
The Yes or No Entry field is a common single character entry field for simple yes or no responses on prompt screens.
szTimeZone	TIMEZONES	char	OPT	INPUT
Choose the time zone for which you want to view the date and time.
cDaylightSavings	YN	char	OPT	INPUT
The Yes or No Entry field is a common single character entry field for simple yes or no responses on prompt screens.
szDaylightSavingsRuleName	DSAVNAME	char	OPT	INPUT
Unique name identifying a daylight savings rule. Use daylight savings rules to adjust time for a geographic and political locale.