| 1 | PXRMDATE ; SLC/PKR - Clinical Reminders date utilities. ;01/24/2007 | 
|---|
| 2 | ;;2.0;CLINICAL REMINDERS;**4,6**;Feb 04, 2005;Build 123 | 
|---|
| 3 | ; | 
|---|
| 4 | ;================================================== | 
|---|
| 5 | CEFD(FDA) ;Called by the Exchange Utility only if the input packed | 
|---|
| 6 | ;reminder was packed under v1.5  Move Effective Date to Beginning Date. | 
|---|
| 7 | N IND | 
|---|
| 8 | S IND="" | 
|---|
| 9 | F  S IND=$O(FDA(811.902,IND)) Q:IND=""  D | 
|---|
| 10 | . I '$D(FDA(811.902,IND,12)) Q | 
|---|
| 11 | .;If the EFFECTIVE PERIOD exists don't do anything. | 
|---|
| 12 | . I $D(FDA(811.902,IND,9)) Q | 
|---|
| 13 | . S FDA(811.902,IND,9)=FDA(811.902,IND,12) | 
|---|
| 14 | . K FDA(811.902,IND,12) | 
|---|
| 15 | Q | 
|---|
| 16 | ; | 
|---|
| 17 | ;================================================== | 
|---|
| 18 | COMPARE(X) ;Compare beginning and ending dates, give a warning if | 
|---|
| 19 | ;Ending Date comes before Beginning Date. Called by ADATE xref in | 
|---|
| 20 | ;definitions and terms. | 
|---|
| 21 | ;Do not execute as part of exchange. | 
|---|
| 22 | I $G(PXRMEXCH) Q | 
|---|
| 23 | N BDT,EDT | 
|---|
| 24 | S BDT=$S(X(1)'="":$$CTFMD^PXRMDATE(X(1)),1:0) | 
|---|
| 25 | S EDT=X(2) | 
|---|
| 26 | I EDT="" S EDT="T" | 
|---|
| 27 | S EDT=$$CTFMD^PXRMDATE(EDT) | 
|---|
| 28 | ;If EDT does not contain a time set it to the end of the day. | 
|---|
| 29 | I EDT'["." S EDT=EDT_".235959" | 
|---|
| 30 | I EDT<BDT D | 
|---|
| 31 | . S BDT=$S(X(1)'="":X(1),1:"") | 
|---|
| 32 | . S EDT=$S(X(2)'="":X(2),1:"T@2400") | 
|---|
| 33 | . S TEXT="Warning the ending date ("_EDT_") is before the beginning date ("_BDT_")" | 
|---|
| 34 | . D EN^DDIOL(TEXT) | 
|---|
| 35 | Q | 
|---|
| 36 | ; | 
|---|
| 37 | ;================================================== | 
|---|
| 38 | COTN(EFP) ;Convert an Effective Period to the new date/time format. | 
|---|
| 39 | ;Possible effective periods are ND, NM, or NY where N is an integer. | 
|---|
| 40 | S EFP=$$UP^XLFSTR(EFP) | 
|---|
| 41 | I (EFP?1N.N1"D")!(EFP?1N.N1"M")!(EFP?1N.N1"Y") D | 
|---|
| 42 | . S NUM=+EFP | 
|---|
| 43 | . S EFP=$S(NUM=0:"T",1:"T-"_EFP) | 
|---|
| 44 | Q EFP | 
|---|
| 45 | ; | 
|---|
| 46 | ;================================================== | 
|---|
| 47 | CTFMD(DATE) ;Convert DATE which may be in any of the FileMan acceptable | 
|---|
| 48 | ;forms as well as T-NY to a FileMan date. Also understands LAD for | 
|---|
| 49 | ;Last Admission Date. | 
|---|
| 50 | N %DT,ND,X,Y | 
|---|
| 51 | ;Already a FileMan date? | 
|---|
| 52 | S ND=+DATE | 
|---|
| 53 | I (ND'<1000000),(ND'>9991231) Q DATE | 
|---|
| 54 | ;Check for a date FileMan understands. | 
|---|
| 55 | S X=DATE,%DT="ST" | 
|---|
| 56 | D ^%DT | 
|---|
| 57 | ;If it is not a FileMan date check for a symbolic date. | 
|---|
| 58 | I Y=-1 S Y=$$SYMDATE(DATE) | 
|---|
| 59 | ;If it is not a date that is understood by SYMDATE return -1 | 
|---|
| 60 | I Y=-1 Q -1 | 
|---|
| 61 | I $G(PXRMDATE)'="",$$ISVSYMD(DATE) D | 
|---|
| 62 | . N DIFFS | 
|---|
| 63 | . S DIFFS=-$$FMDIFF^XLFDT(DT,PXRMDATE,2) | 
|---|
| 64 | . S Y=$$FMADD^XLFDT(Y,0,0,0,DIFFS) | 
|---|
| 65 | I DATE["LAD" D | 
|---|
| 66 | . I $G(PXRMLAD)="" S Y=0 | 
|---|
| 67 | . E  D | 
|---|
| 68 | .. N DIFFS | 
|---|
| 69 | .. S DIFFS=-$$FMDIFF^XLFDT(DT,$G(PXRMLAD),2) | 
|---|
| 70 | .. S Y=$$FMADD^XLFDT(Y,0,0,0,DIFFS) | 
|---|
| 71 | Q Y | 
|---|
| 72 | ; | 
|---|
| 73 | ;================================================= | 
|---|
| 74 | DCHECK(DATE) ;Trap for special characters before calling CTFMD^PXRMDATE. | 
|---|
| 75 | ;Used in DIR("PRE") for date inputs. | 
|---|
| 76 | I $D(DTOUT) Q DATE | 
|---|
| 77 | I DATE="" Q DATE | 
|---|
| 78 | I DATE["^" Q DATE | 
|---|
| 79 | I DATE["?" Q DATE | 
|---|
| 80 | Q $$CTFMD^PXRMDATE(DATE) | 
|---|
| 81 | ; | 
|---|
| 82 | ;================================================== | 
|---|
| 83 | DUE(DEFARR,RESDATE,FREQ,DUE,DUEDATE,FIEVAL) ;Compute the due date. | 
|---|
| 84 | ;This is the date of the resolution finding + the reminder frequency. | 
|---|
| 85 | ;Subtract the due in advance time to see if the reminder should be | 
|---|
| 86 | ;marked as due soon. | 
|---|
| 87 | ; | 
|---|
| 88 | N DATE,DIAT,DIATOK,LDATE,PXRMITEM,TDDUE,TODAY | 
|---|
| 89 | S PXRMITEM=DEFARR("IEN") | 
|---|
| 90 | ;If the final frequency is 0Y then the reminder is not due. | 
|---|
| 91 | I FREQ="0Y" S DUE=0,DUEDATE="" Q | 
|---|
| 92 | ; | 
|---|
| 93 | S DUEDATE="" | 
|---|
| 94 | ;Check for custom date due. | 
|---|
| 95 | I DEFARR(45)'="" S DUEDATE=$$CDUEDATE^PXRMCDUE(.DEFARR,.FIEVAL) | 
|---|
| 96 | I DUEDATE'="",DUEDATE'=-1 G SETDUE | 
|---|
| 97 | ; | 
|---|
| 98 | ;No custom date due, do regular date calculation. | 
|---|
| 99 | I (FREQ="")!(FREQ=-1) D  Q | 
|---|
| 100 | . S ^TMP(PXRMPID,$J,PXRMITEM,"WARNING","NOFREQ")="No reminder frequency - cannot compute due date!" | 
|---|
| 101 | . S (DUE,DUEDATE)="CNBD" | 
|---|
| 102 | ; | 
|---|
| 103 | S LDATE=$S(RESDATE["X":0,1:+RESDATE) | 
|---|
| 104 | I LDATE=0 S (DUE,DUEDATE)="DUE NOW" Q | 
|---|
| 105 | S DATE=$$FULLDATE(LDATE),DUEDATE=$$NEWDATE(DATE,FREQ) | 
|---|
| 106 | ; | 
|---|
| 107 | SETDUE ;If the due date is less than or equal to today's date the reminder | 
|---|
| 108 | ;is due. | 
|---|
| 109 | S TODAY=$$NOW^PXRMDATE | 
|---|
| 110 | I +DUEDATE'>TODAY S DUE="DUE NOW"  Q | 
|---|
| 111 | ; | 
|---|
| 112 | S DIAT="-"_$P(DEFARR(0),U,4) | 
|---|
| 113 | I DIAT="-" D | 
|---|
| 114 | . S DIATOK=0 | 
|---|
| 115 | . S ^TMP(PXRMPID,$J,PXRMITEM,"WARNING","DIAT")="Warning no do in advance time" | 
|---|
| 116 | E  S DIATOK=1 | 
|---|
| 117 | ; | 
|---|
| 118 | S TDDUE=$S(DIATOK=1:$$NEWDATE(DUEDATE,DIAT),1:DUEDATE) | 
|---|
| 119 | S DUE=$S(TDDUE'>TODAY:"DUE SOON",1:"RESOLVED") | 
|---|
| 120 | Q | 
|---|
| 121 | ; | 
|---|
| 122 | ;================================================== | 
|---|
| 123 | DURATION(START,STOP) ;Return the number days between the Start Date and | 
|---|
| 124 | ;Stop Date. | 
|---|
| 125 | I +START=0 Q 0 | 
|---|
| 126 | N PXRMNOW | 
|---|
| 127 | S PXRMNOW=$$NOW^PXRMDATE | 
|---|
| 128 | I START>PXRMNOW Q 0 | 
|---|
| 129 | I (STOP="")!(STOP>PXRMNOW) S STOP=PXRMNOW | 
|---|
| 130 | Q $$FMDIFF^XLFDT(STOP,START) | 
|---|
| 131 | ; | 
|---|
| 132 | ;================================================== | 
|---|
| 133 | EDATE(DATE) ;Check for an historical (event) date, format as appropriate. | 
|---|
| 134 | Q $$FMTE^XLFDT(DATE,"5DZ") | 
|---|
| 135 | ; | 
|---|
| 136 | ;================================================== | 
|---|
| 137 | FULLDATE(DATE) ;See if DATE is a full date, i.e., it has a month and | 
|---|
| 138 | ;a day along with a year. If the month is missing assume Jan. If the | 
|---|
| 139 | ;day is missing assume the first. Issue a warning so the user knows | 
|---|
| 140 | ;what happened. DATE should be in Fileman format. | 
|---|
| 141 | N DAY,MISSING,MONTH,TDATE,YEAR | 
|---|
| 142 | S TDATE=DATE | 
|---|
| 143 | S MISSING=0 | 
|---|
| 144 | S DAY=$E(DATE,6,7) | 
|---|
| 145 | S MONTH=$E(DATE,4,5) | 
|---|
| 146 | S YEAR=$E(DATE,1,3) | 
|---|
| 147 | I +DAY=0 D | 
|---|
| 148 | . S DAY=1 | 
|---|
| 149 | . S MISSING=1 | 
|---|
| 150 | . S ^TMP(PXRMPID,$J,PXRMITEM,"INFO","NO DAY")="Encounter date missing the day, using the first for the date due calculation." | 
|---|
| 151 | I +MONTH=0 D | 
|---|
| 152 | . S MONTH=1 | 
|---|
| 153 | . S MISSING=1 | 
|---|
| 154 | . S ^TMP(PXRMPID,$J,PXRMITEM,"INFO","NO MONTH")="Encounter date missing the month, using January for the date due calculation." | 
|---|
| 155 | I MISSING D | 
|---|
| 156 | . S TDATE=(YEAR*1E4)+(MONTH*1E2)+DAY | 
|---|
| 157 | . I DATE["E" S TDATE=TDATE_"E" | 
|---|
| 158 | Q TDATE | 
|---|
| 159 | ; | 
|---|
| 160 | ;================================================== | 
|---|
| 161 | FRQINDAY(FREQ) ;Given a frequency in the form ND, NM, or NY where N is a | 
|---|
| 162 | ;number and D stands for days, M for months, and Y for years return | 
|---|
| 163 | ;the value in days. | 
|---|
| 164 | I FREQ="" Q "" | 
|---|
| 165 | N CODE,LEN,MULT,NUM | 
|---|
| 166 | S LEN=$L(FREQ) | 
|---|
| 167 | S NUM=$E(FREQ,1,LEN-1) | 
|---|
| 168 | S CODE=$E(FREQ,LEN,LEN) | 
|---|
| 169 | S MULT=1.0 | 
|---|
| 170 | I CODE="M" S MULT=30.42 | 
|---|
| 171 | I CODE="Y" S MULT=365.25 | 
|---|
| 172 | Q +(MULT*NUM) | 
|---|
| 173 | ; | 
|---|
| 174 | ;================================================== | 
|---|
| 175 | ISVSYMD(DATE) ;Return true if DATE is a valid symbolic date. | 
|---|
| 176 | N P1,P1OK,P2,P2OK,OP,PAT | 
|---|
| 177 | S DATE=$P(DATE,"@",1) | 
|---|
| 178 | S OP=$S(DATE["+":"+",1:"-") | 
|---|
| 179 | S P1=$P(DATE,OP,1),P1OK=0 | 
|---|
| 180 | F PAT="T","TODAY","N","NOW" I P1=PAT S P1OK=1 Q:P1OK | 
|---|
| 181 | I PAT=DATE Q 1 | 
|---|
| 182 | S P2=$P(DATE,OP,2),P2OK=0 | 
|---|
| 183 | F PAT="1N.N","1N.N1""D""","1N.N1""M""","1N.N1""Y""" I P2?@PAT S P2OK=1 Q:P2OK | 
|---|
| 184 | Q P1OK&P2OK | 
|---|
| 185 | ; | 
|---|
| 186 | ;================================================== | 
|---|
| 187 | NEWDATE(FMDATE,OFFSET) ;Given a date in VA Fileman format (FMDATE) and an | 
|---|
| 188 | ;offset of the form NY, NM, ND where N is a number and Y stands for | 
|---|
| 189 | ;years, M for months, and D for days return the new date in VA Fileman | 
|---|
| 190 | ;format. | 
|---|
| 191 | I FMDATE=0 Q 0 | 
|---|
| 192 | N LEN,NEWDATE,NUM,UNIT | 
|---|
| 193 | S LEN=$L(OFFSET) | 
|---|
| 194 | S NUM=+$E(OFFSET,1,LEN-1) | 
|---|
| 195 | S UNIT=$E(OFFSET,LEN) | 
|---|
| 196 | I UNIT="D" G DAY | 
|---|
| 197 | I UNIT="M" G MONTH | 
|---|
| 198 | I UNIT="Y" G YEAR | 
|---|
| 199 | ;Unknown unit just return the original date | 
|---|
| 200 | Q FMDATE | 
|---|
| 201 | DAY ; | 
|---|
| 202 | S NEWDATE=+$$FMADD^XLFDT(FMDATE,NUM) | 
|---|
| 203 | Q NEWDATE | 
|---|
| 204 | MONTH ; | 
|---|
| 205 | ;Convert the months to days and then add the days using the DAY code. | 
|---|
| 206 | ;Multiply the number of months by the average number of days in a month. | 
|---|
| 207 | N INT,FRAC | 
|---|
| 208 | S NUM=30.42*NUM | 
|---|
| 209 | ;Round the number of days, FMADD^XLFDT has problems with non-integer | 
|---|
| 210 | ;days. | 
|---|
| 211 | S INT=+$P(NUM,".",1) | 
|---|
| 212 | S FRAC=NUM-INT | 
|---|
| 213 | I FRAC<0.5 S NUM=INT | 
|---|
| 214 | E  S NUM=INT+1 | 
|---|
| 215 | G DAY | 
|---|
| 216 | Q | 
|---|
| 217 | YEAR ; | 
|---|
| 218 | Q FMDATE+(10000*NUM) | 
|---|
| 219 | ; | 
|---|
| 220 | ;================================================== | 
|---|
| 221 | NOW() ;If the reminder global PXRMDATE is defined return it, otherwise | 
|---|
| 222 | ;return the current date and time. | 
|---|
| 223 | Q $S(+$G(PXRMDATE)>0:PXRMDATE,1:$$NOW^XLFDT) | 
|---|
| 224 | ; | 
|---|
| 225 | ;================================================== | 
|---|
| 226 | SYMDATE(DATE) ;Convert a symbolic date into a FileMan date. | 
|---|
| 227 | N %DT,OPER,PFSTACK,SYM,TIME,X,Y | 
|---|
| 228 | S TIME=$P(DATE,"@",2),DATE=$P(DATE,"@",1) | 
|---|
| 229 | S X=$S(DATE="LAD":$G(PXRMLAD),1:"") | 
|---|
| 230 | I X="" D | 
|---|
| 231 | . S OPER="+-" | 
|---|
| 232 | . D POSTFIX^PXRMSTAC(DATE,OPER,.PFSTACK) | 
|---|
| 233 | I PFSTACK(0)=3 D | 
|---|
| 234 | . S SYM=PFSTACK(1) | 
|---|
| 235 | . S SYM=$S(SYM="LAD":"T",SYM="N":"N",SYM="NOW":"N",SYM="T":"T",SYM="TODAY":"T",1:"") | 
|---|
| 236 | . I SYM="" S Y=-1 Q | 
|---|
| 237 | .;FileMan only handles D, W, or M so convert Y to months. | 
|---|
| 238 | . I PFSTACK(2)["Y" S PFSTACK(2)=+PFSTACK(2)*12_"M" | 
|---|
| 239 | . S X=SYM_PFSTACK(3)_PFSTACK(2) | 
|---|
| 240 | I PFSTACK(0)=1 S X=PFSTACK(1) | 
|---|
| 241 | I TIME'="" S X=X_"@"_TIME | 
|---|
| 242 | S %DT="ST" | 
|---|
| 243 | D ^%DT | 
|---|
| 244 | Q Y | 
|---|
| 245 | ; | 
|---|
| 246 | ;================================================== | 
|---|
| 247 | VDATE(VIEN) ;Given a visit ien return the visit date. | 
|---|
| 248 | N DATE | 
|---|
| 249 | I +VIEN>0 S DATE=$P($G(^AUPNVSIT(VIEN,0)),U,1) | 
|---|
| 250 | E  S DATE=0 | 
|---|
| 251 | I $L(DATE)=0 S DATE=0 | 
|---|
| 252 | ;Check for historical encounter. | 
|---|
| 253 | I $$ISHIST^PXRMVSIT(VIEN) S DATE=DATE_"E" | 
|---|
| 254 | Q DATE | 
|---|
| 255 | ; | 
|---|