ManagementDateTimeConverter.ToDateTime Method (System.Management)

Switch View :
Classic
Lightweight
ScriptFree
.NET Framework Class Library
ManagementDateTimeConverter.ToDateTime Method

Converts a given DMTF datetime to DateTime. The returned DateTime will be in the current time zone of the system.

Namespace:  System.Management
Assembly:  System.Management (in System.Management.dll)
Syntax
Visual Basic
Public Shared Function ToDateTime ( _
	dmtfDate As String _
) As DateTime
C#
public static DateTime ToDateTime(
	string dmtfDate
)
Visual C++
public:
static DateTime ToDateTime(
	String^ dmtfDate
)
F#
static member ToDateTime : 
        dmtfDate:string -> DateTime

Parameters

dmtfDate
Type: System.String
A string representing the datetime in DMTF format.

Return Value

Type: System.DateTime
A DateTime that represents the given DMTF datetime.
Remarks

Date and time in WMI is represented in DMTF datetime format. This format is explained in WMI SDK documentation. A DMTF datetime string has an UTC offset which this datetime string represents. During conversion to DateTime, the UTC offset is used to convert the date to the current time zone. According to DMTF format, a particular field can be represented by the character '*'. This will be converted to the MinValue value of this field that can be represented in DateTime.

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Examples

The following example converts a DMTF datetime string into a DateTime.

Visual Basic

Imports System
Imports System.Management

'The sample below demonstrates the various conversions
' that can be done using ManagementDateTimeConverter class    
Class Sample_ManagementClass
    Public Overloads Shared Function Main(ByVal args() As String) _
        As Integer
        Dim dmtfDate As String = "20020408141835.999999-420"
        Dim dmtfTimeInterval As String = "00000010122532:123456:000"

        'Converting DMTF datetime and intervals to System.DateTime
        Dim dt As DateTime = _
            ManagementDateTimeConverter.ToDateTime(dmtfDate)

        'Converting System.DateTime to DMTF datetime
        dmtfDate = _
            ManagementDateTimeConverter.ToDmtfDateTime(DateTime.Now)

        ' Converting DMTF timeinterval to System.TimeSpan
        Dim tsRet As System.TimeSpan = _
            ManagementDateTimeConverter.ToTimeSpan(dmtfTimeInterval)

        'Converting System.TimeSpan to DMTF time interval format
        Dim ts As System.TimeSpan = _
            New System.TimeSpan(10, 12, 25, 32, 456)
        Dim dmtfTimeInt As String
        dmtfTimeInt = _
            ManagementDateTimeConverter.ToDmtfTimeInterval(ts)

        Return 0
    End Function
End Class
C#

using System;
using System.Management;

// The sample below demonstrates the various conversions
// that can be done using ManagementDateTimeConverter class    
class Sample_ManagementDateTimeConverterClass
{
    public static int Main(string[] args) 
    {
        string dmtfDate = "20020408141835.999999-420";
        string dmtfTimeInterval = "00000010122532:123456:000";

        // Converting DMTF datetime to System.DateTime
        DateTime dt = 
            ManagementDateTimeConverter.ToDateTime(dmtfDate);

        // Converting System.DateTime to DMTF datetime
        string dmtfDateTime = 
            ManagementDateTimeConverter.ToDmtfDateTime(DateTime.Now);

        // Converting DMTF time interval to System.TimeSpan
        System.TimeSpan tsRet = 
            ManagementDateTimeConverter.ToTimeSpan(dmtfTimeInterval);

        //Converting System.TimeSpan to DMTF time interval format
        System.TimeSpan ts = 
            new System.TimeSpan(10,12,25,32,456);
        string dmtfTimeInt  = 
            ManagementDateTimeConverter.ToDmtfTimeInterval(ts);

        return 0;
    }
}
Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
.NET Framework Security
Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
See Also

Reference

ManagementDateTimeConverter Class
System.Management Namespace