HttpRequestHeaderCollection.Date Property

Definition

Namespace:

Windows.Web.Http.Headers

Gets or sets the DateTime object that represents the value of a Date HTTP header on an HTTP request.

public:
 property IReference<DateTime> ^ Date { IReference<DateTime> ^ get(); void set(IReference<DateTime> ^ value); };

IReference<DateTime> Date();

void Date(IReference<DateTime> value);

public System.Nullable<System.DateTimeOffset> Date { get; set; }

var iReference = httpRequestHeaderCollection.date;
httpRequestHeaderCollection.date = iReference;

Public Property Date As Nullable(Of DateTimeOffset)

Property Value

IReference<DateTime>

Nullable<DateTimeOffset>

The object that represents the value of a Date HTTP header on an HTTP request. A null value means that the header is absent.

Remarks

The Date property represents the Date header on an HTTP request message. The Date header is the date and time the message was sent.

Javascript and .NET languages do not use the DateTime object directly. In Javascript a DateTime is projected as a object, and in .NET it is projected as a System.DateTimeOffset. Each language transparently handles the conversion to the granularity and date ranges for the respective language.

In C++, a value has the same granularity as a and supports the date ranges required by Javascript and .NET.

For more detailed information, see the Windows.Foundation.DateTime structure.

The following sample code shows a method to set the Date header on an HttpRequestMessage object using the Date property on the HttpRequestHeaderCollection object.

public void DemonstrateHeaderRequestDate() {
    var request = new HttpRequestMessage();

    // This is not typically set with a string.

    // Set the header with a strong type.
    DateTimeOffset value = DateTimeOffset.UtcNow;
    request.Headers.Date = value;

    // Get the strong type out
    System.Diagnostics.Debug.WriteLine("Date value in ticks: {0}", request.Headers.Date.Value.Ticks);

    // The ToString() is useful for diagnostics, too.
    System.Diagnostics.Debug.WriteLine("The Date ToString() results: {0}", request.Headers.Date.ToString());
}

See also

• DateTime
• HttpRequestMessage
• Headers