Thursday, February 23, 2012

Tutorial: Determine if a string is a valid UtcDateTime

In my post about UtcDateTime in Dynamics AX, I recently received a question about determining if a specific string is a valid UtcDateTime in X++.I've spent some time looking into it and could not find an available method that could be used for that.
Also, it was not really clear, which format should be called valid.

Anyhow, I have so far discovered 2 ways to do it in AX: the simple way, and MY way :) They produce slightly different results however. Let me know if you find other ways.

The simple way is to use the intrinsic function str2datetime.
As you can see on MSDN, it supports a couple of input formats, and if you provide a non-date value, will just ignore it silently and return an empty value.

However, when working with DateTimeUtil methods, the expected format is yyyy-mm-ddThh:mm:ss
And, as you can see from the below test job, specifically this format is not supported by str2datetime.
So I wrote my own method based on DateTimeUtil::parse(), that returns true/false based on the string value matching the above format. This is however the only supported format for DateTimeUtil, so the other 3 examples that work with str2datetime do not work here.

Anyhow, you can download the code (I've put the method into Global) and the test job from my SkyDrive.

Test job:
public static void isValidUTCDateTimeTest(utcDateTime _utcDateTime)
    boolean utc1 = str2datetime("2012/02/25 23:04:59", 321) != utcDateTimeNull();
    boolean utc2 = str2datetime("Feb-2012-25 11:04:59 pm", 231) != utcDateTimeNull();
    boolean utc3 = str2datetime("25 02 2012 11:04:59 pm", 123) != utcDateTimeNull();
    boolean utc4 = str2datetime("2012-02-25T23:04:59", 321) != utcDateTimeNull();
    boolean utc5 = str2datetime("XXXX", 123) != utcDateTimeNull();

    void showResult(str format, boolean isValid)
        info(strFmt("%1 - %2", format, isValid));

    setPrefix("Date time validation");
    setPrefix("str2datetime has multiple valid formats");
    showResult("2012/02/25 23:04:59",       utc1);
    showResult("Feb-2012-25 11:04:59 pm",   utc2);
    showResult("25 02 2012 11:04:59 pm",    utc3);
    showResult("2012-02-25T23:04:59",       utc4);
    showResult("XXXX",                      utc5);

    setPrefix("Correct UtcDateTime format for DateTimeUtil: yyyy-mm-ddThh:mm:ss");
    showResult("2012/02/25 23:04:59",      isValidUTCDateTime("2012/02/25 23:04:59"));
    showResult("Feb-2012-25 11:04:59 pm",  isValidUTCDateTime("Feb-2012-25 11:04:59 pm"));
    showResult("25 02 2012 11:04:59 pm",   isValidUTCDateTime("25 02 2012 11:04:59 pm"));
    showResult("2012-02-25T23:04:59",      isValidUTCDateTime("2012-02-25T23:04:59"));
    showResult("XXXX",                     isValidUTCDateTime("XXXX"));

Tip: Illegal 'closing bracket' character when defining a macro

Just a very quick tip today, related to macros:

As you all know, there are multiple ways to define and use macros in X++.
For those that need a refresher, please look up the corresponding section on MSDN
(Direct link:

Below is a simple X++ job, that demonstrates an existing shortcoming in the #define command, and a possible workaround for this problem.

Nothing complicated, basically, just use #localmacro, if you can't compile your code.

static void ClosingBracketInMacroDefinition(Args _args)
    //#define.Question("Why are brackets ')' not working ?")
    //#define.Question(@"Why are brackets ')' not working ?")
    //#define.Question("Why are brackets '\)' not working ?")
    #define.LegalCharacters(' !"#$%&\'(*+,-./:;<=>?@[\\]^_`{|}~\n\r\t')
        "Why are brackets ')' not working ?"


Thanks for finding the issue to Bogdana, one of our new developers.