ManagementDateTimeConverter.ToDateTime(String) ManagementDateTimeConverter.ToDateTime(String) ManagementDateTimeConverter.ToDateTime(String) ManagementDateTimeConverter.ToDateTime(String) Method

Definition

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

public:
 static DateTime ToDateTime(System::String ^ dmtfDate);
public static DateTime ToDateTime (string dmtfDate);
static member ToDateTime : string -> DateTime
Public Shared Function ToDateTime (dmtfDate As String) As DateTime

Parameters

dmtfDate
String String String String

A string representing the datetime in DMTF format.

Returns

A DateTime that represents the given DMTF datetime.

Examples

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

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;
    }
}
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

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.

Applies to