ManagementDateTimeConverter.ToDmtfDateTime Method (DateTime)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Converts a given DateTime to DMTF datetime format.

Namespace:   System.Management
Assembly:  System.Management (in System.Management.dll)

Public Shared Function ToDmtfDateTime (
	date As Date
) As String

Parameters

date
Type: System.DateTime

A DateTime representing the datetime to be converted to DMTF datetime.

Return Value

Type: System.String

A string that represents the DMTF datetime for the given DateTime.

Date and time in WMI is represented in DMTF datetime format. This format is explained in WMI SDK documentation. The DMTF datetime string represented will be with respect to the UTC offset of the current time zone. The lowest precision in DMTF is microseconds; in DateTime, the lowest precision is Ticks, which are equivalent to 100 nanoseconds. During conversion, Ticks are converted to microseconds and rounded off to the nearest microsecond.

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.

The following example converts a given DateTime to DMTF datetime format.

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

.NET Framework
Available since 1.1
Return to top
Show: