C

Get the Email Received Date/Time

See more Email Object Examples

Get's the date/time from the topmost Received header. The date/time of when you received an email may be different than the date/time stored in the Date header field, which if truthful, is the date when the email was sent.

The Received header field will look something like this:

Received: from mail.example.com (mail.example.com [99.255.255.99])
 by inbound-smtp.us-west-2.amazonaws.com with SMTP id 72ma443vs1g0o6vqd8erojkpss35s0dt32h323o1
 for admin@chilkatsoft.com;
 Wed, 25 Jul 2018 08:04:23 +0000 (UTC)

The date/time is the final part delimited by a semicolon. C

#include <C_CkEmail.h>
#include <C_CkStringBuilder.h>
#include <C_CkStringTable.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkEmail email;
    HCkStringBuilder sb;
    int numReplaced;
    HCkStringTable st;

    success = FALSE;

    email = CkEmail_Create();

    success = CkEmail_LoadEml(email,"qa_data/eml/p.eml");
    if (success != TRUE) {
        printf("%s\n",CkEmail_lastErrorText(email));
        CkEmail_Dispose(email);
        return;
    }

    sb = CkStringBuilder_Create();
    CkStringBuilder_Append(sb,CkEmail_getHeaderField(email,"Received"));

    // Replace semicolons with CRLF's
    numReplaced = CkStringBuilder_Replace(sb,";","\r\n");

    st = CkStringTable_Create();
    CkStringTable_AppendFromSb(st,sb);

    if (CkStringTable_getCount(st) == 0) {
        printf("Should have at least one line..\n");
        CkEmail_Dispose(email);
        CkStringBuilder_Dispose(sb);
        CkStringTable_Dispose(st);
        return;
    }

    // The date/time string is the last line in the string table.
    CkStringBuilder_SetString(sb,CkStringTable_stringAt(st,CkStringTable_getCount(st) - 1));
    CkStringBuilder_Trim(sb);

    printf("Received date/time = %s\n",CkStringBuilder_getAsString(sb));


    CkEmail_Dispose(email);
    CkStringBuilder_Dispose(sb);
    CkStringTable_Dispose(st);

    }