CheckForDSTIssues
- Last UpdatedJul 05, 2024
- 2 minute read
The function of this Business Logic Tier (BLT) is to check for any potential issues with Daylight Savings Time (DST), when given a date time. This is primarily used for checking DST issues for a jsh record.
Syntax
CheckForDSTIssues <year>, <month>, <day>, <hour>, <minute>, <second>
Parameters
|
Name |
Description |
|---|---|
|
year |
This parameter indicates the year of the datetime being checked. Zero (0) indicates from the current year to the next 10 years. |
|
month |
This parameter indicates the month of the datetime being checked. Zero (0) indicates any month. |
|
day |
This parameter indicates the day of the datetime being checked.
|
|
hour |
This parameter indicates the hour of the datetime being checked. |
|
minute |
This parameter indicates the minute of the datetime being checked. |
|
second |
This parameter indicates the second of the datetime being checked. |
Comments
After the BLT checks for any potential issues, it returns a tabular result with any findings. Potential issues are displayed as an errorNumber and the corresponding errorMessage. The errorNumber is a positive value if it represents a warning, and a negative value if it represents an error. Use the table below to decode the errorNumber that is returned when this BLT is called.
|
errorNumber |
errorMessage |
Cause of error/ warning |
|---|---|---|
|
0 |
|
No warnings or errors are detected. |
|
-1 |
Error: Invalid input time: <ArgumentError>. |
An error is generated because the input arguments are invalid. |
|
-1 |
Error: Invalid time due to daylight savings time transition. |
An error is generated because the input time is invalid due to DST transition. |
|
1 |
Warning: Ambiguous time for DST transition. |
A warning is generated because the input time is an ambiguous time for DST transition. |
|
2 |
Warning: Scheduled date/time conflicts with time change due to transition to Daylight Saving Time. One or more occurrences will be skipped. |
A warning is generated because the input time will be skipped when entering DST. |
|
3 |
Warning: Scheduled date/time conflicts with time change due to transition to Standard Time. One or more occurrences will be executed twice. |
A warning is generated because the input time will be repeated when leaving DST. |
|
4 |
Warning: Scheduled date/time conflicts with time change due to transition to Standard Time or Daylight Saving Time. One or more occurrences will be executed twice or be skipped. |
A warning is generated because the input time will be repeated when leaving DST or skipped when entering DST. |