1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38
|
# frozen_string_literal: true
# Released under the MIT License.
# Copyright, 2023-2025, by Samuel Williams.
require "time"
module Protocol
module HTTP
module Header
# The `date` header represents the date and time at which the message was originated.
#
# This header is typically included in HTTP responses and follows the format defined in RFC 9110.
class Date < String
# Replaces the current value of the `date` header with the specified value.
#
# @parameter value [String] the new value for the `date` header.
def << value
replace(value)
end
# Converts the `date` header value to a `Time` object.
#
# @returns [Time] the parsed time object corresponding to the `date` header value.
def to_time
::Time.parse(self)
end
# Whether this header is acceptable in HTTP trailers.
# Date headers can safely appear in trailers as they provide metadata about response generation.
# @returns [Boolean] `true`, as date headers are metadata that can be computed after response generation.
def self.trailer?
true
end
end
end
end
end
|