Description of updates to APIs that enable Windows-based applications to retrieve historically accurate time stamps

Article ID: 960417 – Last Review: January 26, 2009 – Revision: 2.0

Description of updates to APIs that enable Windows-based applications to retrieve historically accurate time stamps

Hotfix Hotfix Download Available
View and request hotfix downloads

On This Page

INTRODUCTION

This article describes updates to APIs that enable Windows-based applications to retrieve historically accurate time stamps.

MORE INFORMATION

What time functions are updated?

The following time functions are updated by this update:

  • SystemTimeToTzSpecificLocalTime() Converts a time in Coordinated Universal Time (UTC) to a specified time zone’s corresponding local time.
  • TzSpecificTimeToSystemTime() Converts a local time to a time in Coordinated Universal Time (UTC).

Note The functions that are listed here use a TIME_ZONE_INFORMATION structure that specifies the START DATE and the END DATE for daylight saving time (DST). By default, the current DST rules are used when no such structure is provided.

When to use these functions in an application

Most date and time stamps that are created and displayed in Windows and in many applications are stored as UTC. Then, they are rendered in local time by using system APIs. Examples of these include Windows file time stamps, Outlook sent and received dates, and event logging time stamps.

Not all built-in, Windows-based applications use these newly updated APIs. However, they are available to all applications, including third-party applications. These functions are useful in many scenarios, such as a user auditing scenario in which the ability to use DST rules for previous years on a current Windows service pack is important.

Generally, if an application requires historically accurate time stamps, these functions should be used.

How to use these functions in an application

For information about syntax, parameters, return value, and examples on how to use these functions in an application, please visit the following Microsoft Developer Network (MSDN) Web sites:

SystemTimeToTzSpecificLocalTime Function

http://msdn.microsoft.com/en-us/library/ms724949(VS.85).aspx (http://msdn.microsoft.com/en-us/library/ms724949(VS.85).aspx)

TzSpecificLocalTimeToSystemTime Function

http://msdn.microsoft.com/en-us/library/ms725485(VS.85).aspx (http://msdn.microsoft.com/en-us/library/ms725485(VS.85).aspx)

Note This article supersedes article 944340, which describes an earlier version of these APIs. This update improves the performance of the functions, and enables historically accurate time-stamp lookup functionality that was introduced in 944340.

This update applies to the following Windows operating systems:

  • Windows XP Service Pack 3 (SP3)
  • Windows Server 2003 Service Pack 2 (SP2)
  • Windows Vista Service Pack 1 (SP1)
  • Windows Server 2008

UPDATE INFORMATION

Hotfix information for Windows XP

A supported hotfix is available from Microsoft. However, this hotfix is intended to correct only the problem that is described in this article. Apply this hotfix only to systems that are experiencing this specific problem.

If the hotfix is available for download, there is a Hotfix download available section at the top of this Knowledge Base article. If this section does not appear, submit a request to Microsoft Customer Service and Support to obtain the hotfix.

Note If additional issues occur or if any troubleshooting is required, you might have to create a separate service request. The usual support costs will apply to additional support questions and issues that do not qualify for this specific hotfix. For a complete list of Microsoft Customer Service and Support telephone numbers or to create a separate service request, visit the following Microsoft Web site:

http://support.microsoft.com/contactus/?ws=support (http://support.microsoft.com/contactus/?ws=support)

Note The Hotfix download available form displays the languages for which the hotfix is available. If you do not see your language, it is because a hotfix is not available for that language.

Prerequisites

To apply this hotfix, you must have Windows XP SP3 installed.

For more information, click the following article number to view the article in the Microsoft Knowledge Base:

322389  (/Feedback.aspx?kbNumber=322389/ ) How to obtain the latest Windows XP service pack

Restart requirement

You have to restart the computer after you apply this hotfix.

Hotfix replacement information

This hotfix replaces the following hotfix:

