Converts the datetime string in IMAP4 format into DateTime value.

Parameters

dateTimeString

The datetime string in IMAP4 format (can contain: date; date and time; date, time, and timezone).

Return Value

The DateTime value representing the parsed IMA4 datetime string, or MinValue if the specified datetime string could not be parsed.

Remarks

The returned date is in UTC (GMT) time. To convert it into local time, the developer can use ToLocalTime method.

Exceptions

Example

This sample parses a few IMAP4 datetime strings into DateTime structures and prints the results as UTC time and local time.

[C#]
using System;
using MailBee;
using MailBee.ImapMail;

class Sample
{
    static void Main(string[] args)
    {
        DateTime dt;
        string dtString;

        dtString = "08-Sep-2004 13:47:32 -0400";

        Console.WriteLine(dtString);
        dt = ImapUtils.GetDateTimeFromImapDate(dtString);
        Console.WriteLine("UTC time: " + dt);
        Console.WriteLine("Local time: " + dt.ToLocalTime());
        Console.WriteLine();

        dtString = "20-May-2005 00:47:32";

        Console.WriteLine(dtString);
        dt = ImapUtils.GetDateTimeFromImapDate(dtString);
        Console.WriteLine("UTC time: " + dt);
        Console.WriteLine("Local time: " + dt.ToLocalTime());
        Console.WriteLine();

        dtString = "31-Jan-2005";

        Console.WriteLine(dtString);
        dt = ImapUtils.GetDateTimeFromImapDate(dtString);
        Console.WriteLine("UTC time: " + dt);
        Console.WriteLine("Local time: " + dt.ToLocalTime());
    }
}

[Visual Basic]
Imports System
Imports MailBee
Imports MailBee.ImapMail

Module Sample
    Sub Main(ByVal args As String())
        Dim dt As DateTime
        Dim dtString As String

        dtString = "08-Sep-2004 13:47:32 -0400"

        Console.WriteLine(dtString)
        dt = ImapUtils.GetDateTimeFromImapDate(dtString)
        Console.WriteLine("UTC time: " & dt)
        Console.WriteLine("Local time: " & dt.ToLocalTime())
        Console.WriteLine()

        dtString = "20-May-2005 00:47:32"

        Console.WriteLine(dtString)
        dt = ImapUtils.GetDateTimeFromImapDate(dtString)
        Console.WriteLine("UTC time: " & dt)
        Console.WriteLine("Local time: " & dt.ToLocalTime())
        Console.WriteLine()

        dtString = "31-Jan-2005"

        Console.WriteLine(dtString)
        dt = ImapUtils.GetDateTimeFromImapDate(dtString)
        Console.WriteLine("UTC time: " & dt)
        Console.WriteLine("Local time: " & dt.ToLocalTime())
    End Sub
End Module

See Also

ImapUtils Class | MailBee.ImapMail Namespace

---