{"id":1573,"date":"2014-03-07T07:00:00","date_gmt":"2014-03-07T07:00:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/oldnewthing\/2014\/03\/07\/converting-from-a-utc-based-systemtime-directly-to-a-local-time-based-systemtime\/"},"modified":"2014-03-07T07:00:00","modified_gmt":"2014-03-07T07:00:00","slug":"converting-from-a-utc-based-systemtime-directly-to-a-local-time-based-systemtime","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/oldnewthing\/20140307-00\/?p=1573","title":{"rendered":"Converting from a UTC-based SYSTEMTIME directly to a local-time-based SYSTEMTIME"},"content":{"rendered":"

Last year, I presented this commutative diagram<\/p>\n

\n
A 2-by-2 grid of boxes. The top row is labeled FILE­TIME; the bottom row is labeled SYSTEM­TIME. The first column is labeled UTC; the second column is labeled Local. The upper left box is labeled Get­System­Time­As­File­Time. There is an outgoing arrow to the right labeled File­Time­To­Local­File­Time leading to the box in the second column labeled None. There is an outgoing arrow downward labeled File­Time­To­System­Time leading to the box in the second row, first column, labeled Get­System­Time. From the box in the upper right corner labeled None, there is an outgoing arrow downward labeled File­Time­To­System­Time leading to the box in the second row, second column, labeled Get­Local­Time. <\/div>\n
UTC<\/div>\n
Local<\/div>\n
FILE­TIME<\/div>\n
Get­System­Time­As­File­Time<\/div>\n
File­Time­To­Local­File­Time<\/div>\n
(None)<\/div>\n
File­Time­To­System­Time<\/div>\n
File­Time­To­System­Time<\/div>\n
SYSTEM­TIME<\/div>\n
Get­System­Time<\/div>\n
Get­Local­Time<\/div>\n
\n
→<\/div>\n
↓<\/div>\n
↓<\/div>\n<\/p><\/div>\n<\/p><\/div>\n

I claimed that there was no function to complete the commutative diagram by connecting the bottom two boxes<\/a>.\n I was wrong, but I’m going to try to get off on a technicality.\n You can connect the two boxes by calling System­Time­To­Tz­Specific­Local­Time<\/code> with NULL<\/code> as the time zone parameter, which means “Use the current time zone.”<\/p>\n

\n
The same diagram as above, but there is a new arrow connecting Get­System­Time to Get­Local­Time labeled System­Time­To­Tz­Specific­Local­Time. <\/div>\n
UTC<\/div>\n
Local<\/div>\n
FILE­TIME<\/div>\n
Get­System­Time­As­File­Time<\/div>\n
File­Time­To­Local­File­Time<\/div>\n
(None)<\/div>\n
File­Time­To­System­Time<\/div>\n
File­Time­To­System­Time<\/div>\n
SYSTEM­TIME<\/div>\n
Get­System­Time<\/div>\n
System­Time­To­Tz­Specific­Local­Time<\/div>\n
Get­Local­Time<\/div>\n
\n
→<\/div>\n
↓<\/div>\n
↓<\/div>\n
→<\/div>\n<\/p><\/div>\n<\/p><\/div>\n

This works here because the time being converted always refers to the current time.\n Here comes the technicality.\n This technique doesn’t work in general because System­Time­To­Tz­Specific­Local­Time<\/code> uses the time zone in effect at the time being converted<\/i>, whereas the File­Time­To­Local­File­Time<\/code> function uses the time zone in effect right now<\/i>. Furthermore, it doesn’t take into account changes in daylight savings rules that may have historically been different from the current set of rules<\/a>. (Though this is easily repaired by switching to System­Time­To­Tz­Specific­Local­Time­Ex<\/code>.) The trick works here because the time we are converting is right now<\/i>.\n In other words, the more general diagram does not commute. Instead, it looks more like this:<\/p>\n

\n
Same as before, but this time the boxes are unlabeled, and the bottom right box is split in two. The inbound arrow from the left goes to one box and the inbound arrow from the top goes to another box. The two halves of the split boxes are marked as not equal. <\/div>\n
UTC<\/div>\n
Local<\/div>\n
FILE­TIME<\/div>\n
<\/div>\n
File­Time­To­Local­File­Time<\/div>\n
<\/div>\n
File­Time­To­System­Time<\/div>\n
File­Time­To­System­Time<\/div>\n
SYSTEM­TIME<\/div>\n
<\/div>\n
System­Time­To­Tz­Specific­Local­Time­Ex<\/div>\n
<\/div>\n
≠ <\/div>\n
<\/div>\n
\n
→<\/div>\n
↓<\/div>\n
↓<\/div>\n
→<\/div>\n<\/p><\/div>\n<\/p><\/div>\n

This is why the documentation for File­Time­To­Local­File­Time<\/code> tells you that if you want to get from the upper left corner to the upper right corner while accounting for daylight saving time relative to the time being converted, then you need to take the long way around.<\/p>\n

So what we have is not so much a commutative diagram as a something like covering space: If you start at any box and travel around the diagram, you won’t necessarily end up where you started. Let’s start at the upper left corner for the sake of example. <\/p>\n

\n
Back to the four-box diagram, with empty boxes. The arrows follow a clockwise path. From the upper left, we go to the upper right via File­Time­To­Local­File­Time, then to the bottom right via File­Time­To­System­Time, then to the bottom left via Tz­Specific­Local­Time­To­System­Time­Ex, then back to the upper left via Local­File­Time­To­File­Time. <\/div>\n
UTC<\/div>\n
Local<\/div>\n
FILE­TIME<\/div>\n
<\/div>\n
File­Time­To­Local­File­Time<\/div>\n
<\/div>\n
System­Time­To­File­Time<\/div>\n
File­Time­To­System­Time<\/div>\n
SYSTEM­TIME<\/div>\n
<\/div>\n
Tz­Specific­Local­Time­To­System­Time<\/div>\n
<\/div>\n
\n
→<\/div>\n
↓<\/div>\n
↓<\/div>\n
→<\/div>\n<\/p><\/div>\n<\/p><\/div>\n

When you return to the upper left box, you might end up somewhere else, probably an hour ahead of or behind where you started. Each time you take a trip around the diagram, you drift another hour further away. Well, until you hit another daylight saving time changeover point. <\/p>\n","protected":false},"excerpt":{"rendered":"

Last year, I presented this commutative diagram A 2-by-2 grid of boxes. The top row is labeled FILE­TIME; the bottom row is labeled SYSTEM­TIME. The first column is labeled UTC; the second column is labeled Local. The upper left box is labeled Get­System­Time­As­File­Time. There is an outgoing arrow to the right labeled File­Time­To­Local­File­Time leading to […]<\/p>\n","protected":false},"author":1069,"featured_media":111744,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[25,108],"class_list":["post-1573","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-oldnewthing","tag-code","tag-time"],"acf":[],"blog_post_summary":"

Last year, I presented this commutative diagram A 2-by-2 grid of boxes. The top row is labeled FILE­TIME; the bottom row is labeled SYSTEM­TIME. The first column is labeled UTC; the second column is labeled Local. The upper left box is labeled Get­System­Time­As­File­Time. There is an outgoing arrow to the right labeled File­Time­To­Local­File­Time leading to […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/1573","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/users\/1069"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/comments?post=1573"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/1573\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/media\/111744"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/media?parent=1573"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/categories?post=1573"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/tags?post=1573"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}