For more information, click the following article number to view the article in the Microsoft Knowledge Base:

944340  (/Feedback.aspx?kbNumber=944340/ ) The time stamps are incorrect after you apply update 928388 and then change the time settings to a year that is earlier than 2007 in Windows XP and in Windows Server 2003

File information

The English version of this hotfix has the file attributes (or later file attributes) that are listed in the following table. The dates and times for these files are listed in Coordinated Universal Time (UTC). When you view the file information, it is converted to local time. To find the difference between UTC and local time, use the Time Zone tab in the Date and Time item in Control Panel.

Windows XP with Service Pack 3, x86-based versions
Collapse this tableExpand this table
File name File version File size Date Time Platform
Kernel32.dll 5.1.2600.5719 991,744 03-Dec-2008 10:32 x86

Hotfix information for Windows Server 2003

A supported hotfix is available from Microsoft. However, this hotfix is intended to correct only the problem that is described in this article. Apply this hotfix only to systems that are experiencing the problem described in this article. This hotfix might receive additional testing. Therefore, if you are not severely affected by this problem, we recommend that you wait for the next software update that contains this hotfix.

If the hotfix is available for download, there is a Hotfix download available section at the top of this Knowledge Base article. If this section does not appear, contact Microsoft Customer Service and Support to obtain the hotfix.

Note If additional issues occur or if any troubleshooting is required, you might have to create a separate service request. The usual support costs will apply to additional support questions and issues that do not qualify for this specific hotfix. For a complete list of Microsoft Customer Service and Support telephone numbers or to create a separate service request, visit the following Microsoft Web site:

http://support.microsoft.com/contactus/?ws=support (http://support.microsoft.com/contactus/?ws=support)

Note The Hotfix download available form displays the languages for which the hotfix is available. If you do not see your language, it is because a hotfix is not available for that language.

Prerequisites

To apply this hotfix, you must have the following installed:

  • Windows Server 2003 SP2

    For more information, click the following article number to view the article in the Microsoft Knowledge Base:

    889100  (/Feedback.aspx?kbNumber=889100/ ) How to obtain the latest service pack for Windows Server 2003
  • The 944340 hotfix

    For more information, click the following article number to view the article in the Microsoft Knowledge Base:

    944340  (/Feedback.aspx?kbNumber=944340/ ) The time stamps are incorrect after you apply update 928388 and then change the time settings to a year that is earlier than 2007 in Windows XP and in Windows Server 2003

Restart requirement

You have to restart the computer after you apply this hotfix.

Hotfix replacement information

This hotfix replaces the following hotfix:

For more information, click the following article number to view the article in the Microsoft Knowledge Base:

944340  (/Feedback.aspx?kbNumber=944340/ ) The time stamps are incorrect after you apply update 928388 and then change the time settings to a year that is earlier than 2007 in Windows XP and in Windows Server 2003

File information

The English version of this hotfix has the file attributes (or later file attributes) that are listed in the following table. The dates and times for these files are listed in Coordinated Universal Time (UTC). When you view the file information, it is converted to local time. To find the difference between UTC and local time, use the Time Zone tab in the Date and Time item in Control Panel.

Windows Server 2003 with Service Pack 2, x86-based versions
Collapse this tableExpand this table
File name File version File size Date Time Platform
Kernel32.dll 5.2.3790.4417 1,042,944 25-Nov-2008 18:25 x86
Windows Server 2003 with Service Pack 2, Itanium-based versions
Collapse this tableExpand this table
File name File version File size Date Time Platform SP requirement Service branch
Kernel32.dll 5.2.3790.4417 1,982,976 25-Nov-2008 16:29 IA-64 SP2 Not Applicable
Wkernel32.dll 5.2.3790.4417 1,014,784 25-Nov-2008 16:29 x86 SP2 WOW
Windows Server 2003 with Service Pack 2, x64-based versions
Collapse this tableExpand this table
File name File version File size Date Time Platform SP requirement Service branch
Kernel32.dll 5.2.3790.4417 1,513,984 25-Nov-2008 16:30 x64 SP2 Not Applicable
Wkernel32.dll 5.2.3790.4417 1,014,784 25-Nov-2008 16:30 x86 SP2 WOW

