/*===============================================================================================|\
||                                                                                               ||
||        String Is Time Function Procedure       v1.10p  Date 10.30.2007     KTL                ||
||                                                                                               ||
||  Returns:     True if the string contains a viable time value or False if it doesnot. Will    ||
||               return False if the imput is 'OFF' but will not generate any error messages.    ||
||                                                                                               ||
||  purpose:     To Check if string input contains a viable time inputed by the user. The format ||
||               of the string must be in the form of [ 00:00 ] / [ HH:MM ]. If any other form   ||
||               of time input is given the function return will be 'False'.                     ||
||                                                                                               ||
||  Parameters:  InString     -- Is the string to test for, as time.                             ||
||               ErrorOutPut  -- This is to turn on or off error reporting (on by default) This  ||
||                    way you can use this function as a warning of a possible bad input or in   ||
||                    an IF() statement to control program execution on bad user input string.   ||
||                                                                                               ||
||  Note:        It is assumed at first the input is False till proven otherwise. The first test ||
||               is on the length of the string if its not 3 or 5 Characters long then return    ||
||               is FALSE. If the length is 3 characters it tests to see if the input is 'OFF'.  ||
||               Case is not relavent. This is a means to turn off a certain time function with  ||
||               a 'off' user input. If the string length is equal to five then a check is made  ||
||               to see if all the characters are numbers or the colon. If anything else it will ||
||               trigger an error message. A check is made to see if the center character is a   ||
||               colon. The final two test are to see if the hour part of the string in between  ||
||               0 and 23, and the last test is on the minute part to see if its between 0 and   ||
||               59 if these are not true, it will trigger an error. On the occurance of the     ||
||               first error the routine will exist without completing all its check points.     ||
||                                                                                               ||
||               Version 1.02 Was improved. Changes were made to cover all posible wrong time    ||
||               inputs, the older version let some errors get by.                               ||
||                                                                                               ||
||               Version 1.10 This version also has the ability to input the String 'OFF' to     ||
||               stop or cancell an opperation with the use of an IF() statement in your code.   ||
||               Off will not generate an error message. Its intended to use as a swithch to     ||
||               turn off a time function in your code with an extern user input.                ||
||                                                                                               ||
||               version  1.10p is a public release which should work on any MQ4 code b213 and   ||
||               up. Other versions require the use of the Lore Script Engine to run.            ||
||                                                                                               ||
||  Example: Command line     StringIsTime( string [of time], bool [error reporting] );          ||
||                                                                                               ||
||               StringIsTime( "12:00", False ); Function returns true, error reporting has      ||
||                  been turned off.                                                             ||
||                                                                                               ||
||               StringIsTime( CheckTime ); If varaible 'CheckTime' equals a real time input     ||
||                  the fruction reterns true. If 'CheckTime' is not a viable time input it      ||
||                  will return false, and will report the error to your expert journal log.     ||
||                  If 'CheckTime' = OFF (in any case), than you will be able to turn off        ||
||                  different parts of your code with the use of external user input parameters. ||
||                                                                                               ||
\|-----------------------------------------------------------------------------------------------*/
    bool
        StringIsTime( string InString, bool ErrorOutPut = True ) {
            int    Index         =  0;
            int    Character     =  0;
            int    Length        =  0;
            int    HourPart      =  0;
            int    MinutePart    =  0;
            bool   Seccessful    =  False;
                Length =  StringLen( InString ); 
                switch ( Length ) {
                    case 3:
                        ErrorOutPut  =  False;
                        for( Index = 0; Index < Length; Index = Index + 1 ) {
                            Character  =  StringGetChar( InString, Index );
                            if( Index == 0 &&
                                ( Character != 79 && Character != 111 ))
                                    ErrorOutPut  =  True;
                            if(( Index == 1 || Index == 2 ) &&
                                ( Character != 70 && Character != 102 ))
                                    ErrorOutPut  =  True;
                        } // End For Loop, Index:
                        break;
                    case 5:
                        HourPart    =  StrToInteger( StringSubstr( InString, 0, 2 ));
                        MinutePart  =  StrToInteger( StringSubstr( InString, 3, 2 ));
                        if( HourPart   < 0 || HourPart   > 23 )   { break; }
                        if( MinutePart < 0 || MinutePart > 59 )   { break; }
                            for( Index = 0; Index < Length; Index = Index + 1 ) {
                                Character  =  StringGetChar( InString, Index );
                                if( Character < 48 && Character > 58 )
                                    break;
                                if( Index == 2 && Character != 58 )
                                    break;
                            } // End For Loop, Index:
                            Seccessful  =  True;
                        break;
                } // End Switch Case, Length:
                if( ! Seccessful && ErrorOutPut )
                    Print( " WARNING: Time Input [ ", InString, " ] does ",
                            "not check out to be a string containing a time variable." );
        return( Seccessful );
    } // End Function Procedure, StringIsTime:

    if( ! StringIsTime( SetFridayClose )) {
        Print( "DATA ENTRY ERROR: The Time Entered For Friday Close Is Not ",
               "Recongized As A Viable Time Input. Recheck Your Time Entry." );
        DataValidated  =  False;
    } // End If, StringIsTime:

    if( StringIsTime( TradeDayEnds ) && StringIsTime( SetStartOfDay ) ) {
        TradeQuitingTime   =  InitializeTime( TradeDayEnds, GMTime );
        LocalQuitingTime   =  InitializeTime( TradeDayEnds, LocalTimeOffSet );
        BrokerQuitingTime  =  InitializeTime( TradeDayEnds, DealerTimeOffSet );
        OrderExpires       =  InitializeTime( TradeDayEnds, DealerTimeOffSet - AdvanceClosing );
    } // End If, StringIsTime:

    if( StringIsTime( TradeAsianSession )) {
        Increment( SessionCount );
        SrartOfAsianBox        =  InitializeTime( TradeAsianSession, DataWindowDepth );
        OrderTimeAsianSession  =  InitializeTime( TradeAsianSession, DealerTimeOffSet );
        LocalTimeAsianSession  =  InitializeTime( TradeAsianSession, LocalTimeOffSet  );
        if( OrderTimeAsianSession > TimeCurrent() ) {
            TradeKey[ AsianSession ]  =  ON;
            Increment( NumberOfSessions );
            Accumulate( MaxOpenPositions, Two );
            if( FirstTradeOfDay == Empty ) { FirstTradeOfDay  =  OrderTimeAsianSession; }
        } else { // this block will turn off the sessions if time has already passed.
            TradeKey[ AsianSession ]  =  OFF;
            Print( "NOTICE: The Asian Trade Start Time Has Past, It ",
                    "Will Not Be Traded Today." );
        } // End If, OrderTimeAsianSession:
    } else { // heres were the code branches too if OFF is incountered as user input
        TradeKey[ AsianSession ]  =  OFF;
        Print( "NOTICE: The Asian Trade Session Has Been Turned OFF." );
    } // End If, StringIsTime: