Working with utcDateTime Functionality in Dynamics AX 2012

by | Updated March 29, 2021 | Development, Dynamics AX

Dynamics AX 2012 utilizes the utcDateTime data type to store date time information in the database using the Greenwich Mean Time definition of time. This allows the data to be date stamped in a manner that does not reflect the client or AOS time zone (this date/time stamp is considered to be time zone agnostic).

However, this means that some care may be needed in X++ code to correctly work with these values so the information can be displayed properly in some instances.

The Dynamics AX 2012 kernel has a nice class built in to allow us the ability to easily work with these values. The following job will demonstrate how to use just a few of the built in methods from this class:

The job is going to work with the Eastern, Central, and Pacific timezones within the United States.

After the variable declarations, the first method used is the DateTimeUtil::getSystemDateTime() method. This returns the current system dateTime as a type of utcDateTime, and there is NO timezone offset applied to the data.

The next line in the code simply shows the time displayed in an infolog. The use of the datetime2str built in function is shown as well to convert the utcDateTime type into a string for the infolog to use.

The next set of code is used to retrieve the current system datetime value, and apply the central timezone offset to the retrieved value:

This forces the date to be converted into Central Time zone.

NOTE: If it is desired to be converted based on where the user currently resides, the following code could be substituted:

The next set of code shows how we apply the timezone offset for the Eastern timezone.

This is as expected. Here is where it gets interesting however. What if it is desired to convert the above New York time to the Microsoft headquarters timezone in Redmond Washington? One would think that the following code would work:

However, this is incorrect. This code will apply the timezone offset as though the NYDateTime value is considered to be in GMT, which is it not. The correct code would be to take the NYDateTime value, strip off the timezone offset, and then apply the new timezone value to the GMT timezone. The code to do that is the following:

At this point, the offset value is applied correctly, and the desired information is retrieved.

Here is the output of the above job being run:

Info        Message (11:05:12 am) Current system datetime in GMT: 10/6/2014 04:05:12 pm

Info        Message (11:05:12 am) Current system datetime in my timezone: 10/6/2014 11:05:12 am

Info        Message (11:05:12 am) Current system datetime in NY timezone: 10/6/2014 12:05:12 pm

Info        Message (11:05:12 am) NY datetime in MS timezone (incorrect): 10/6/2014 05:05:12 am

Info        Message (11:05:12 am) NY datetime in MS timezone: 10/6/2014 09:05:12 am

For more information on the DateTimeUtil class, please see the following:

You can also view my post on working with utcDateTime fields in select statements.


Related Posts



  1. Working with utcDateTime Fields in Select Statements in Dynamics AX 2012 | Stoneridge Software Inc - […] See my previous post for more on working with utcDateTime functionality. […]

Submit a Comment

Your email address will not be published. Required fields are marked *

Upcoming Events


01sep10:00 am10:30 amEnsuring Quality and Compliance for Batch Manufacturers in Life Sciences

01sep12:00 pm12:30 pmIs it Worth It to Move to the Cloud? A Look at Considerations for Current Agribusinesses Using Dynamics GP

01sep2:00 pm2:45 pmWhat’s New in Dynamics 365 Finance and Supply Chain

09sep11:00 am12:00 pmConfab Live with Stoneridge – Data Strategy and Reporting – Mining Decision Making Insights

15sep10:00 am11:00 amSolving the Biggest Challenges in Agribusiness Through Innovation and Technology

22sep12:00 am12:30 pmSimplifying Payroll and HR Management with ADP Workforce Now

22sep10:00 am10:30 amStreamlining Batch Manufacturing with Technology

22sep2:00 pm2:30 pmProcess Automation for Microsoft Dynamics D365 for Business Central, Finance and Operations and GP

23sep11:00 am12:00 pmConfab LIVE with Stoneridge - Riding the Wave 2 Release – Key Features Coming to Dynamics 365 this October

29sep10:00 am11:00 amTop Five Reasons Why NOW is the Right Time to Move from Salesforce to Dynamics 365 Customer Engagement

29sep12:00 pm12:45 pmUnderstanding Job Costing and Tax Management in Business Central

29sep2:00 pm3:00 pmDigitalizing Horticulture & Agriculture - How to Sell Plants Online and Simplify Business Management

30sep12:00 pm4:00 pmSecurity and Permissions Training for D365 Business Central or Dynamics NAV


06oct10:00 am10:30 amPreview of D365 Business Central Fall Release Features and Functionality

06oct12:00 pm12:30 pmInsider's Guide to New Features Available in the Fall Release of D365 Finance and Supply Chain

07oct11:00 am12:00 pmConfab LIVE with Stoneridge - Dataverse and Dynamics in Review – Let’s Get Technical

21oct11:00 am12:00 pmConfab LIVE with Stoneridge - Dataverse and Dynamics in Review – Let’s Get Functional

26oct(oct 26)9:00 am28(oct 28)5:00 pmStoneridge Connect Leadership and Community Conference

About Stoneridge
Stoneridge Software is a unique Microsoft Gold Partner, with emphasis on partner. With specialties in Microsoft Dynamics 365, Microsoft Dynamics AX, Microsoft Dynamics NAV, Microsoft Dynamics GP and Microsoft Dynamics CRM, we focus on attracting the most knowledgeable experts in the field to our team, and prioritize delivering stellar solutions with maximum impact for your business. At Stoneridge, we are deeply committed to your results. Each engagement is met with a dedicated team, ready to provide thorough, tailored, and expert service. Based in Minnesota, we intentionally “step into your shoes,” wherever you are. We focus on what you care about, and develop trusting, long-term relationships with our clients.

Subscribe To Our Blog

Sign up to get periodic updates on the latest posts.

Thank you for subscribing!