Hotfix information for Windows Vista and for Windows Server 2008

A supported hotfix is available from Microsoft. However, this hotfix is intended to correct only the problem that is described in this article. Apply this hotfix only to systems that are experiencing the problem described in this article. This hotfix might receive additional testing. Therefore, if you are not severely affected by this problem, we recommend that you wait for the next software update that contains this hotfix.

If the hotfix is available for download, there is a Hotfix download available section at the top of this Knowledge Base article. If this section does not appear, contact Microsoft Customer Service and Support to obtain the hotfix.

Note If additional issues occur or if any troubleshooting is required, you might have to create a separate service request. The usual support costs will apply to additional support questions and issues that do not qualify for this specific hotfix. For a complete list of Microsoft Customer Service and Support telephone numbers or to create a separate service request, visit the following Microsoft Web site:

http://support.microsoft.com/contactus/?ws=support (http://support.microsoft.com/contactus/?ws=support)

Note The Hotfix download available form displays the languages for which the hotfix is available. If you do not see your language, it is because a hotfix is not available for that language.

Prerequisites

To apply this hotfix on Windows Vista-based computer, you must have Windows Vista SP1 installed.

For more information, click the following article number to view the article in the Microsoft Knowledge Base:

935791  (/Feedback.aspx?kbNumber=935791/ ) How to obtain the latest Windows Vista service pack

No prerequisites are required for Windows Server 2008-based computers.

Restart requirement

You have to restart the computer after you apply this hotfix.

Hotfix replacement information

This hotfix does not replace a previously released hotfix.

File information

The English version of this hotfix has the file attributes (or later file attributes) that are listed in the following table. The dates and times for these files are listed in Coordinated Universal Time (UTC). When you view the file information, it is converted to local time. To find the difference between UTC and local time, use the Time Zone tab in the Date and Time item in Control Panel.

Windows Vista and Windows Server 2008 file information notes

The .manifest files and the .mum files that are installed in each environment are listed separately in the Additional file information for Windows Server 2008 and for Windows Vista section. These files and their associated .cat (security catalog) files are critical to maintaining the state of the updated component. The .cat files are signed with a Microsoft digital signature. The attributes of these security files are not listed.

For all supported x86-based versions of Windows Server 2008 and of Windows Vista
Collapse this tableExpand this table
File name File version File size Date Time Platform
Kernel32.dll 6.0.6001.22315 890,368 22-Nov-2008 04:31 x86
For all supported x64-based versions of Windows Server 2008 and of Windows Vista
Collapse this tableExpand this table
File name File version File size Date Time Platform
Kernel32.dll 6.0.6001.22315 1,214,976 22-Nov-2008 05:51 x64
Kernel32.dll 6.0.6001.22315 857,600 22-Nov-2008 04:29 x86
For all supported IA-64-based versions of Windows Server 2008
Collapse this tableExpand this table
File name File version File size Date Time Platform
Kernel32.dll 6.0.6001.22315 2,182,656 22-Nov-2008 05:41 IA-64
Kernel32.dll 6.0.6001.22315 857,600 22-Nov-2008 04:29 x86

STATUS

Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the Applies to section.

MORE INFORMATION

Additional file information for Windows Server 2008 and Windows Vista

