| INPUT PARAMETER |
-
- INVAL
- PARAMETER TYPE: LITERAL
- MAXIMUM DATA LENGTH: 25
- REQUIRED: YES
- SEQUENCE NUMBER: 1
- DESCRIPTION:
This is the input date.time value to be converted. If this parameters
2. For Internationalization, this assumes that in the input, the day
number precedes the month number. For example, input of 05/11/2000
is assumed to be November 5, 2000 (instead of May 11, 2000). Also,
with this flag, the month must be input as a number. For example,
November must be input as 11, not NOV.
3. To simplify entering dates, you can use shortcuts such as T for
today, T-1 for yesterday, or T+1 for tomorrow. Or you can combine
T with D for day, W for week, M for month, or Y for year; T-2D
contains any alpha characters, this RPC will always assume that this
means two days ago, T+1W means today plus one week, T+4M means four
months from today, and T-3Y means three years ago from today.
4. For time input, to be totally unambiguous, time can be as military
time (four or six digits, no colon), hour AM/PM, hour:minute AM/PM,
or hour:minute:second AM/PM. If you do omit an AM/PM notation, the
following assumptions are made:
a. If you enter a single digit for the hour, a time between 6AM
and 6PM is used. Thus, T@330 (or T@3:30) means today at 3:30 PM
and T@945 (or T@9:45) means today at 9:45 AM.
input value is in external form (i.e., human readable format). When
b. If you enter two digits for the hour, the actual hour entered is
used (as if military time were being used). Thus, T@0330 (or
T@03:30) means today at 3:30 AM.
c. As with dates, there are supported abbreviations you can use
when entering times in DATE/TIME fields.
1) To enter the present moment, you can enter the word NOW
2) To enter an hour from the present moment, enter NOW+1H
3) To enter an hour ago from the present moment, enter NOW-1H
4) You can also combine NOW with D for day, M for month, and
' (apostrophe) for minute (NOW+3' for present time plus 3
sending external (human readable) date.time, then following applies:
minutes.
5) And you can enter MID for 12 a.m. and NOON for 12 p.m.
1. If a two-digit year is entered, a year less than 20 years in the
future and no more than 80 years in the past is assumed. For
example, in the year 2000, two-digit years are assumed to be
between 1920 through 2019.
-
- INTYPE
- PARAMETER TYPE: LITERAL
- MAXIMUM DATA LENGTH: 2
- REQUIRED: NO
- SEQUENCE NUMBER: 2
- DESCRIPTION:
Optional - only if INVAL contains an alpha character. Else, this is
"H" - INVAL is in HL7 format
"G" - INVAL is in UCT format
"I" - INVAL is in Internationalized format, i.e.,
the day number precedes the month number
required. Usually it is a single character. If two characters, then it
must be one of the first 6 listed below plus "I". If INVAL="I" then
assume INVAL in external format.
"D" - INVAL is in Delphi internal format
"F" - INVAL is in internal Fileman format
"E" - INVAL is in external format (human readable)
"M" - INVAL is in internal M format ($H)
-
- OUTYPE
- PARAMETER TYPE: LITERAL
- MAXIMUM DATA LENGTH: 6
- REQUIRED: NO
- SEQUENCE NUMBER: 3
- DESCRIPTION:
Optional - default value is internal Fileman format "F". This is a
"G" - return UCT format
string of characters designating output format(s)
If OUTYPE contains "F" - return internal Fileman format
"D" - return internal Delphi format
"E" - return external format
"M" - return internal M format ($H)
"A" - return all formats
"H" - return HL7 format
-
- OUTFMT
- PARAMETER TYPE: LITERAL
- MAXIMUM DATA LENGTH: 10
- REQUIRED: NO
- SEQUENCE NUMBER: 4
- DESCRIPTION:
Optional - this param controls the format of the returned value for
5 - mm/dd/yyyy@hh:mm:ss [no leading zeros]
6 - dd/mm/yyyy@hh:mm:ss [no leading zeros]
7 - yyyy/mm/dd@hh:mm:ss [no leading zeros]
D - return date only
F - output with leading blanks
S - force seconds in outputs
Z - pad months and days with leading zeros
P - output time in ' hh:mm:ss am/pm'
external date value only. OUTFMT can contain only a single digit plus
optional alpha characters.
If OUTFMT = "" - then return mmm dd, yyyy@hh:mm:ss - default
contains 1 - mmm dd, yyyy@hh:mm:ss - default
2 - mm/dd/yy@hh:mm:ss [no leading zeros]
3 - dd/mm/yy@hh:mm:ss [no leading zeros]
4 - yy/mm/dd@hh:mm:ss [no leading zeros]
-
- TIMEFMT
- PARAMETER TYPE: LITERAL
- MAXIMUM DATA LENGTH: 1
- REQUIRED: NO
- SEQUENCE NUMBER: 5
- DESCRIPTION:
Optional - controls what portion of the time part of the date will be
returned. Default value is M
If TIMEFMT = H, then return only hours
= M, then return only hour:minute
= S, then return seconds
|
| RETURN PARAMETER DESCRIPTION |
If OUTYPE is a single character, not equal to A, then return a single
p5 = HL7 format
p6 = UCT format
Only those pieces requested in OUTYPE will be returned.
If problems encountered, return the word ERR
NOTES: -1 is a valid return value for an internal Delphi date.time
Thus for any problems encountered, return "ERR^message". Not every ERR
return value will have a message on the 2nd piece as many of the Kernel
date.time value in the specified format.
and Fileman date utilities only return a value of -1 if any problems
encountered with no further explanation
If OUTYPE is equal to A or is more than one character, then return a
string in the format p1^p2^p3^p4^p5^p6 where
p1 = internal Delphi format
p2 = internal Fileman format
p3 = external format (human readable)
p4 = internal M format ($H)
|
