Unicode C

Get and Set the Email Date (Local Timezone)

Demonstrates the Chilkat Email.LocalDateStr property, which is the date/time from the Date header returned in the local timezone in RFC822 string form (for example, Fri, 10 Jul 2026 15:15:30 -0500). Setting this property updates the email's Date header. Use LocalDate when a native local date/time value is preferred. This example sets the date and reads it back.

Background: An RFC822 date ends with a timezone: either GMT (equivalently +0000) or a signed offset like -0500, which means five hours behind UTC. The trailing offset is the only difference between the local and GMT views — they describe the identical moment in time. LocalDateStr presents the Date header using the running computer's local offset, while EmailDateStr presents it in GMT.

Chilkat Unicode C Downloads

Download Chilkat for Unicode C

Unicode C

#include <C_CkEmailW.h>

void ChilkatSample(void)
    {
    HCkEmailW email;

    //  Demonstrates the Email.LocalDateStr property.
    //  This is the date/time from the Date header returned in the local timezone,
    //  in RFC822 string form.  Setting it updates the email's Date header.

    email = CkEmailW_Create();

    CkEmailW_putLocalDateStr(email,L"Fri, 10 Jul 2026 15:15:30 -0500");

    wprintf(L"LocalDateStr = %s\n",CkEmailW_localDateStr(email));


    CkEmailW_Dispose(email);

    }