Additional files for all supported x86-based versions of Windows Server 2008 and of Windows Vista
Collapse this tableExpand this table
File name Package_for_kb960417_client_1~31bf3856ad364e35~x86~~6.0.1.0.mum
File version Not Applicable
File size 1,367
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name Package_for_kb960417_client~31bf3856ad364e35~x86~~6.0.1.0.mum
File version Not Applicable
File size 1,431
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name Package_for_kb960417_sc_0~31bf3856ad364e35~x86~~6.0.1.0.mum
File version Not Applicable
File size 1,421
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name Package_for_kb960417_sc~31bf3856ad364e35~x86~~6.0.1.0.mum
File version Not Applicable
File size 1,423
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name Package_for_kb960417_server_0~31bf3856ad364e35~x86~~6.0.1.0.mum
File version Not Applicable
File size 1,425
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name Package_for_kb960417_server~31bf3856ad364e35~x86~~6.0.1.0.mum
File version Not Applicable
File size 1,431
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name Package_for_kb960417_winpesrv_0~31bf3856ad364e35~x86~~6.0.1.0.mum
File version Not Applicable
File size 1,422
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name Package_for_kb960417_winpesrv~31bf3856ad364e35~x86~~6.0.1.0.mum
File version Not Applicable
File size 1,429
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name X86_a08d3390a3f795eb9640490dd79afb04_31bf3856ad364e35_6.0.6001.22315_none_f21fc1d1806134de.manifest
File version Not Applicable
File size 696
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name X86_microsoft-windows-kernel32_31bf3856ad364e35_6.0.6001.22315_none_9441b75e6f6cbd6a.manifest
File version Not Applicable
File size 4,517
Date (UTC) 22-Nov-2008
Time (UTC) 05:22
Additional files for all supported x64-based versions of Windows Server 2008 and of Windows Vista
Collapse this tableExpand this table
File name Amd64_27eb8e1c173364810c3681aee0ca9bd3_31bf3856ad364e35_6.0.6001.22315_none_da5b04b3dfced239.manifest
File version Not Applicable
File size 1,042
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name Amd64_3fa40fbd70d0e50157ad511837ce726c_31bf3856ad364e35_6.0.6001.22315_none_04b1a016e4974ac3.manifest
File version Not Applicable
File size 700
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name Amd64_microsoft-windows-kernel32_31bf3856ad364e35_6.0.6001.22315_none_f06052e227ca2ea0.manifest
File version Not Applicable
File size 4,523
Date (UTC) 22-Nov-2008
Time (UTC) 06:17
File name Package_for_kb960417_client_1~31bf3856ad364e35~amd64~~6.0.1.0.mum
File version Not Applicable
File size 1,375
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name Package_for_kb960417_client~31bf3856ad364e35~amd64~~6.0.1.0.mum
File version Not Applicable
File size 1,439
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name Package_for_kb960417_sc_0~31bf3856ad364e35~amd64~~6.0.1.0.mum
File version Not Applicable
File size 1,429
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name Package_for_kb960417_sc~31bf3856ad364e35~amd64~~6.0.1.0.mum
File version Not Applicable
File size 1,431
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name Package_for_kb960417_server_0~31bf3856ad364e35~amd64~~6.0.1.0.mum
File version Not Applicable
File size 1,433
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name Package_for_kb960417_server~31bf3856ad364e35~amd64~~6.0.1.0.mum
File version Not Applicable
File size 1,439
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name Package_for_kb960417_winpesrv_0~31bf3856ad364e35~amd64~~6.0.1.0.mum
File version Not Applicable
File size 1,430
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name Package_for_kb960417_winpesrv~31bf3856ad364e35~amd64~~6.0.1.0.mum
File version Not Applicable
File size 1,437
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name Wow64_microsoft-windows-kernel32_31bf3856ad364e35_6.0.6001.22315_none_fab4fd345c2af09b.manifest
File version Not Applicable
File size 5,321
Date (UTC) 22-Nov-2008
Time (UTC) 05:12
Additional files for all supported IA-64-based versions of Windows Server 2008
Collapse this tableExpand this table
File name Ia64_393afc3dbfbb43f13f813ccf7a74b204_31bf3856ad364e35_6.0.6001.22315_none_93731857b2f149f7.manifest
File version Not Applicable
File size 1,040
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name Ia64_a1cbdf62cfc8fddbdd54e27cc15736a0_31bf3856ad364e35_6.0.6001.22315_none_2b945e30eba4300a.manifest
File version Not Applicable
File size 698
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name Ia64_microsoft-windows-kernel32_31bf3856ad364e35_6.0.6001.22315_none_94435b546f6ac666.manifest
File version Not Applicable
File size 4,520
Date (UTC) 22-Nov-2008
Time (UTC) 06:07
File name Package_for_kb960417_sc_0~31bf3856ad364e35~ia64~~6.0.1.0.mum
File version Not Applicable
File size 1,425
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name Package_for_kb960417_sc~31bf3856ad364e35~ia64~~6.0.1.0.mum
File version Not Applicable
File size 1,426
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name Package_for_kb960417_server_0~31bf3856ad364e35~ia64~~6.0.1.0.mum
File version Not Applicable
File size 1,429
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name Package_for_kb960417_server~31bf3856ad364e35~ia64~~6.0.1.0.mum
File version Not Applicable
File size 1,434
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name Package_for_kb960417_winpesrv_0~31bf3856ad364e35~ia64~~6.0.1.0.mum
File version Not Applicable
File size 1,426
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name Package_for_kb960417_winpesrv~31bf3856ad364e35~ia64~~6.0.1.0.mum
File version Not Applicable
File size 1,433
Date (UTC) 24-Nov-2008
Time (UTC) 23:47
File name Wow64_microsoft-windows-kernel32_31bf3856ad364e35_6.0.6001.22315_none_fab4fd345c2af09b.manifest
File version Not Applicable
File size 5,321
Date (UTC) 22-Nov-2008
Time (UTC) 05:12

