PureBasic

Get and Set the Email Date (UTC/GMT)

Demonstrates the Chilkat Email.EmailDateStr property, which is the date/time from the Date header in the UTC/GMT timezone in RFC822 string form (for example, Fri, 10 Jul 2026 20:15:30 GMT). Setting this property updates the email's Date header. This example sets the date and reads it back.

Background: Every email carries a Date header whose format is defined by the internet message standards (RFC 822 / RFC 5322), looking like Fri, 10 Jul 2026 20:15:30 +0000. This same instant in time can be written relative to GMT/UTC or relative to a local timezone offset. EmailDateStr gives you the GMT/UTC view, while LocalDateStr gives the local-timezone view of the very same header.

Chilkat PureBasic Downloads

Download Chilkat for PureBasic

PureBasic

IncludeFile "CkEmail.pb"

Procedure ChilkatExample()

    ;  Demonstrates the Email.EmailDateStr property.
    ;  This is the date/time from the Date header in the UTC/GMT timezone,
    ;  in RFC822 string form.  Setting it updates the email's Date header.

    email.i = CkEmail::ckCreate()
    If email.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkEmail::setCkEmailDateStr(email, "Fri, 10 Jul 2026 20:15:30 GMT")

    Debug "EmailDateStr = " + CkEmail::ckEmailDateStr(email)


    CkEmail::ckDispose(email)


    ProcedureReturn
EndProcedure