APPLIES TO
  • Microsoft Windows XP Professional
  • Microsoft Windows XP Home Edition
  • Windows Vista Business
  • Windows Vista Enterprise
  • Windows Vista Home Basic
  • Windows Vista Home Premium
  • Windows Vista Ultimate
  • Windows Vista Business 64-bit Edition
  • Windows Vista Enterprise 64-bit Edition
  • Windows Vista Home Basic 64-bit Edition
  • Windows Vista Home Premium 64-bit Edition
  • Windows Vista Ultimate 64-bit Edition
  • Microsoft Windows Server 2003, Standard Edition (32-bit x86)
  • Microsoft Windows Server 2003, Enterprise Edition (32-bit x86)
  • Microsoft Windows Server 2003, Datacenter Edition (32-bit x86)
  • Microsoft Windows Server 2003, Standard x64 Edition
  • Microsoft Windows Server 2003, Enterprise x64 Edition
  • Microsoft Windows Server 2003, Datacenter x64 Edition
  • Microsoft Windows Server 2003, Enterprise Edition for Itanium-based Systems
  • Microsoft Windows Server 2003, Datacenter Edition for Itanium-Based Systems
  • Windows Server 2008 Standard
  • Windows Server 2008 Enterprise
  • Windows Server 2008 Datacenter
  • Windows Server 2008 Standard without Hyper-V
  • Windows Server 2008 Enterprise without Hyper-V
  • Windows Server 2008 Datacenter without Hyper-V
  • Windows Server 2008 for Itanium-Based Systems
Keywords: 
kbautohotfix kbexpertiseinter kbfix kbbug kbsurveynew kbqfe kbhotfixserver KB960417

 

Microsoft Knowledge Base Article

This article contents is Microsoft Copyrighted material.
Microsoft Corporation. All rights reserved. Terms of Use | Trademarks


You can follow any responses to this entry through the RSS 2.0 feed. You can leave a response, or trackback from your own site.

AddThis Social Bookmark Button

Leave a Reply

*
To prove that you're not a bot, enter this code
Anti-Spam Image